SuperAPI AI 工具集

xhs-cli

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:通过 xiaohongshu-cli 在终端与小红书交互,覆盖浏览、搜索、互动与创作者发布等场景。

主要能力:认证(login、status、whoami、logout);搜索笔记、用户与话题,支持排序、类型和翻页;阅读笔记、查看评论与子评论、用户主页及其笔记;推荐 Feed 与热门笔记(含分类);收藏、点赞、关注与取消关注;点赞、收藏、评论、回复、删除评论;我的笔记、发布图文笔记、删除笔记;未读数与各类通知。

使用方式:先检查登录状态 xhs status;未安装时执行 uv tool install xiaohongshu-cli,升级用 uv tool upgrade xiaohongshu-cli;首次登录可用 xhs login 自动提取浏览器 Cookie 或 xhs login --qrcode 扫码。列表命令(search/feed/hot/user-posts/favorites/my-notes)执行后结果缓存,可用短索引操作,如 xhs search "美食" 后 xhs read 1、xhs like 1。所有命令支持 --yaml 或 --json 结构化输出,非 TTY 环境默认 YAML,也可用 OUTPUT 环境变量控制。

适用场景:终端内搜索与阅读笔记、查看用户内容、批量获取热门笔记、执行点赞评论等互动、发布与管理自己的笔记,以及脚本自动化处理。

限制:需已安装并登录,部分操作依赖 Cookie 或 xsec_token;可能遇到 NoCookieError、NeedVerifyError、IpBlockedError、SessionExpiredError,需按提示重新登录、完成验证或切换网络;请求内置随机延迟,速度较慢属正常;批量操作应控制频率以避免触发验证码;建议定期升级以应对 API 变更。