xiaohongshu-mcp

使用 mcporter 调用本地 xiaohongshu MCP 服务，并提供一套开箱即用的小红书工作流脚本。

先做的检查

先验证服务和登录状态：

mcporter --config assets/config/mcporter.json list --json
mcporter --config assets/config/mcporter.json call xiaohongshu.check_login_status

如果本地 MCP 未启动，可使用 assets/docker-compose.xiaohongshu-mcp.yml 启动容器。 具体步骤见 references/setup.md。

常用调用

1) 搜索小红书

./scripts/xhs-search.sh OpenClaw

2) 查看笔记详情

需要 feed_id 和 xsec_token：

./scripts/xhs-detail.sh <feed_id> <xsec_token>
./scripts/xhs-detail.sh <feed_id> <xsec_token> true

如果想把“搜索 → 选中结果 → 自动读详情”串起来：

./scripts/xhs-pick-detail.sh OpenClaw
./scripts/xhs-pick-detail.sh --comments OpenClaw

3) 发表评论 / 回复评论

一级评论：

./scripts/xhs-comment.sh <feed_id> <xsec_token> "评论内容"

回复指定评论：

./scripts/xhs-comment.sh <feed_id> <xsec_token> "回复内容" <comment_id> <user_id>

4) 发布图文

发布前优先用“仅自己可见”测试。

./scripts/xhs-publish.sh assets/templates/publish-template-private.json
./scripts/xhs-publish.sh assets/templates/publish-template-public.json
./scripts/xhs-publish.sh assets/templates/publish-template-url-image.json

5) 发布视频

直接调用 MCP：

mcporter --config assets/config/mcporter.json call xiaohongshu.publish_with_video --args '{"title":"标题","content":"正文","video":"/videos/demo.mp4","visibility":"仅自己可见","tags":["标签1"]}'

本地图片规则

如果发布时使用本地图片，不要传宿主机路径，传容器内路径。

默认挂载建议：

• 宿主机目录：./data/xiaohongshu-mcp/images
• 容器内目录：/images

示例：

• 宿主机文件：./data/xiaohongshu-mcp/images/demo.png
• 发布参数里应写：/images/demo.png

如果只是快速验证发布能力，也可以直接传 HTTPS 图片 URL。

建议流程

1. 先 check_login_status
2. 搜索或读取笔记时，先取 feed_id / xsec_token
3. 发布内容时，默认先用 visibility=仅自己可见
4. 确认无误后，再改成 公开可见
5. 发布动作可能较慢，设置：MCPORTER_CALL_TIMEOUT=300000

注意事项

• 脚本默认使用仓库内的 assets/config/mcporter.json
• 本地图片必须使用容器内可见路径
• 如果发布超时，先看容器日志：

docker logs --tail 200 <your-xiaohongshu-mcp-container>

• 如果登录失效，可重新检查：

mcporter --config assets/config/mcporter.json call xiaohongshu.check_login_status
mcporter --config assets/config/mcporter.json call xiaohongshu.get_login_qrcode