xiaohongshu-mcp

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

先做的检查

先验证服务和登录状态：

bash
mcporter --config assets/config/mcporter.json list --json
mcporter --config assets/config/mcporter.json call xiaohongshu.checkloginstatus

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

常用调用

1) 搜索小红书

bash
./scripts/xhs-search.sh OpenClaw

2) 查看笔记详情

需要 feedid 和 xsectoken：

bash
./scripts/xhs-detail.sh id> token>
./scripts/xhs-detail.sh id> token> true

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

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

3) 发表评论 / 回复评论

一级评论：

bash
./scripts/xhs-comment.sh id> token> 评论内容

回复指定评论：

bash
./scripts/xhs-comment.sh id> token> 回复内容 id> id>

4) 发布图文

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

bash
./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：

bash
mcporter --config assets/config/mcporter.json call xiaohongshu.publishwithvideo --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. 1. 先 checkloginstatus
2. 搜索或读取笔记时，先取 feedid / xsectoken
3. 发布内容时，默认先用 visibility=仅自己可见
4. 确认无误后，再改成 公开可见
5. 发布动作可能较慢，设置：MCPORTERCALLTIMEOUT=300000

注意事项

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

bash
docker logs --tail 200

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

bash
mcporter --config assets/config/mcporter.json call xiaohongshu.checkloginstatus
mcporter --config assets/config/mcporter.json call xiaohongshu.getloginqrcode