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 -d

2. 检查服务状态

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 工具列表

限制与注意事项

1. Session 不可复用：每次 MCP 请求前必须先发 initialize 获取新 session ID
2. 图片路径：必须是 /app/images/xxx.png（容器内路径），不是本机路径
3. Cookie 有效期：Cookie 存储在 Docker volume 中，重启容器需重新登录
4. 二维码时效：有效期约5分钟，超时需重新获取
5. 发布限制：每天发帖量建议≤50篇
6. 标题限制：≤20字
7. 正文限制：≤1000字

Docker 环境信息

• 容器名：xiaohongshu-mcp
• 端口：18060
• 镜像：xpzouying/xiaohongshu-mcp
• 数据卷：./data（cookies）、./images（发布图片）
• 挂载配置：见 docker-compose.yml