入馆:2026 年 11 月 3 日
xhs-cli
在终端里用命令搜索、阅读小红书,点赞、收藏、评论,也能上传图片发笔记。
- 生态
- Agent Skills
- Skill 分类
- 自动化
- 创建者 / 机构
- jackwener(GitHub 用户)
它是什么
xhs-cli 是 GitHub 用户 jackwener 做的小红书命令行工具(CLI),同时带一个 Agent Skill。它在后台开一个没有界面的 Camoufox 浏览器(headless browser),你在终端里敲命令,就能搜索笔记,读笔记和评论,看用户资料、关注和粉丝名单、收藏;也能点赞、收藏、评论,上传图片发笔记,或删除你自己的笔记。AI Agent 装上它的 Skill 后,可以替你调用这些命令。xhs-cli 走的是真实浏览器;作者另有一个 xiaohongshu-cli,改用逆向接口,速度更快,本站另行介绍。
适合谁:习惯在终端干活、想让 AI Agent 帮忙查小红书内容的开发者。不写代码的读者用不上。
使用前提:用 uv tool install xhs-cli 或 pipx 安装,需要 Python 3.8 或更新版本,第一次使用要运行 camoufox fetch 下载浏览器。给 AI 用时,可以运行 npx skills add jackwener/xhs-cli,或放进 .agents/skills;Claude Code 有专门的安装参数,ClawHub 上的装法已经过时。支持哪些系统,文档没有明确说。
登录时,它先用已经存好的 Cookie;没有的话,会用 browser-cookie3 从你电脑上的 Chrome、Firefox、Edge、Brave 里读取小红书网站的 Cookie;也可以手动填入 Cookie,或扫二维码。登录 Cookie 存在 ~/.xhs-cli/cookies.json,搜索得到的笔记令牌存在 ~/.xhs-cli/token_cache.json,两个文件都会尽量设成只有你自己能读。
它会读搜索结果、笔记和评论、用户资料和发过的帖子、关注和粉丝名单、收藏、你自己的资料,发帖时读你指定的图片和正文;没有读私信和剪贴板的功能。它能替你点赞和取消、收藏和取消、评论、上传图片发笔记、删除你自己的笔记;目前的命令没有发视频和发私信。它启动无头浏览器访问小红书和创作者中心,创作者中心可能要另外登录;核查没有找到把 Cookie 发给其他服务的代码。命令结束时浏览器会关掉,没有后台常驻或定时任务,也没有 curl 加 bash 一类直接运行远程脚本的步骤。
它可以用“从浏览器读取 Cookie”的方式登录,会去你电脑上的浏览器里取小红书的登录信息。AI 也能不经你确认就点赞、评论或发帖,直接用你的账号对外说话。
不需要付费接口。使用这些功能前,请自己斟酌账号安全,并确认平台规则,由此产生的后果与本站无关,本站一概不负责。Apache-2.0 许可,这个许可不代表得到了小红书平台的授权。
以上根据项目公开说明整理,本站没有实际测试。