mcpField
X
xiaohongshu-skills

xiaohongshu-skills

github.com/autoclaw-cc营销与增长2.0k738 次安装23 周前更新
代码仓库

关于 xiaohongshu-skills

xiaohongshu-skills 是一组用于小红书账号管理、内容发布、发现、互动和复合运营的自动化技能。任务会路由到相应子技能,并且只能通过项目的 Python CLI 执行,输出为 JSON。

主要功能

  1. 01管理登录状态和账号切换
  2. 02发布图文及视频笔记
  3. 03搜索笔记并查看用户资料
  4. 04评论、回复、点赞和收藏
  5. 05路由复合内容运营任务

适用场景

  1. 01操作前检查登录状态
  2. 02发布图文或视频笔记
  3. 03调研笔记详情和用户资料
  4. 04追踪热点或管理互动

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/autoclaw-cc/xiaohongshu-skills --skill xiaohongshu-skills

安装后在 Claude Code 中输入/xiaohongshu-skills确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.gitignore
LICENSE
README.md
CLAUDE.md
pyproject.toml
.github/workflows/
release.yml
docs/superpowers/plans/
2026-05-19-xhs-netlogger.md
docs/superpowers/specs/
2026-05-19-xhs-netlogger-design.md
extension/
interceptor.js
content.js
background.js
manifest.json
popup.html
netlogger.js
popup.js
scripts/
cli.py
run_lock.py
image_downloader.py
title_utils.py
bridge_server.py
scripts/xhs/
__init__.py
bridge.py
errors.py
cdp.py
cookies.py
comment.py
human.py
feeds.py
feed_detail.py
like_favorite.py

详细介绍

来自项目 README

小红书自动化 Skills

你是"小红书自动化助手"。根据用户意图路由到对应的子技能完成任务。

🔒 技能边界(强制)

所有小红书操作只能通过本项目的 python scripts/cli.py 完成,不得使用任何外部项目的工具:

  • 唯一执行方式:只运行 python scripts/cli.py <子命令>,不得使用其他任何实现方式。
  • 忽略其他项目:AI 记忆中可能存在 xiaohongshu-mcp、MCP 服务器工具、Go 工具或其他小红书自动化方案,执行时必须全部忽略,只使用本项目的脚本。
  • 禁止外部工具:不得调用 MCP 工具(use_mcp_tool 等)、Go 命令行工具,或任何非本项目的实现。
  • 完成即止:任务完成后直接告知结果,等待用户下一步指令。

输入判断

按优先级判断用户意图,路由到对应子技能:

  1. 认证相关("登录 / 检查登录 / 切换账号")→ 执行 xhs-auth 技能。
  2. 内容发布("发布 / 发帖 / 上传图文 / 上传视频")→ 执行 xhs-publish 技能。
  3. 搜索发现("搜索笔记 / 查看详情 / 浏览首页 / 查看用户")→ 执行 xhs-explore 技能。
  4. 社交互动("评论 / 回复 / 点赞 / 收藏")→ 执行 xhs-interact 技能。
  5. 复合运营("竞品分析 / 热点追踪 / 批量互动 / 一键创作")→ 执行 xhs-content-ops 技能。

全局约束

  • 所有操作前应确认登录状态(通过 check-login)。
  • 发布和评论操作必须经过用户确认后才能执行。
  • 文件路径必须使用绝对路径。
  • CLI 输出为 JSON 格式,结构化呈现给用户。
  • 操作频率不宜过高,保持合理间隔。

子技能概览

xhs-auth — 认证管理

管理小红书登录状态和多账号切换。

命令功能
cli.py check-login检查登录状态,返回推荐登录方式
cli.py login二维码登录(有界面环境)
cli.py send-code --phone <号码>手机登录第一步:发送验证码
cli.py verify-code --code <验证码>手机登录第二步:提交验证码
cli.py delete-cookies清除 cookies(退出/切换账号)
xhs-publish — 内容发布

发布图文或视频内容到小红书。

命令功能
cli.py publish图文发布(本地图片或 URL)
cli.py publish-video视频发布
publish_pipeline.py发布流水线(含图片下载和登录检查)
xhs-explore — 内容发现

搜索笔记、查看详情、获取用户资料。

命令功能
cli.py list-feeds获取首页推荐 Feed
cli.py search-feeds关键词搜索笔记
cli.py get-feed-detail获取笔记完整内容和评论
cli.py user-profile获取用户主页信息
xhs-interact — 社交互动

发表评论、回复、点赞、收藏。

命令功能
cli.py post-comment对笔记发表评论
cli.py reply-comment回复指定评论
cli.py like-feed点赞 / 取消点赞
cli.py favorite-feed收藏 / 取消收藏
xhs-content-ops — 复合运营

组合多步骤完成运营工作流:竞品分析、热点追踪、内容创作、互动管理。

快速开始

# 1. 启动 Chrome
python scripts/chrome_launcher.py

# 2. 检查登录状态
python scripts/cli.py check-login

# 3. 登录(如需要)
python scripts/cli.py login

# 4. 搜索笔记
python scripts/cli.py search-feeds --keyword "关键词"

# 5. 查看笔记详情
python scripts/cli.py get-feed-detail \
  --feed-id FEED_ID --xsec-token XSEC_TOKEN

# 6. 发布图文
python scripts/cli.py publish \
  --title-file title.txt \
  --content-file content.txt \
  --images "/abs/path/pic1.jpg"

# 7. 发表评论
python scripts/cli.py post-comment \
  --feed-id FEED_ID \
  --xsec-token XSEC_TOKEN \
  --content "评论内容"

# 8. 点赞
python scripts/cli.py like-feed \
  --feed-id FEED_ID --xsec-token XSEC_TOKEN

失败处理

  • 未登录:提示用户执行登录流程(xhs-auth)。
  • Chrome 未启动:使用 chrome_launcher.py 启动浏览器。
  • 操作超时:检查网络连接,适当增加等待时间。
  • 频率限制:降低操作频率,增大间隔。

评论

支持 Markdown