
Xiaohongshu
- 2.9k installs
- 244 repo stars
- Updated March 5, 2026
- autoclaw-cc/xiaohongshu-mcp-skills
xiaohongshu is an agent skill that automates Xiaohongshu RED login, publishing, search, browsing, interaction, and content planning via xiaohongshu-mcp MCP tools.
About
xiaohongshu is an agent skill routing Xiaohongshu RED social operations through xiaohongshu-mcp MCP tools for login, publishing image or video notes, search, feed browsing, likes, favorites, comments, profile views, and content planning. Every session starts with a mandatory MCP availability check for check_login_status; if tools are missing the agent must tell the user to run setup-xhs-mcp and must not substitute Playwright or WebFetch. After MCP connection, non-setup flows verify login before other tools because unauthenticated calls fail. Intent routing maps user phrases to sub-skills including setup-xhs-mcp, xhs-login, post-to-xhs, xhs-search, xhs-explore, xhs-interact, xhs-profile, and xhs-content-plan for install, login, publish, search, explore, interact, profile, and planning tasks. Write operations such as publish and comment require user confirmation before execution because they are public and irreversible. feed_id and xsec_token parameters must come from real search or browse results and cannot be fabricated. Developers reach for it when automating Xiaohongshu note publishing, competitor or topic search, engagement actions, or content strategy workflows through MCP rat.
- Routes intents to sub-skills for setup, login, post, search, explore, interact, profile, and planning.
- Requires check_login_status MCP tool before any operation; blocks Playwright or WebFetch substitutes.
- Login check mandatory after MCP connect for all non-setup flows.
- User confirmation required before publish, comment, and other irreversible write actions.
- feed_id and xsec_token must be taken from search or browse results, never invented.
Xiaohongshu by the numbers
- 2,901 all-time installs (skills.sh)
- +35 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #155 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
- Security screen: HIGH risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
xiaohongshu capabilities & compatibility
- Capabilities
- mcp connectivity and login status gating · intent routing to specialized sub skills · note publishing with pre execution user confirma · search, browse, interact, and profile operations · content planning and competitor analysis routing
- Use cases
- orchestration · research
What xiaohongshu says it does
所有小红书操作依赖 xiaohongshu-mcp 提供的 MCP 工具
禁止用 Playwright、WebFetch 或其他非 xiaohongshu-mcp 的工具替代
发布、评论等写操作执行前展示内容让用户确认
npx skills add https://github.com/autoclaw-cc/xiaohongshu-mcp-skills --skill xiaohongshuAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 2.9k |
|---|---|
| repo stars | ★ 244 |
| Security audit | 1 / 3 scanners passed |
| Last updated | March 5, 2026 |
| Repository | autoclaw-cc/xiaohongshu-mcp-skills ↗ |
How do I automate Xiaohongshu note operations through a reliable MCP integration without brittle browser scraping?
Automate Xiaohongshu RED operations via xiaohongshu-mcp tools for login, posting, search, browse, interact, profiles, and content planning.
Who is it for?
Operators running Xiaohongshu accounts who have xiaohongshu-mcp configured and need agent-driven posting and research workflows.
Skip if: Skip when xiaohongshu-mcp is not connected or when the user has not completed setup-xhs-mcp deployment.
When should I use this skill?
User mentions Xiaohongshu, RED, XHS, posting notes, searching notes, or Xiaohongshu content operations.
What you get
Authenticated MCP-driven login, search, publish, interact, or profile actions with user-confirmed writes and valid feed tokens.
- published RED/XHS notes
- searched feed results
- engagement actions
Files
你是小红书自动化助手,通过 xiaohongshu-mcp 的 MCP 工具帮助用户操作小红书。
前置检查(每次执行必做)
所有小红书操作依赖 xiaohongshu-mcp 提供的 MCP 工具(如 check_login_status、search_feeds 等)。执行任何操作前,先确认这些工具是否可用:
判断方法:检查当前可用的 MCP 工具列表中是否存在 check_login_status。
- 工具存在 → 正常执行后续流程
- 工具不存在 → 说明 xiaohongshu-mcp 服务未配置。直接告知用户:「小红书 MCP 服务尚未连接,请先运行
/setup-xhs-mcp完成部署和配置。」不要尝试用其他工具(如 Playwright、WebFetch)代替。
意图识别与路由
根据用户输入判断意图,然后直接按对应子 skill 的指令执行。如果意图不明确,先询问用户想做什么。
| 用户意图 | 执行 | 典型说法 |
|---|---|---|
| 安装部署 | 按 setup-xhs-mcp 执行 | 安装、部署、配置、第一次用、连不上 |
| 登录 | 按 xhs-login 执行 | 登录、扫码、切换账号、检查登录 |
| 发布内容 | 按 post-to-xhs 执行 | 发笔记、发图文、发视频、写一篇、上传 |
| 搜索 | 按 xhs-search 执行 | 搜索、找笔记、搜一下、有没有 |
| 浏览详情 | 按 xhs-explore 执行 | 推荐、首页、看详情、看评论 |
| 互动 | 按 xhs-interact 执行 | 点赞、收藏、评论、回复 |
| 查看用户 | 按 xhs-profile 执行 | 博主主页、看看这个作者 |
| 内容策划 | 按 xhs-content-plan 执行 | 选题、竞品分析、热门、涨粉 |
全局约束
1. MCP 连接优先:必须通过前置检查确认 MCP 工具可用后才能执行任何操作——不可用时只提示用户运行 /setup-xhs-mcp,禁止用 Playwright、WebFetch 或其他非 xiaohongshu-mcp 的工具替代 2. 登录优先:MCP 连接就绪后,除安装部署外,操作前先用 check_login_status 确认登录状态——未登录的情况下调用其他工具会失败 3. 用户确认:发布、评论等写操作执行前展示内容让用户确认——因为这些操作发出后无法撤回,代表用户的公开行为 4. 参数来源:feed_id 和 xsec_token 必须从搜索或浏览结果中获取,不可编造——编造的参数会导致 MCP 工具报错
# If you prefer the allow list template instead of the deny list, see community template:
# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
#
# Binaries for programs and plugins
*.exe
*.exe~
*.dll
*.so
*.dylib
# Test binary, built with `go test -c`
*.test
# Code coverage profiles and other test artifacts
*.out
coverage.*
*.coverprofile
profile.cov
# Dependency directories (remove the comment below to include it)
# vendor/
# Go workspace file
go.work
go.work.sum
# env file
.env
# Editor/IDE
# .idea/
# .vscode/
# Ralph Loop
PROMPT.md
.claude/.ralph-loop.local.md
CLAUDE.md
Skills 层不包含业务实现代码,所有功能通过调用 xiaohongshu-mcp 的 MCP 工具完成。
MCP 工具映射表
| MCP 工具 | 类型 | 对应 Skill | 说明 |
|---|---|---|---|
check_login_status | ReadOnly | xhs-login | 检查登录状态 |
get_login_qrcode | ReadOnly | xhs-login | 获取登录二维码 |
delete_cookies | Destructive | xhs-login | 删除 cookies 重置登录 |
publish_content | Destructive | post-to-xhs | 发布图文笔记 |
publish_with_video | Destructive | post-to-xhs | 发布视频笔记 |
list_feeds | ReadOnly | xhs-explore | 获取推荐流 |
search_feeds | ReadOnly | xhs-search | 搜索笔记 |
get_feed_detail | ReadOnly | xhs-explore | 获取笔记详情和评论 |
user_profile | ReadOnly | xhs-profile | 获取用户主页 |
like_feed | Destructive | xhs-interact | 点赞/取消点赞 |
favorite_feed | Destructive | xhs-interact | 收藏/取消收藏 |
post_comment_to_feed | Destructive | xhs-interact | 发表评论 |
reply_comment_in_feed | Destructive | xhs-interact | 回复评论 |
SKILL.md 编写规范
每个 SKILL.md 包含 YAML frontmatter(name + description)和 Markdown 正文。
正文必须包含:输入判断、约束条件、执行流程(含 MCP 工具调用)、失败处理。
编写原则:
- 控制在 200 行以内
- Destructive 操作需用户确认
- 工具名和参数必须与 xiaohongshu-mcp 源码一致
参考资源
- xiaohongshu-mcp 源码:
~/src/zy/xiaohongshu-mcp(Go MCP 服务)
MIT License
Copyright (c) 2026 Auto-Claw-CC
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
xiaohongshu-mcp-skills
基于 xiaohongshu-mcp 的 Agent Skills 集合,为小红书提供完整的自动化操作能力。兼容 Agent Skills 开放标准,支持 OpenClaw、Claude Code 等平台。
功能
| Skill | 说明 |
|---|---|
| setup-xhs-mcp | 安装部署 xiaohongshu-mcp 服务 |
| xhs-login | 登录管理(扫码登录、状态检查、重新登录) |
| post-to-xhs | 发布图文/视频笔记 |
| xhs-search | 搜索笔记(支持多维度筛选) |
| xhs-explore | 浏览推荐流、查看笔记详情和评论 |
| xhs-interact | 互动操作(点赞、收藏、评论、回复) |
| xhs-profile | 查看用户主页和作品 |
| xhs-content-plan | 内容策划(热门分析、竞品研究、选题建议) |
前置条件
- 已安装并运行 xiaohongshu-mcp 服务
- 如未安装,使用
setup-xhs-mcpskill 引导完成
安装
OpenClaw
下载本项目到本地后,解压到 OpenClaw 的 SKILLS 目录下重启会话生效。
Claude Code
# 项目级别
cp -r skills/ .claude/skills/
# 或全局级别
cp -r skills/ ~/.claude/skills/根 SKILL.md 可作为统一入口使用,也可以直接使用各子 skill。
使用示例
# 首次使用:安装 MCP 服务和登录
/setup-xhs-mcp
/xhs-login
# 搜索和浏览
/xhs-search 美食探店
/xhs-explore
# 发布内容
/post-to-xhs
# 互动
/xhs-interact许可证
MIT
Related skills
FAQ
What if check_login_status is not available?
Tell the user xiaohongshu-mcp is not connected and direct them to run setup-xhs-mcp; do not use other browser tools.
When is user confirmation required?
Before publish, comment, and other write operations that are public and cannot be undone.
Where do feed_id and xsec_token come from?
Only from prior search or browse MCP results; fabricated values cause tool errors.
Is Xiaohongshu safe to install?
skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.