一覧へ戻る
jackwener/xhs-cli（新しいタブで開きます）
主要言語: Python
小红书命令行工具 — 搜索、阅读、点赞、收藏、评论，全在终端完成 | Xiaohongshu CLI
- star 数
- 675
- watcher 数
- 0
- fork 数
- 69
- issue 数
- 9
- 最終更新
- 2026/10/09
gem-hunter主要言語: Python
小红书命令行工具 — 搜索、阅读、点赞、收藏、评论，全在终端完成 | Xiaohongshu CLI
xiaohongshu-cli 这是逆向 API 出来的版本。 速度更加快更加稳定。但是风控上应该不如当前这个直接用浏览器操作真实。
中文 | English
小红书命令行工具 — 在终端中搜索笔记、查看主页、点赞、收藏、评论。
--jsonxsec_token 搜索后自动缓存，后续命令免手动传| 分类 | 命令 | 说明 |
|---|---|---|
| Auth | login, logout, status, whoami |
登录、退出、状态检查、查看个人资料 |
| Read | search, read, feed, topics |
搜索笔记、阅读详情、推荐 Feed、搜索话题 |
| Users | user, user-posts, followers, following |
查看资料、列出笔记/粉丝/关注 |
| Engage | like, unlike, comment, delete |
点赞、取消点赞、评论、删除笔记 |
| Favorites | favorite, unfavorite, favorites |
收藏、取消收藏、查看收藏列表 |
| Post | post |
发布图文笔记 |
所有数据命令支持
--json输出。xsec_token自动缓存，无需手动传递。
IPWO住宅代理覆盖 195+ 个国家和地区，提供动态住宅代理、静态住宅代理及不限量住宅代理。
适用于开发 CLI 工具、集成 MCP 服务，构建 AI Agent 与自动化工作流，为多地区网络访问和数据采集任务提供灵活的住宅代理选择。
支持免费测试，9 折折扣码：0203
需要 Python 3.8+。
# 推荐：使用 uv uv tool install xhs-cli # 或使用 pipx pipx install xhs-cli
git clone git@github.com:jackwener/xhs-cli.git
cd xhs-cli
uv sync在本地已登录（有 ~/.xhs-cli/cookies.json）的情况下，直接运行：
./scripts/smoke_local.sh
可选地传递 pytest 参数（例如只跑某个用例）：
./scripts/smoke_local.sh -k whoami
默认只跑无副作用命令（integration and not live_mutation）。如需额外验证
like/favorite/comment/post/delete，显式开启：
XHS_SMOKE_MUTATION=1 ./scripts/smoke_local.sh
可选环境变量：
XHS_SMOKE_COMMENT_TEXT="smoke test comment" XHS_SMOKE_POST_IMAGES="/abs/a.jpg,/abs/b.jpg" XHS_SMOKE_POST_TITLE="smoke title" XHS_SMOKE_POST_CONTENT="smoke content"
# 自动从 Chrome 提取 cookie（推荐） xhs login # 强制使用二维码登录（用于排查登录问题） xhs login --qrcode # 手动提供 cookie 字符串（至少包含 a1 和 web_session） xhs login --cookie "a1=xxx; web_session=yyy" # 快速检查已保存的登录状态（不启动浏览器，不读取浏览器 cookie） xhs status # 查看个人资料 xhs whoami xhs whoami --json # 退出登录 xhs logout
xhs search "咖啡" xhs search "咖啡" --json
# 查看笔记（xsec_token 从缓存自动解析） xhs read <note_id> # 包含评论 xhs read <note_id> --comments # 手动指定 xsec_token xhs read <note_id> --xsec-token <token>
# 查看用户资料（使用内部 user_id，非小红书号） xhs user <user_id> # 列出用户笔记 xhs user-posts <user_id> # 粉丝 / 关注 xhs followers <user_id> xhs following <user_id>
xhs feed
xhs topics "旅行"# 点赞 / 取消（xsec_token 自动解析） xhs like <note_id> xhs like <note_id> --undo # 收藏 / 取消 xhs favorite <note_id> xhs favorite <note_id> --undo # 评论 xhs comment <note_id> "好棒！" # 删除自己的笔记 xhs delete <note_id> # 查看收藏列表 xhs favorites xhs favorites --max 10
xhs post "标题" --image photo1.jpg --image photo2.jpg --content "正文内容" xhs post "标题" --image photo1.jpg --content "正文内容" --json
xhs --version xhs -v search "咖啡" # 调试日志 xhs --help
CLI (click) → XhsClient (camoufox 浏览器)
↓ 导航到真实页面
window.__INITIAL_STATE__ → 提取结构化数据
使用 camoufox（反指纹 Firefox）像真实用户一样浏览小红书。数据从页面的 window.__INITIAL_STATE__ 中提取，与正常浏览完全一致。
~/.xhs-cli/cookies.json；未命中时通过 browser-cookie3 从本地 Chrome 提取 cookie。xhs login --qrcode 使用 browser-assisted 扫码登录，并在终端渲染二维码（▀ ▄ █）。window.__INITIAL_STATE__ 提取结构化数据。xsec_token 自动缓存到 ~/.xhs-cli/token_cache.json。xhs-cli 自带 SKILL.md，让 AI Agent 能自动学习并使用本工具。
npx skills add jackwener/xhs-cli
| 参数 | 说明 |
|---|---|
-g |
全局安装（用户级别，跨项目共享） |
-a claude-code |
指定目标 Agent |
-y |
非交互模式 |
mkdir -p .agents/skills git clone git@github.com:jackwener/xhs-cli.git .agents/skills/xhs-cli
添加后，支持 .agents/skills/ 的 AI Agent 会自动发现并使用 xhs-cli 命令。
⚠️ ClawHub 安装方式已过时，不再支持。请使用上方的 Skills CLI 或手动安装。
~/.xhs-cli/cookies.json，权限 0600。xhs status 只检查本地已保存 cookie，不会触发浏览器 cookie 提取。xhs login --cookie 要求 cookie 至少包含 a1 和 web_session。xhs post 可能要求额外登录创作平台（https://creator.xiaohongshu.com）。python -m camoufox fetch）。Apache License 2.0