- name
- xhsmander
- description
- |
xhsmander - 小红书定制化发布技能（完整工作流）
通过 xiaohongshu-mcp (Docker) 提供完整的小红书自动化能力。
文件结构
xhsmander/
├── SKILL.md # 本技能说明
├── docker-compose.yml # Docker 启动配置
├── _meta.json # 元数据
├── scripts/
│ ├── mcp_dispatcher.py # MCP 调度器（核心）
│ ├── check_login.py # 检查登录状态
│ ├── get_qrcode.py # 获取登录二维码
│ ├── publish.py # 发布图文（原始）
│ ├── search.py # 搜索内容
│ ├── cli.py # CLI 工具
│ ├── __init__.py
│ ├── check_status.py # 检查登录状态（简化版）
│ ├── get_qr.py # 获取二维码并保存（简化版）
│ └── publish_post.py # 发布图文（直接运行版）
└── references/
└── mcp_api.md # MCP API 参考快速部署
1. 启动 Docker 容器
cd skills/xhsmander
docker compose up -d2. 检查服务状态
python scripts/check_status.py输出 Done 即表示服务正常运行。
3. 首次登录（获取二维码）
python scripts/get_qr.py二维码保存在 scripts/qrcode.png，发送给用户扫码登录。
4. 发布图文笔记
编辑 scripts/publish_post.py 中的 title、content、images 路径，然后运行：
python scripts/publish_post.py核心脚本
mcp_dispatcher.py
MCP HTTP+JSON-RPC 调度器，每次调用自动处理 initialize + session 管理。
publish_post.py（直接运行版）
封装好的发布脚本，直接修改顶部变量即可发布：
title = "笔记标题（≤20字）"
content = "笔记正文（≤1000字）"
images = ['/app/images/your_image.png'] # 容器内路径
tags = ["标签1", "标签2"]图片路径规则：
- 图片必须放在
scripts/images/目录 - 容器内路径为
/app/images/xxx.png - 本机路径需映射到容器内路径
check_status.py
简化版登录状态检查，运行后结果保存在 scripts/login_status.json。
get_qr.py
简化版二维码获取，运行后：
- 二维码图片：
scripts/qrcode.png - 完整响应：
scripts/qrcode_result.json
架构说明
本机(OpenClaw) --HTTP+JSON-RPC--> Docker容器(xiaohongshu-mcp) --Chrome/ROD--> 小红书网页关键路径规则：
- 本机路径（如图片）→ 容器无法直接访问
- 容器内路径
/app/images/→ 本机scripts/images/目录（docker-compose 挂载） - 发布图片时，images 参数传容器内路径
/app/images/xxx.png
MCP API 工具列表
| 工具名 | 用途 | 关键参数 |
|---|---|---|
check_login_status | 检查登录状态 | 无 |
get_login_qrcode | 获取登录二维码 | 无 |
publish_content | 发布图文 | title, content, images, tags |
search_feeds | 搜索笔记 | keyword |
list_feeds | 首页推荐 | 无 |
like_feed | 点赞 | feed_id, xsec_token |
favorite_feed | 收藏 | feed_id, xsec_token |
get_feed_detail | 笔记详情 | feed_id, xsec_token |
user_profile | 用户主页 | user_id, xsec_token |
post_comment_to_feed | 评论 | feed_id, xsec_token, content |
限制与注意事项
- Session 不可复用：每次 MCP 请求前必须先发 initialize 获取新 session ID
- 图片路径：必须是
/app/images/xxx.png（容器内路径），不是本机路径 - Cookie 有效期：Cookie 存储在 Docker volume 中，重启容器需重新登录
- 二维码时效：有效期约5分钟，超时需重新获取
- 发布限制：每天发帖量建议≤50篇
- 标题限制：≤20字
- 正文限制：≤1000字
Docker 环境信息
- 容器名：
xiaohongshu-mcp - 端口：18060
- 镜像：
xpzouying/xiaohongshu-mcp - 数据卷：
./data（cookies）、./images（发布图片） - 挂载配置：见
docker-compose.yml