xiaohongshu-cli

一个通过命令行操作小红书的工具,支持搜索、阅读、点赞、评论、发帖等全功能。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:xiaohongshu-cli。
它的用途是:一个通过命令行操作小红书的工具,支持搜索、阅读、点赞、评论、发帖等全功能。
完整的 Skill 内容见:https://321skill.com/skills/xiaohongshu-cli/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我用命令行搜一下小红书最近关于‘露营装备’的爆款视频。”,AI Agent可以调用`xhs search "露营装备" --sort popular --type video`命令,获取结构化的笔记列表和详情。或者

对AI说:“监控用户‘旅行达人小王’的新帖子并通知我。”,AI可以定期执行`xhs user-posts <用户ID>`命令来获取最新动态。

介绍

xiaohongshu-cli 是一个专为开发者和自动化场景设计的命令行工具,它解决了在无图形界面环境下(如服务器、远程终端或AI Agent)与小红书平台进行交互的难题。通过封装小红书的API,它允许用户直接使用终端命令完成笔记搜索、内容阅读、用户浏览、点赞、收藏、评论、关注乃至发布笔记等一系列操作,将复杂的网页交互简化为可编程的命令。

使用方式非常直接,通过Python包管理工具(如uv或pipx)一键安装后,用户需要先进行身份认证。认证支持两种方式:一是自动从本地浏览器(如Chrome、Edge、Safari等)提取已登录的Cookie;二是在无法获取Cookie时,通过终端显示二维码进行浏览器扫码登录。完成登录后,即可使用丰富的xhs子命令来执行各种操作,所有输出默认采用机器友好的YAML或JSON格式,便于AI Agent或脚本解析。

这个工具非常适合需要批量处理小红书数据的研究人员、希望将小红书操作集成到自动化工作流中的开发者,以及构建社交媒体管理或内容分析AI Agent的工程师。它提供了一个稳定、可编程的接口,避免了手动操作的低效和不稳定性。

与市面上其他针对小红书的爬虫库或API封装相比,xiaohongshu-cli的核心区别在于其定位是一个功能完整的“命令行客户端”(CLI Tool),而非单纯的SDK。它不仅提供了数据读取能力,更覆盖了点赞、评论、发帖等完整的写入和交互功能,并且将复杂的登录流程(Cookie提取、二维码登录)和错误处理(验证码、封IP)进行了封装,提供了开箱即用的完整解决方案,降低了集成复杂度。

核心特点

这是一个功能完整的命令行客户端,不仅支持数据抓取,更覆盖了点赞、评论、发帖等完整的用户交互功能,并内置了浏览器Cookie自动提取和二维码登录两种认证方案,提供了开箱即用的完整工作流。

注意事项

不适合需要实时图形化界面交互或对小红书官方反爬机制有严格规避需求的纯数据爬取场景。

常见问题

如何登录小红书CLI?

有两种方式:1. 确保已在Chrome等浏览器登录小红书,然后运行`xhs login`自动提取Cookie;2. 运行`xhs login --qrcode`,用手机小红书APP扫描终端显示的二维码登录。

这个工具安全吗?会封号吗?

工具使用官方接口,风险与正常使用APP类似。但请遵守平台规则,避免高频操作,开发者对账号风险不承担责任。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/xiaohongshu-cli/raw/index.md 读取 xiaohongshu-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。