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

| 工具名 | 用途 | 关键参数 | |---|---|---| | 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