Xiaohongshu Mcp Node

小红书 MCP Skill

通过 Model Context Protocol 让 AI 能够操作小红书平台。

🏗️ 架构说明

本 Skill 是一个 MCP Server 集成配置，实际功能由 xiaohongshu-mcp-node MCP Server 提供。

OpenClaw/AI Agent
    ↓ (读取 Skill 配置)
xiaohongshu-mcp-node-skill
    ↓ (启动 MCP Server)
xiaohongshu-mcp-node
    ↓ (MCP Protocol - 13 Tools)
小红书平台

🎯 何时使用此 Skill

当用户需要操作小红书平台时，AI 会自动调用相应的 MCP 工具：

账号管理

内容发布

内容搜索

互动功能

触发关键词：

📋 前置要求

1. 安装 xiaohongshu-mcp-node MCP Server

# 克隆并构建 MCP Server
git clone https://github.com/sipingme/xiaohongshu-mcp-node.git
cd xiaohongshu-mcp-node
安装依赖
npm install
安装浏览器
npx playwright install chromium
构建项目
npm run build
首次登录（获取 Cookie）
npm run login

2. 配置 OpenClaw

在 OpenClaw 的 MCP 配置中添加：

{
  "mcpServers": {
    "xiaohongshu": {
      "command": "node",
      "args": ["/path/to/xiaohongshu-mcp-node/dist/index.js"],
      "env": {
        "HEADLESS": "true",
        "COOKIES_PATH": "/path/to/cookies.json"
      }
    }
  }
}

3. 安装 Skill 文档

# 克隆 Skill 配置和文档
git clone https://github.com/sipingme/xiaohongshu-mcp-node-skill.git
cp -r xiaohongshu-mcp-node-skill ~/.openclaw/skills/xiaohongshu/

🚀 标准操作流程 (SOP)

操作 1：检查登录状态

场景：在执行任何操作前，先确认登录状态

MCP 工具：xhs_check_login

步骤：

1. AI 调用 xhs_check_login 工具 2. 解析返回结果 3. 如果未登录，引导用户登录

输出示例：

{
  "isLoggedIn": true,
  "username": "用户名"
}

异常处理：

操作 2：登录小红书

场景：首次使用或 Cookie 过期

MCP 工具：xhs_get_qrcode

步骤：

1. AI 调用 xhs_get_qrcode 工具获取二维码 2. 向用户展示二维码（Base64 图片） 3. 提示用户使用小红书 App 扫码 4. 扫码成功后，Cookie 自动保存

输出示例：

{
  "image": "data:image/png;base64,iVBORw0KG...",
  "timeout": "4m"
}

异常处理：

操作 3：发布图文内容

场景：用户提供标题、正文和图片，发布到小红书

MCP 工具：xhs_publish_note

步骤：

1. 验证用户已登录（调用 xhs_check_login） 2. 收集发布信息： - 标题（必需，最多20字） - 正文内容（必需） - 图片路径列表（必需，至少1张，最多9张） - 标签（可选，最多10个） - 是否原创（可选） - 可见范围（可选：public/private/friends）

3. 调用 xhs_publish_note 工具：

{
  "title": "文章标题",
  "content": "文章正文内容...",
  "imagePaths": ["/path/to/image1.jpg", "/path/to/image2.jpg"],
  "tags": ["标签1", "标签2"],
  "isOriginal": true,
  "visibility": "public"
}

4. 等待发布完成（可能需要30-60秒）

5. 向用户报告结果

输出示例：

{
  "success": true,
  "noteId": "abc123",
  "message": "发布成功"
}

异常处理：

操作 3：发布视频内容

场景：用户提供标题、正文和视频文件

步骤：

xhs-cli publish-video \
  --title-file /tmp/title.txt \
  --content-file /tmp/content.txt \
  --video /path/to/video.mp4 \
  --tags "视频" "教程"

参数说明：

注意事项：

操作 4：搜索内容

