mcpField
X
xiaohongshu-skill

xiaohongshu-skill

github.com/deliciousbuding营销与增长4370 次安装9 周前更新
代码仓库

关于 xiaohongshu-skill

xiaohongshu-skill 通过 JSON 命令行操作小红书浏览器会话，面向需要搜索、读取或管理内容的 Agent。它涵盖内容发布与互动，并要求对会改变账号状态的操作先征得明确确认。

主要功能

  1. 01搜索笔记并读取详情
  2. 02查看用户主页和推荐流
  3. 03准备及发布图文、视频和长文
  4. 04评论、回复、点赞与收藏
  5. 05支持多账号配置
  6. 06变更账号状态前要求确认

适用场景

  1. 01搜索小红书笔记并查看内容
  2. 02准备图文、视频或长文发布
  3. 03查看用户主页或推荐内容
  4. 04在确认后执行评论或互动

安装

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

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

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

包含的文件

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

.env.example
.coderabbit.yaml
.dockerignore
CONTRIBUTING.md
.gitignore
LICENSE
AGENTS.md
README_EN.md
Dockerfile
README.md
CHANGELOG.md
THIRD_PARTY_NOTICES.md
docker-compose.yml
.github/
CODEOWNERS
PULL_REQUEST_TEMPLATE.md
.github/ISSUE_TEMPLATE/
bug_report.md
feature_request.md
.github/workflows/
release.yml
ci.yml
pages.yml
data/
.gitkeep
docs/
REFERENCE.md
API.md
INTEGRATIONS.md
ROADMAP.md
ARCHITECTURE.md
RELEASING.md
SECURITY.md
INSTALL.md
PAGES.md

详细介绍

来自项目 README

小红书 Skill

通过 JSON CLI 操作小红书浏览器会话。执行入口统一为：

cd {baseDir}
uv run python -m scripts <command>

安全规则

发布、评论、回复、点赞、收藏、取消点赞和取消收藏会改变真实账号状态。执行前必须：

  1. 展示目标账号、内容、媒体和操作类型。
  2. 获得用户明确确认。
  3. 只执行用户确认的单次操作。

遇到验证码、登录页或安全验证页时停止。不要自动绕过验证，不要运行批量抓取或批量互动。

任务路由

用户目标命令或参考
首次登录或重新登录qrcode --headless=false
检查登录check-login
管理多个账号--profile <name>；详见 docs/INSTALL.md
搜索笔记search
读取笔记详情feed
读取用户主页user 或 me
获取推荐流explore
准备或发布图文publish
准备或发布视频publish-video
Markdown 转图片发布publish-md
准备或发布长文publish-longform
评论和回复comment、reply、reply-notification
点赞和收藏like、collect、unlike、uncollect
模板、策略和 SOPtemplate、strategy-*、sop
查看参数python -m scripts <command> --help

完整命令见 docs/API.md；安装和平台接入见 docs/INSTALL.md、docs/INTEGRATIONS.md。

初始化

cd {baseDir}
uv sync --frozen --no-dev
uv run playwright install chromium
uv run python -m scripts qrcode --headless=false

开发者使用：

uv sync --frozen --group dev
uv run python -m scripts.quality check

只读示例

uv run python -m scripts search "咖啡" --limit=5
uv run python -m scripts feed <feed_id> <xsec_token>
uv run python -m scripts explore --limit=10

feed_id、user_id 和 xsec_token 必须来自当前会话的结果，不要长期缓存。

发布语义

发布命令默认填写表单并返回 ready。用户确认后才能追加 --auto-publish。

自动提交可能返回：

  • confirmed：已观察到可信成功信号。
  • submitted_unconfirmed：已点击提交但未确认成功；必须人工复核，禁止自动重试。
  • failed：提交失败或出现登录、验证码、安全验证等失败信号。

输出和错误

标准输出是 JSON；诊断信息写入标准错误。Agent 应先读取 status，再依据 scripts/output_contracts.py 中的契约处理字段。

发生 captcha_required 或浏览器安全验证时，不要重试循环。切换到有头模式并由用户处理。

本地状态

每个 profile 独立保存浏览器状态、Cookie 备份和会话元数据。不要读取、展示、提交或外发这些文件。XHS_FP_SEED 只用于显式覆盖当前进程的稳定指纹 seed。

安全和隐私规则见 docs/SECURITY.md。架构说明见 docs/ARCHITECTURE.md。

评论

支持 Markdown