目录

小红书MCP Skills全集:一条命令搞定小红书运营自动化,AI时代的社媒利器

小红书MCP Skills全集:AI时代的社媒运营利器

项目概述

xiaohongshu-mcp-skills是由autoclaw-cc团队开发的开源项目,基于xiaohongshu-mcp实现,为小红书提供完整的AI Agent自动化操作能力。该项目兼容Agent Skills开放标准,支持OpenClaw、Claude Code等主流AI Agent平台。

指标数值
GitHub Stars175
Forks29
贡献者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 — 正文
  • imagesvideo — 图片列表或视频路径

可选参数:

  • 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 --comments

xhs-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=10

xhs-content-plan:内容策划助手

功能:基于热门数据分析,提供选题建议

核心能力

  1. 热门话题分析

    • 近7天/30天热门话题
    • 话题热度趋势
    • 话题相关关键词
  2. 竞品研究

    • 指定领域KOL分析
    • 爆款笔记特征提取
    • 发布时机建议
  3. 选题建议

    • 基于热度预测推荐选题
    • 标题优化建议
    • 标签组合推荐

使用示例

# 分析某话题的热门内容
/xhs-content-plan --topic=护肤 --days=7

# 获取选题建议
/xhs-content-plan --suggest --field=美食

# 竞品分析
/xhs-content-plan --competitor=某KOL

setup-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                  # 统一入口
└── .gitignore

Agent Skills标准

该项目完全遵循Agent Skills开放标准:

# SKILL.md格式
name: skill-name
argument-hint: [参数提示]
description: Skill功能描述

关键特性

  • 渐进式披露:按需加载详细内容
  • 标准化接口:统一的skill调用方式
  • 跨平台兼容:OpenClaw、Claude Code通用

与同类工具对比

工具类型Stars主要功能适用场景
xiaohongshu-mcp-skillsAgent Skills1758大技能全覆盖AI Agent自动化
xiaohongshu-mcpMCP服务2.3kAPI接口开发者集成
小红书创作服务平台官方工具-基础发布手动操作
新红数据第三方平台-数据分析付费数据

最佳实践

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=爆款ID

3. 互动增长策略

# 自动回复模板
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 --relogin

Q3: 图片路径必须是绝对路径吗?

是的。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()
)

项目地址

项目地址
GitHubhttps://github.com/autoclaw-cc/xiaohongshu-mcp-skills
依赖项目https://github.com/xpzouying/xiaohongshu-mcp
Skills标准https://agentskills.io

总结

xiaohongshu-mcp-skills是目前最完整的小红书Agent Skills解决方案,通过8大核心技能覆盖了从账号管理到内容发布的完整流程。其主要优势包括:

  1. 功能完整:8个skill,无死角覆盖运营全流程
  2. 标准化设计:遵循Agent Skills标准,跨平台兼容
  3. 用户确认机制:发布前强制确认,避免错误
  4. 完善的错误处理:清晰的错误提示和解决建议
  5. 开源免费:MIT许可证,可自由定制

推荐使用场景

  • ✅ 内容创作者批量发布笔记
  • ✅ 品牌方运营多账号
  • ✅ KOL研究竞品分析
  • ✅ 自动化互动增长

本文基于xiaohongshu-mcp-skills项目编写,发布时间:2026-04-07