Xiaohongshu Automation Skills

VerifiedSafe

A set of skills to automate Xiaohongshu (Little Red Book) operations: login, content publishing, search, social interactions, and composite workflows.

Sby Skills Guide Bot
ContentIntermediate
7/23/2026
Claude Code
#xiaohongshu#social-media#automation#content-publishing#search

Recommended for

Automated summary

Automates Xiaohongshu operations: authentication, content publishing, search, social interactions, and combined workflows via a Python CLI.

Strengths

  • Covers the full content lifecycle (publish, discover, interact)
  • Simple and structured command-line interface
  • Handles login and account switching
  • Supports combined workflows (competitor analysis, trend tracking)

Limitations

  • Requires a Chrome environment and configured Python setup
  • Depends on external tools (uv, python3) not bundled
  • Publish and comment actions require manual confirmation
When to use it

For automating repetitive Xiaohongshu tasks such as scheduled posting, competitive analysis, or large-scale engagement.

When not to use it

For actions needing complex interactive navigation not covered by the CLI, or when account security is a top concern (risk of being flagged).

Security analysis

Safe
Quality score90/100

The skill delegates all actions to a single CLI tool with no direct shell commands, no destructive operations, and no obfuscation. Automation of a social media platform is for legitimate user tasks.

No concerns found

How this analysis is made

Examples

Publish a post with images
Publish a Xiaohongshu post with title from title.txt, content from content.txt, and images /path/to/pic1.jpg and /path/to/pic2.jpg.
Search for notes by keyword
Search Xiaohongshu for notes about 'skincare routine' and show me the top 5 results.
Like and comment on a feed
Like the post with feed_id abc123 and xsec_token xyz and comment 'Great content!'

name: xiaohongshu-skills description: | 小红书自动化技能集合。支持认证登录、内容发布、搜索发现、社交互动、复合运营。 当用户要求操作小红书(发布、搜索、评论、登录、分析、点赞、收藏)时触发。 version: 1.0.0 metadata: openclaw: requires: bins: - python3 - uv emoji: "\U0001F4D5" homepage: https://github.com/xpzouying/xiaohongshu-skills os: - darwin - linux

小红书自动化 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 启动浏览器。
  • 操作超时:检查网络连接,适当增加等待时间。
  • 频率限制:降低操作频率,增大间隔。

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/xiaohongshu-automation-skills-mrwakfh5/download' --output '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md.part' && mv '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md.part' '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md' && test -s '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/xiaohongshu-skills' && cp -R '.skill-downloads/xiaohongshu-automation-skills-mrwakfh5' '.claude/skills/xiaohongshu-skills'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/xiaohongshu-automation-skills-mrwakfh5'

openskills read 'xiaohongshu-automation-skills-mrwakfh5'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/xiaohongshu-automation-skills-mrwakfh5/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills