ClawHub

Xhs Mcp Service

MCP Tools

小红书（XHS/RED）MCP 服务。通过本地 xhs-mcp-server 服务提供完整的小红书操作能力。 当用户提到小红书、红书、XHS、RED、发笔记、搜笔记、小红书运营等任何与小红书相关的操作时使用此技能。 ⚠️ 前置条件：需要先启动 xhs-mcp-server 服务（默认 http://localhost:18060/mcp）

Install

openclaw skills install xhs-mcp-service

你是小红书操作助手，帮助用户通过 MCP 协议操作小红书。

🔧 部署要求

必须先完成以下步骤：

  1. 进入项目目录

    cd D:\work\xiaohongshu\xiaohongshu-mcp-node

  2. 安装依赖

    npm install

  3. 首次登录小红书

    npm run login

    在弹出的浏览器中扫码登录，登录成功后 cookies 会自动保存。

  4. 启动 MCP 服务

    npm start

    服务将运行在 http://localhost:18060/mcp

📋 功能列表（13个工具）

工具说明参数
check_login_status检查登录状态无
get_login_qrcode获取登录二维码无
delete_cookies删除登录状态无
list_feeds获取首页推荐无
search_feeds搜索笔记keyword, filters?
get_feed_detail获取笔记详情feed_id, xsec_token
like_feed点赞/取消点赞feed_id, xsec_token, unlike?
favorite_feed收藏/取消收藏feed_id, xsec_token, unfavorite?
post_comment_to_feed发表评论feed_id, xsec_token, content
reply_comment_in_feed回复评论feed_id, xsec_token, content, comment_id?, user_id?
user_profile获取用户主页user_id, xsec_token
publish_content发布图文title, content, images, tags?
publish_with_video发布视频title, content, video, tags?

🔧 通过 MCPorter 调用

如果 OpenClaw 已配置 MCPorter，可以这样调用：

# 添加 MCP 服务
mcporter config add xhs-mcp http://localhost:18060/mcp

# 检查登录状态
mcporter call xhs-mcp.check_login_status

# 搜索笔记
mcporter call xhs-mcp.search_feeds keyword="美食"

# 获取首页推荐
mcporter call xhs-mcp.list_feeds

# 点赞（需要 feed_id 和 xsec_token）
mcporter call xhs-mcp.like_feed feed_id="xxx" xsec_token="xxx"

⚠️ MCPorter 限制

MCPorter 在 Windows 命令行下无法传递数组参数，因此：

  • ✅ 简单参数功能：可用 MCPorter（搜索、点赞、收藏、评论等）
  • ❌ 数组参数功能：需要用 Node.js 脚本（发布图文、发布视频）

📝 发布图文/视频

由于 MCPorter 不支持数组参数，发布功能需要用 Node.js 脚本：

// 创建发布脚本 publish.js
import { publishContent } from './src/xhs-tools.js';

await publishContent({
  title: "标题（最多20字）",
  content: "正文内容（最多1000字）",
  images: ["图片1.jpg", "图片2.jpg"],
  tags: ["标签1", "标签2"]
});

运行：

node publish.js

🎯 使用场景

场景1：检查登录状态

用户：帮我检查小红书登录状态
→ mcporter call xhs-mcp.check_login_status

场景2：搜索笔记

用户：搜索小红书上关于咖啡的内容
→ mcporter call xhs-mcp.search_feeds keyword="咖啡"

场景3：点赞收藏

用户：帮我点赞搜索结果的第一篇
→ 1. 搜索获取 feed_id 和 xsec_token
→ 2. mcporter call xhs-mcp.like_feed feed_id=xxx xsec_token=xxx

场景4：发布笔记

用户：帮我发布一篇小红书笔记
→ 需要用 Node.js 脚本（MCPorter 不支持数组参数）
→ node publish.js

📁 项目文件位置

  • 项目目录: D:\work\xiaohongshu\xiaohongshu-mcp-node\
  • 主程序: src/index.js
  • 登录工具: src/login.js
  • 工具实现: src/xhs-tools.js
  • 浏览器管理: src/browser.js
  • Cookies 存储: data/cookies.json

🔧 环境变量

变量说明默认值
XHS_PORT服务端口18060
XHS_HOST绑定地址0.0.0.0
XHS_PROXY代理地址-

使用代理启动：

XHS_PROXY=http://proxy:port npm start

⚠️ 重要注意事项

  1. 账号安全：同一账号不能在多个网页端登录，会互相踢出
  2. 发布限制：每天最多 50 篇笔记
  3. 标题限制：最多 20 字
  4. 正文限制：最多 1000 字
  5. Cookie 有效期：Cookie 可能过期，需要定期重新登录

💡 最佳实践

  1. 简单操作用 MCPorter：搜索、点赞、收藏、评论
  2. 复杂操作用 Node.js：发布图文、发布视频、批量操作
  3. 定时发布：结合 cron 技能定时调用发布脚本
  4. 错误处理：如果操作失败，先检查登录状态

🔗 相关资源

More in MCP Tools