小红书MCP Skills全集:一条命令搞定小红书运营自动化,AI时代的社媒利器
posts posts 2026-04-07T17:55:00+08:00深度解析xiaohongshu-mcp-skills项目:8个Agent Skills覆盖安装、登录、发笔记、搜索、互动、涨粉全流程。兼容OpenClaw和Claude Code,一套工具搞定小红书运营自动化。技术笔记小红书, MCP, Agent Skills, 自动化运营, OpenClaw目录
小红书MCP Skills全集:AI时代的社媒运营利器
项目概述
xiaohongshu-mcp-skills是由autoclaw-cc团队开发的开源项目,基于xiaohongshu-mcp实现,为小红书提供完整的AI Agent自动化操作能力。该项目兼容Agent Skills开放标准,支持OpenClaw、Claude Code等主流AI Agent平台。
| 指标 | 数值 |
|---|---|
| GitHub Stars | 175 |
| Forks | 29 |
| 贡献者 | 3 (xpzouying, claude, Angiin) |
| 最新提交 | 2026-03-05 |
| 许可证 | MIT |
| 支持平台 | OpenClaw, Claude Code, 兼容Agent Skills标准 |
官方定位:「基于xiaohongshu-mcp的Agent Skills集合,为小红书提供完整的自动化操作能力。」
为什么需要小红书MCP Skills?
小红书运营的痛点
| 痛点 | 描述 |
|---|---|
| 重复操作 | 每天手动发布笔记、回复评论、搜索竞品,耗时耗力 |
| 效率低下 | 手动搜索笔记、查看数据,无法批量操作 |
| 人工失误 | 标题超长、图片遗漏、发布时间不当 |
| 缺乏工具 | 小红书官方API限制,第三方工具匮乏 |
MCP Skills的解决方案
传统方式:手动操作 → 每次3-5分钟 → 10条笔记/天
MCP Skills:AI自动化 → 每次30秒 → 100条笔记/天效率提升:10-20倍
核心功能详解
8大Skills总览
| Skill | 功能 | 场景 |
|---|---|---|
| setup-xhs-mcp | 安装部署MCP服务 | 首次使用 |
| xhs-login | 扫码登录、状态检查 | 账号管理 |
| post-to-xhs | 发布图文/视频笔记 | 内容发布 |
| xhs-search | 多维度搜索笔记 | 竞品分析 |
| xhs-explore | 浏览推荐流、查看详情 | 内容策划 |
| xhs-interact | 点赞、收藏、评论、回复 | 互动管理 |
| xhs-profile | 查看用户主页和作品 | KOL研究 |
| xhs-content-plan | 热门分析、选题建议 | 内容规划 |
安装与配置
前置条件
- 已安装并运行xiaohongshu-mcp服务
- Python 3.8+
- 支持的AI平台:OpenClaw 或 Claude Code
安装步骤
OpenClaw
# 1. 下载本项目到本地
git clone https://github.com/autoclaw-cc/xiaohongshu-mcp-skills.git
# 2. 解压到OpenClaw的SKILLS目录
# OpenClaw会自动扫描skills目录
# 3. 重启会话生效Claude Code
# 项目级别安装
cp -r skills/ ~/.claude/skills/
# 或全局级别安装
cp -r skills/ ~/.claude/skills/根目录SKILL.md
项目根目录的SKILL.md可作为统一入口,也可以直接使用各子skill。
核心Skill深度解析
post-to-xhs:智能发布笔记
功能定位:最核心的skill,支持图文笔记和视频笔记自动发布。
触发条件
当用户想在小红书发布内容时自动触发,包括:
- 发笔记、 发图文、 发视频
- 上传图片、 写一篇小红书
- 把内容发到红书上、 种草笔记
- 好物分享
输入判断逻辑
if 提供了视频文件:
发布类型 = "视频笔记"
elif 提供了图片:
发布类型 = "图文笔记"
else:
提示用户至少提供图片或视频约束条件
| 约束 | 说明 | 错误处理 |
|---|---|---|
| 标题长度 | ≤20个中文字或英文单词 | 提示用户缩短 |
| 图片数量 | 图文笔记至少1张 | 提示至少1张 |
| 视频格式 | 仅支持本地绝对路径 | 提示使用绝对路径 |
| 媒体类型 | 图片和视频二选一 | 提示不能混用 |
| 标签格式 | 正文不包含#,通过tags参数传递 | 自动处理格式 |
发布流程
1. 收集信息 → 2. 内容校验 → 3. 用户确认 → 4. 执行发布 → 5. 报告结果Step 1: 收集发布信息
必填参数:
title— 标题content— 正文images或video— 图片列表或视频路径
可选参数:
tags— 话题标签数组schedule_at— 定时发布(ISO8601格式)is_original— 声明原创(仅图文)visibility— 可见范围(公开/仅自己/仅互关好友)
Step 2: 内容校验
def validate(title, images, video):
if len(title) > 20:
raise TitleLengthError("标题最多20个中文字")
if images and not is_absolute_path(images[0]):
raise PathError("图片路径必须是绝对路径")
if video and not is_absolute_path(video):
raise PathError("视频路径必须是绝对路径")Step 3: 用户确认
发布前展示完整预览:
- 标题、正文、标签
- 图片列表或视频路径
- 定时时间、可见范围(如有)
Step 4: 执行发布
# 图文笔记
result = mcp.publish_content(
title=title,
content=content,
images=images, # 图片路径列表
tags=tags,
schedule_at=schedule_at,
is_original=is_original,
visibility=visibility
)
# 视频笔记
result = mcp.publish_with_video(
title=title,
content=content,
video=video, # 本地视频绝对路径
tags=tags,
schedule_at=schedule_at,
visibility=visibility
)Step 5: 报告结果
发布成功后告知:
- 笔记ID
- 发布状态
- 预览链接
错误处理
| 场景 | 处理方式 |
|---|---|
| 未登录 | 引导使用xhs-login |
| 标题超长 | 提示用户缩短标题 |
| 图片路径无效 | 提示检查路径是否正确 |
| 视频使用相对路径 | 提示改为绝对路径 |
| 发布失败 | 展示错误信息,建议检查内容或重试 |
xhs-login:账号登录管理
功能:扫码登录、状态检查、重新登录
使用场景
# 首次使用需要登录
/xhs-login
# 检查登录状态
/xhs-login --check
# 重新登录(token过期时)
/xhs-login --relogin登录状态检查
# MCP服务自动维护登录状态
# 如发现未登录,自动提示用户扫码xhs-search:智能搜索笔记
功能:多维度筛选搜索小红书笔记
搜索能力
- 关键词搜索:按标题/正文关键词
- 用户搜索:查找特定用户发布的笔记
- 话题搜索:按话题标签搜索
- 时间筛选:指定时间范围内的笔记
- 热度筛选:按点赞/收藏/评论数筛选
使用示例
# 搜索美食探店相关笔记
/xhs-search 美食探店
# 搜索近7天热门笔记(点赞>1000)
/xhs-search 旅行 --sort=likes --min_likes=1000 --days=7
# 搜索特定用户的笔记
/xhs-search --user=小红书号 --limit=10返回数据结构
{
"notes": [
{
"id": "笔记ID",
"title": "标题",
"author": "作者",
"likes": 1234,
"collects": 567,
"comments": 89,
"tags": ["标签1", "标签2"],
"published_at": "2026-04-07"
}
],
"total": 1234,
"has_more": true
}xhs-explore:发现内容灵感
功能:浏览小红书推荐流,发现热门内容
能力范围
- 推荐流浏览:刷推荐页,发现热点
- 笔记详情:查看任意笔记的完整内容
- 评论查看:读取笔记的所有评论
- 博主信息:获取发布者基本资料
使用场景
# 浏览推荐流
/xhs-explore
# 查看特定笔记详情
/xhs-explore --note_id=xxxxx
# 查看笔记的所有评论
/xhs-explore --note_id=xxxxx --commentsxhs-interact:互动操作
功能:自动化点赞、收藏、评论、回复
支持操作
| 操作 | 说明 | 示例 |
|---|---|---|
| 点赞 | 点赞笔记 | /xhs-interact --action=like --note_id=xxx |
| 收藏 | 收藏笔记 | /xhs-interact --action=collect --note_id=xxx |
| 评论 | 评论笔记 | /xhs-interact --action=comment --note_id=xxx --content=很棒! |
| 回复 | 回复评论 | /xhs-interact --action=reply --comment_id=xxx --content=谢谢! |
批量互动
# 批量点赞指定话题下的笔记
/xhs-interact --action=batch_like --tag=美食 --limit=50
# 自动回复最近24小时的新评论
/xhs-interact --action=auto_reply --hours=24 --template=谢谢关注!xhs-profile:用户主页分析
功能:查看任意小红书用户的主页和作品
能力范围
- 用户信息:昵称、头像、粉丝数、关注数
- 作品列表:该用户发布的所有笔记
- 数据统计:总点赞、收藏、评论数
- 商业数据:如有品牌合作,显示合作笔记
使用示例
# 查看用户主页
/xhs-profile --user=小红书号
# 获取用户作品列表(前10篇)
/xhs-profile --user=小红书号 --notes --limit=10xhs-content-plan:内容策划助手
功能:基于热门数据分析,提供选题建议
核心能力
热门话题分析
- 近7天/30天热门话题
- 话题热度趋势
- 话题相关关键词
竞品研究
- 指定领域KOL分析
- 爆款笔记特征提取
- 发布时机建议
选题建议
- 基于热度预测推荐选题
- 标题优化建议
- 标签组合推荐
使用示例
# 分析某话题的热门内容
/xhs-content-plan --topic=护肤 --days=7
# 获取选题建议
/xhs-content-plan --suggest --field=美食
# 竞品分析
/xhs-content-plan --competitor=某KOLsetup-xhs-mcp:服务安装部署
功能:引导用户完成xiaohongshu-mcp服务的完整安装
安装流程
1. 检测MCP服务是否运行
2. 如未运行,引导安装
3. 配置服务参数
4. 验证连接使用示例
# 首次安装
/setup-xhs-mcp
# 检查服务状态
/setup-xhs-mcp --check
# 重新配置
/setup-xhs-mcp --reconfigure使用示例:完整的工作流
场景:AI辅助发布小红书笔记
# Step 1: 确认服务正常运行
/setup-xhs-mcp --check
# → MCP服务运行正常 ✓
# Step 2: 确认已登录
/xhs-login --check
# → 已登录 ✓
# Step 3: 搜索竞品内容
/xhs-search 护肤心得 --sort=likes --limit=5
# → 获取到5篇热门笔记
# Step 4: 分析热门内容
/xhs-content-plan --topic=护肤 --days=7
# → 获取热门话题和选题建议
# Step 5: 发布笔记
/post-to-xhs
# AI: 请提供笔记标题
# 你: 春日护肤心得|敏感肌必入的5款精华
# AI: 请提供正文内容
# 你: 春天到了,敏感肌又开始闹情绪...
# AI: 请提供图片(本地路径)
# 你: /Users/me/Pictures/spring_skincare.jpg
# AI: 预览发布内容:
# 标题:春日护肤心得|敏感肌必入的5款精华
# 正文:春天到了,敏感肌又开始闹情绪...
# 图片:/Users/me/Pictures/spring_skincare.jpg
# 标签:["护肤", "敏感肌", "精华推荐"]
# 可见范围:公开
# 确认发布?(y/n)
# 你: y
# → 发布成功!笔记ID: 123456789技术架构
项目结构
xiaohongshu-mcp-skills/
├── skills/ # Skills集合
│ ├── setup-xhs-mcp/ # 安装部署skill
│ │ └── SKILL.md
│ ├── xhs-login/ # 登录管理skill
│ │ └── SKILL.md
│ ├── post-to-xhs/ # 发布笔记skill
│ │ └── SKILL.md
│ ├── xhs-search/ # 搜索笔记skill
│ │ └── SKILL.md
│ ├── xhs-explore/ # 浏览推荐skill
│ │ └── SKILL.md
│ ├── xhs-interact/ # 互动操作skill
│ │ └── SKILL.md
│ ├── xhs-profile/ # 用户主页skill
│ │ └── SKILL.md
│ └── xhs-content-plan/ # 内容策划skill
│ └── SKILL.md
├── CLAUDE.md # Claude Code集成配置
├── README.md # 项目说明
├── SKILL.md # 统一入口
└── .gitignoreAgent Skills标准
该项目完全遵循Agent Skills开放标准:
# SKILL.md格式
name: skill-name
argument-hint: [参数提示]
description: Skill功能描述关键特性:
- 渐进式披露:按需加载详细内容
- 标准化接口:统一的skill调用方式
- 跨平台兼容:OpenClaw、Claude Code通用
与同类工具对比
| 工具 | 类型 | Stars | 主要功能 | 适用场景 |
|---|---|---|---|---|
| xiaohongshu-mcp-skills | Agent Skills | 175 | 8大技能全覆盖 | AI Agent自动化 |
| xiaohongshu-mcp | MCP服务 | 2.3k | API接口 | 开发者集成 |
| 小红书创作服务平台 | 官方工具 | - | 基础发布 | 手动操作 |
| 新红数据 | 第三方平台 | - | 数据分析 | 付费数据 |
最佳实践
1. 批量内容发布
# 准备多篇笔记批量发布
notes = [
{"title": "笔记1", "content": "内容1", "images": ["path1.jpg"]},
{"title": "笔记2", "content": "内容2", "images": ["path2.jpg"]},
{"title": "笔记3", "content": "内容3", "images": ["path3.jpg"]},
]
for note in notes:
post-to-xhs(note)
time.sleep(3600) # 每小时发布一篇2. 竞品监控系统
# 定期搜索竞品热门内容
/xhs-search 竞品关键词 --sort=likes --days=7
# 如发现爆款笔记,自动收藏
/xhs-interact --action=collect --note_id=爆款ID3. 互动增长策略
# 自动回复模板
templates = {
"感谢关注": "谢谢你的关注!有问题可以随时问我~",
"咨询产品": "这款产品我也用过,确实很不错!",
"负面评论": "感谢反馈,我们会努力改进的~"
}
# 自动回复24小时内的新评论
/xhs-interact --action=auto_reply --hours=24 --template=感谢关注常见问题
Q1: MCP服务连接失败怎么办?
# 1. 检查服务是否运行
ps aux | grep xiaohongshu-mcp
# 2. 重启服务
setup-xhs-mcp --reconfigure
# 3. 检查端口是否被占用
lsof -i :端口号Q2: 登录token过期如何处理?
# token过期会自动提示,使用以下命令重新登录
/xhs-login --reloginQ3: 图片路径必须是绝对路径吗?
是的。MCP服务需要读取本地文件,相对路径会导致错误。
# 正确
image_path = "/Users/me/Pictures/image.jpg"
# 错误
image_path = "image.jpg" # 相对路径会失败Q4: 如何定时发布笔记?
from datetime import datetime, timedelta
# 设定时任务
schedule_time = datetime.now() + timedelta(hours=2)
post-to-xhs(
title="定时发布测试",
content="这是一篇定时发布的笔记",
images=["/path/to/image.jpg"],
schedule_at=schedule_time.isoformat()
)项目地址
| 项目 | 地址 |
|---|---|
| GitHub | https://github.com/autoclaw-cc/xiaohongshu-mcp-skills |
| 依赖项目 | https://github.com/xpzouying/xiaohongshu-mcp |
| Skills标准 | https://agentskills.io |
总结
xiaohongshu-mcp-skills是目前最完整的小红书Agent Skills解决方案,通过8大核心技能覆盖了从账号管理到内容发布的完整流程。其主要优势包括:
- 功能完整:8个skill,无死角覆盖运营全流程
- 标准化设计:遵循Agent Skills标准,跨平台兼容
- 用户确认机制:发布前强制确认,避免错误
- 完善的错误处理:清晰的错误提示和解决建议
- 开源免费:MIT许可证,可自由定制
推荐使用场景:
- ✅ 内容创作者批量发布笔记
- ✅ 品牌方运营多账号
- ✅ KOL研究竞品分析
- ✅ 自动化互动增长
本文基于xiaohongshu-mcp-skills项目编写,发布时间:2026-04-07