1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | xiaohongshu-skills |
| 作者/维护者 | Auto-Claw-CC(开源团队) |
| 来源链接 | https://github.com/autoclaw-cc/xiaohongshu-skills |
| 许可证 | MIT(GitHub API) |
| GitHub Stars | 1,681(GitHub API) |
| Forks | 218(GitHub API) |
| 最新版本 | 0.1.0(仓库 pyproject.toml) |
| 安装方式 | Git 克隆到 Agent skills 目录 + uv sync + 加载配套 Chrome 扩展 |
2. 功能介绍与亮点
xiaohongshu-skills 是一套小红书自动化技能集合,直接复用用户本人已登录的浏览器与真实账号,以普通用户的操作方式完成任务,而非绕过登录的爬虫式抓取。核心能力拆分为五个职责清晰的子技能:
- xhs-auth:登录状态检查、扫码登录、多账号切换
- xhs-publish:图文 / 视频 / 长文发布,支持定时发布与发布前分步预览
- xhs-explore:关键词搜索、笔记详情、用户主页、首页推荐抓取
- xhs-interact:评论、回复、点赞、收藏
- xhs-content-ops:竞品分析、热点追踪、批量互动等复合运营场景
亮点在于支持自然语言连贯指令——用户一句话描述目标(如“搜索某话题最火的图文帖子并收藏”),Agent 会自动串联多个子技能完成“搜索→筛选→排序→收藏→总结”的完整链路。技能文档中还明确写入强制约束:“发布和评论操作必须经过用户确认后才能执行”,为自动化操作加了一道人工复核閘门。
3. 适用场景
固定分类:内容创作与知识管理。
适合需要长期运营小红书账号、但不想手动重复执行发布/搜索/互动操作的用户:个人内容创作者、自媒体运营者、需要做竞品与热点跟踪的社媒团队、以及希望用自然语言而非记忆平台后台操作路径来管理账号的轻量运营者。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 给出明确安装路径示例(
.claude/skills/xiaohongshu-skills/)。 - OpenClaw:✅ 原生支持——SKILL.md 的 metadata 中显式声明
openclaw字段及依赖二进制、操作系统要求。 - Codex:❓ 未验证——README 声称兼容“所有支持 SKILL.md 格式的平台”,但未见针对 Codex 的专门安装示例或测试记录。
- Hermes Agent:❓ 未验证——同上,无专门验证材料。
补充:SKILL.md 声明仅在 macOS 与 Linux(darwin/linux)环境验证,未见 Windows 支持信息。
5. 推荐理由
自然语言指挥 Agent 完成小红书发布、检索与互动,把重复性的账号运营操作从手动点击变成一句话调用,同时通过“发布前必须用户确认”的设计保留了人工把关。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 1,681 stars;仓库 issue 区有 10 余位独立用户提交的真实使用反馈(验证码识别、发布按钮定位失败等具体问题),显示出持续的实际使用 |
| 可用性 | 8 | README 给出清晰的分步安装说明(uv 依赖 + 浏览器扩展加载),五个子技能职责边界明确;最近一次功能提交约 2 个月前,无付费依赖 |
| 安全性 | 7 | 见下方安全检查清单 |
安全检查清单:
① 权限范围——SKILL.md 明确要求所有操作仅通过项目自带 scripts/cli.py 执行,禁止调用其他实现,范围可审计
② 联网外发——配套 Chrome 扩展的 host_permissions 仅限定 xiaohongshu.com 域名与本地回环地址,无隐蔽外发目标
③ 凭据存储——不单独存储账号密码,复用用户浏览器已登录的会话与 Cookie
④ 可疑指令——SKILL.md 与扩展 manifest.json 未见混淆代码或隐蔽指令,且明确要求发布/评论前必须获用户确认
⑤ 作者信誉——小型开源团队,提交记录持续跟进小红书页面改版带来的适配问题,无刷星或误导性宣传迹象
⑥ License——MIT,清晰
⑦ 最近维护——最后一次代码提交约 2 个月前,仓库尚有部分 issue 未关闭
综合看,权限、外发目标、凭据处理、License 均清晰透明,无恶意迹象;但自动化操作真实账号存在触发平台风控、限流甚至封号的固有操作风险,用户 issue 中已有相关反馈。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| XiaohongshuSkills(white0dew,又名 RedBookSkills) | 同样基于 CDP 浏览器协议实现小红书自动发布与互动 | 以单一整体技能形式提供,而非拆分为职责独立的子技能;README 明确注明目前仅在 Windows 环境测试验证 |
| Auto-Redbook-Skills(comeonzhj) | 自动撰写笔记文案、自动生成配图、自动发布一体化 | 仓库未附带开源许可证文件,开源合规边界不如 MIT 协议清晰 |
| chubbyskills(chubbyguan) | 面向“把全渠道内容归档进个人知识库”,覆盖抖音/B 站/小红书等多平台内容采集与转写 | 定位是内容归档消费而非账号运营发布,不提供发布、评论、点赞等互动能力 |
xiaohongshu-skills 的差异化在于:把“认证、发布、检索、互动、复合运营”拆成边界清晰的五个子技能,并显式要求发布前用户确认,在自动化效率与操作可控性之间做了更明确的取舍。
8. 用户评价
该技能的 GitHub 仓库目前有近 50 条 issue,来自 10 余位使用不同用户名的独立用户,内容集中在验证码识别、发布按钮定位失败、Linux 环境适配、IP 被限制等具体技术场景,反映出真实的持续使用。目前尚未发现来自第三方平台的具名评价文章。
9. 其他补充
同一开源团队(Auto-Claw-CC)名下还维护一个基于 MCP Server 形式的姊妹项目 xiaohongshu-mcp-skills,面向偏好 MCP 协议集成方式的用户;两者是不同的接入形态,可按自己的 Agent 技术栈选择。项目文档以中文为主。
10. 安装使用方式
- 前置环境:Python ≥ 3.11、uv 包管理器、Google Chrome 浏览器
- 克隆仓库到 Agent 的 skills 目录,例如 Claude Code:
git clone https://github.com/autoclaw-cc/xiaohongshu-skills.git .claude/skills/xiaohongshu-skills - 安装 Python 依赖:
cd .claude/skills/xiaohongshu-skills && uv sync - 安装配套浏览器扩展:Chrome 打开
chrome://extensions/→ 开启“开发者模式” → “加载已解压的扩展程序” → 选择项目内的extension/目录,确认 “XHS Bridge” 已启用 - 安装完成后无需重启 Agent,直接用自然语言下达指令即可(如“检查我的小红书登录状态”“把这篇图文发布到小红书”),首次操作会自动检查登录状态,未登录时会引导扫码登录
11. 注意事项
- 自动化操作真实账号存在触发平台风控、限流甚至封号的风险(作者与用户 issue 中均有反馈),建议控制操作频率,首次使用建议用小号验证
- 项目最近一次代码提交约为 2 个月前,仓库尚有部分 issue 未完全处理,小红书页面后续改版可能导致自动化脚本失效,需等待作者修复或自行提交补丁
- 目前仅在 macOS 与 Linux 环境验证,Windows 兼容性未知
- 发布与评论操作按设计需用户确认后才执行,但仍建议在自动化之前人工复核最终发布内容