mcpField
X
xiaohongshu-skill

xiaohongshu-skill

github.com/deliciousbudingMarketing & growth4370 installsUpdated 9w ago
Repository

About xiaohongshu-skill

xiaohongshu-skill is a JSON CLI skill for operating Xiaohongshu browser sessions, aimed at agents handling content and account tasks. It supports reading, publishing, and interaction, with explicit confirmation required before actions that change account state.

Key features

  1. 01Search notes and read details
  2. 02View profiles and recommendation feeds
  3. 03Prepare and publish posts, videos, and long-form content
  4. 04Comment, reply, like, and collect
  5. 05Configure multiple accounts
  6. 06Require confirmation for account-changing actions

Use cases

  1. 01Search Xiaohongshu notes and inspect content
  2. 02Prepare posts, videos, or long-form publications
  3. 03Review a profile or recommendation feed
  4. 04Perform comments or interactions after confirmation

Install

Copy the command and run it in a terminal.

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

After installing, type/xiaohongshu-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project 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。

Comments

Markdown supported