小红书运营
命令行工具
xhs-cli 是面向小红书创作者与运营团队的开源 CLI。管理多账号会话、查询运营与笔记数据，并将图文素材填入创作后台。
快速开始
$ npm install -g xhs-cli
$ xhs help
需要 Node.js 20+ 和本机 Chrome/Chromium
核心功能
为小红书运营和代运营团队精心打造。
多账号会话
每个账号使用独立的 browser-data 目录保存浏览器会话，可设置当前账号，也可通过参数临时切换。
创作者运营指标
通过 xhs metrics 查询粉丝、互动、阅读和流量来源等创作者后台指标，并在本地保留缓存。
笔记数据查询
使用 recent、detail 与 posted 查看最近笔记、单篇详情和本地发帖归档。
图文发帖填表
将标题、正文和 1～18 张本地图片填入创作后台。默认停留在页面供人工检查，--publish 可按需尝试点击发布。
外部 Agent 集成
宿主应用可注册同名 impl* 并复用 CLI 业务实现；会话型操作使用 ResolvedSession，发帖传入对应账号的 browserUserDataDir。
二次开发友好
核心业务能力集中在 TypeScript toolset 中，便于在自有脚本或运营系统中复用。
使用示例
简单直观的命令，强大的自动化能力。
添加并登录账号
$xhs account add brand-a
$xhs account use brand-a
$xhs login
登录成功
获取运营指标
$xhs metrics
总粉丝: 10.2K 净增: 128
点赞: 245.6K 收藏: 86.3K
查看最近笔记
$xhs recent --limit 20
ID: 64f...
浏览: 2.1K 点赞: 326
发布新笔记
$xhs post --title "标题" --content "内容" --image ./cover.jpg
已填入标题与正文
请在页面中确认后发布
常见问题
更多问题可在 GitHub Issues 提出。
什么是 xhs-cli？
xhs-cli 是一个面向小红书创作者的开源命令行工具，提供多账号会话、运营指标、笔记查询和图文发帖填表能力。
如何安装？
确保已安装 Node.js 20+，然后运行 npm install -g xhs-cli。安装完成后执行 xhs help 查看所有命令。
数据安全吗？
代码完全开源可审查。账号浏览器会话与业务缓存保存在本机 ~/.xhs-cli/.cache/ 目录；工具通过本机浏览器访问小红书创作者后台，不经过 xhs-cli 自建服务器。请妥善保护该目录。
可以集成到我的 AI Agent 中吗？
可以。外部 Agent 宿主可注册工具，并直接调用 src/toolset 中对应的 impl* 实现。登录和数据查询等会话型操作传入 ResolvedSession，发帖传入目标账号的 browserUserDataDir。xhs-cli 本身不内置 Agent 或 MCP 服务。
会自动发布笔记吗？
默认不会。xhs post 会把标题、正文和图片填入创作后台，并保留浏览器窗口供你检查。只有显式传入 --publish 时，工具才会尝试点击页面中的「发布」按钮，结果仍以页面实际状态为准。
如何贡献代码或反馈问题？
欢迎通过 GitHub Issues 提交 Bug 或功能建议，也欢迎直接提交 Pull Request 参与贡献。