场景：用户想搜索小红书上的内容

步骤：

xhs-cli search \
  --keyword "Node.js" \
  --sort-by "综合" \
  --note-type "图文"

参数说明：

输出示例：

{
  "success": true,
  "count": 20,
  "feeds": [
    {
      "id": "abc123",
      "xsecToken": "xyz789",
      "title": "Node.js 开发技巧",
      "user": {
        "userId": "user123",
        "nickname": "技术博主",
        "avatar": "https://..."
      },
      "cover": "https://...",
      "likeCount": "1.2k",
      "commentCount": "89"
    }
  ],
  "message": "找到 20 条结果"
}

操作 5：获取内容详情

场景：用户想查看某条内容的详细信息

步骤：

xhs-cli get-detail \
  --feed-id "abc123" \
  --xsec-token "xyz789" \
  --load-all-comments

参数说明：

输出包含：

操作 6：发表评论

场景：用户想对某条内容发表评论

步骤：

cat > /tmp/comment.txt << 'EOF'
很棒的分享！学到了很多。
EOF
xhs-cli comment \
  --feed-id "abc123" \
  --xsec-token "xyz789" \
  --content-file /tmp/comment.txt

参数说明：

操作 7：点赞内容

场景：用户想点赞某条内容

步骤：

# 点赞
xhs-cli like \
  --feed-id "abc123" \
  --xsec-token "xyz789"
取消点赞
xhs-cli like \
  --feed-id "abc123" \
  --xsec-token "xyz789" \
  --unlike

操作 8：收藏内容

场景：用户想收藏某条内容

步骤：

# 收藏
xhs-cli favorite \
  --feed-id "abc123" \
  --xsec-token "xyz789"
取消收藏
xhs-cli favorite \
  --feed-id "abc123" \
  --xsec-token "xyz789" \
  --unfavorite

操作 9：获取推荐列表

场景：用户想查看推荐内容

步骤：

xhs-cli list-feeds

输出：返回20条推荐内容，格式同搜索结果

📊 输入输出规范

命令行输出格式

所有命令统一使用 JSON 格式输出：

成功响应：

{
  "success": true,
  "message": "操作成功",
  "data": { ... }
}

错误响应：

{
  "success": false,
  "error": "错误信息"
}

标题长度限制

小红书标题最多 20个字，计算规则：

如果超长，需要提示用户修改或自动截断。

图片要求

视频要求

⚠️ 常见问题和解决方案

问题 1：未登录或 Cookie 过期

症状：提示"未登录"或操作失败

解决：

xhs-cli login

问题 2：标题超过长度限制

症状：提示"标题验证失败"

解决：

问题 3：图片上传失败

症状：提示"图片上传失败"

原因：

解决：

问题 4：浏览器自动化失败

症状：提示"页面元素未找到"

原因：小红书页面结构变化

解决：

问题 5：找不到命令

症状：xhs-cli: command not found

解决：

# 确认安装
npm list -g xiaohongshu-mcp-node-skill
重新安装
npm install -g xiaohongshu-mcp-node-skill
检查 PATH
which xhs-cli

🔒 安全性说明

敏感信息处理

权限要求

数据隐私

🎓 示例对话

用户：帮我把这篇文章发布到小红书

AI：好的，我来帮你发布。请提供以下信息： 1. 文章标题（最多20字） 2. 文章正文 3. 配图（至少1张） 4. 标签（可选）

用户：[提供内容和图片]

AI：收到！我将为你发布到小红书。

[执行命令]

xhs-cli publish \
  --title "Node.js 开发技巧分享" \
  --content "..." \
  --images /tmp/img1.jpg /tmp/img2.jpg \
  --tags "Node.js" "编程" "技术分享" \
  --original

AI：✅ 文章已成功发布到小红书！

📚 参考资料

📝 维护说明

✅ 首次成功检查清单

新用户应该能在 5 分钟内完成：

如果以上步骤都能顺利完成，说明 Skill 已正确配置！