{"repo":"kyalpha313/xhs-cli-headless","free":true,"listed":false,"github":"https://github.com/kyalpha313/xhs-cli-headless","clone":"git clone https://github.com/kyalpha313/xhs-cli-headless.git","description":"Headless-friendly Xiaohongshu CLI fork focused on QR login, session tooling, and agent-safe automation","language":"Python","stars":13,"topics":["agent","automation","cli","headless","xhs","xiaohongshu"],"license":"Apache-2.0","category":"cli-tools","readme_excerpt":"xhs-cli-headless 面向终端和 AI Agent 的小红书 CLI。 xhs-cli-headless 重点解决三件事： - 在无 GUI / 远程服务器 / Agent 环境中完成登录和会话恢复 - 用稳定命令读取、搜索和整理小红书内容 - 把 CLI 与 Agent skill 一起发布，安装一个包即可同时获得程序和使用指南 当前版本： 0.8.9 适合谁用 - 想在服务器或自动化脚本里使用小红书只读能力的人 - 需要让 AI Agent 调用小红书搜索、阅读、评论读取等能力的人 - 需要明确知道哪些能力稳定、哪些能力暂不承诺的人 安装 或： 源码运行： 更新 0.8.7 起，可以用内置命令更新 CLI 和随包发布的 Agent skill： 如果你使用 GitHub 源安装： xhs update 会优先识别 uv tool 、 pipx 、 pip 等常见安装方式。无法安全判断时，请先用 --dry-run 查看将执行的命令。 快速开始 Agent 登录最佳实践 Agent 遇到“token 过期”“未登录”“Session expired”时，不要反复重试业务命令。推荐顺序是： 例外：如果用户只是读取公开视频 / 公开笔记 URL，或给出 xhslink.com 短链接，先尝试 xhs read 。公开内容可以走 HTML fallback，不应把登录失效当作硬阻塞；只有 fallback 也失败、或用户需要评论 / feed / 互动等登录能力时，再引导登录。 结构化错误会带 details.steps ，Agent 可以直接按步骤引导用户完成恢复。 如果 Agent 运行在飞书、微信等聊天渠道，使用 xhs login --qr-output outputs/xhs-login-qr.png 。命令会输出 QR URL: ... 和 QR image: ... ；Agent 必须把原始链接和 PNG 二维码图片同时发给用户，不要只发链接。 支持能力 认证与会话 命令 说明 --- --- xhs login 默认 headless 二维码登录 xhs login --qr-output 输出二维码 PNG，适合飞书 / 微信等聊天渠道 xhs login --qrcode-http 显式使用纯 HTTP 二维码登录 xhs status 检查当前登录态 xhs whoami 查看当前账号 xhs auth doctor 诊断主站和 creator 会话 xhs auth inspect 检查本地 cookie 字段，不打印敏感值 xhs auth import --file 导入 cookies 文件 xhs auth import-fields --interactive 交互式粘贴关键字段 xhs logout 清空本地登录态 xhs update 更新命令行和内置 Agent skill 搜索与阅读 命令 说明 --- --- xhs search 搜索笔记 xhs search-user 搜索用户 xhs topics 搜索话题 xhs feed 推荐流 xhs hot 热榜 xhs read 读取笔记正文和正文图片 xhs comments 读取评论 xhs board 读取收藏专辑 / board xhs my-notes 查看当前账号发布的笔记 xhs unread 查看未读数量 互动 这些命令会修改账号状态，Agent 必须先向用户确认： 当前不默认承诺的能力 以下能力保留源码或历史记录，但不建议 Ag","default_branch":null,"files":null,"tree":[],"storefront":"/r/kyalpha313","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/kyalpha313/xhs-cli-headless/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}