xiaohongshu-publish：小红书自动化发布 Skill

## 一句话介绍 通过 xiaohongshu-mcp MCP 服务器自动化发布小红书笔记，支持定时批量发布。 ## 适用场景 - 自动发布图文笔记到小红书创作中心 - 搭配 WorkBuddy 定时自动化实现无人值守批量发布 - 标题、正文、图片、标签一键填写 ## 架构 ``` WorkBuddy → MCP HTTP (localhost:18060) → Go xiaohongshu-mcp server → Playwright → 小红书创作中心 ``` Go 服务器管理浏览器会话和 Cookie，WorkBuddy 通过 HTTP 调用 MCP 工具。 ## 使用步骤 ### Step 1：环境设置（一次性） **下载 Go MCP 二进制** ```bash curl -L https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-darwin-arm64 -o ~/Downloads/xiaohongshu-mcp-darwin-arm64/xiaohongshu-mcp-darwin-arm64 curl -L https://github.com/xpzouying/xiaohongshu-mcp/releases/latest/download/xiaohongshu-login-darwin-arm64 -o ~/Downloads/xiaohongshu-mcp-darwin-arm64/xiaohongshu-login-darwin-arm64 ``` **移除 macOS 隔离标记** ```bash xattr -d com.apple.quarantine ~/Downloads/xiaohongshu-mcp-darwin-arm64/* chmod +x ~/Downloads/xiaohongshu-mcp-darwin-arm64/* ``` **扫码登录保存 Cookie** ```bash cd ~/Downloads/xiaohongshu-mcp-darwin-arm64 ./xiaohongshu-login-darwin-arm64 ``` 浏览器打开后用小红书 App 扫码，Cookie 自动保存到 cookies.json。 **安装 Playwright Chromium** ```bash npx playwright install chromium ``` ### Step 2：启动 MCP 服务器 ```bash cd ~/Downloads/xiaohongshu-mcp-darwin-arm64 ./xiaohongshu-mcp-darwin-arm64 > /tmp/xiaohongshu-mcp.log 2>&1 & ``` 验证运行状态： ```bash curl -s http://localhost:18060/mcp -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' | head -20 ``` > 服务器是手动进程，不会随 WorkBuddy 自动启动。重启后需要手动重启服务器。 ### Step 3：配置 WorkBuddy MCP 在 ~/.workbuddy/mcp.json 中添加： ```json { "mcpServers": { "xiaohongshu-mcp": { "type": "http", "url": "http://localhost:18060/mcp" } } } ``` 写完后重启 WorkBuddy 加载 MCP 工具。 ### Step 4：验证工具加载 | 工具 | 用途 | |------|------| | publish_content | 发布完整笔记（标题、正文、图片、标签） | | check_login_status | 检查登录状态 | | get_login_qr | 获取登录二维码 | | search_notes | 搜索已发布笔记 | ### Step 5：发布笔记 ```json { "title": "标题（限制20个中文字以内）", "content": "正文内容，支持 emoji", "images": ["/absolute/path/to/image.png"], "tags": ["标签1", "标签2"], "is_original": true } ``` **内容规范：** - 标题最多20个中文字，emoji算1个字符 - 标签建议5-10个 - 图片用绝对路径，1-9张，建议 1080x1440（3:4） ### Step 6：定时自动化 为批量发布创建 automation，每条笔记一个自动化任务： ``` 自动发布小红书图文笔记。使用 mcp__xiaohongshu-mcp__publish_content 工具发布以下内容： 标题：[精简到20字以内的标题] 实际发布标题请用：[可微调后更吸引人的版本] 正文：[完整 emoji 正文] 图片：[绝对路径数组] 标签：[标签数组] 声明原创：true 注意：小红书标题限制20个中文字以内。 ``` ## ⚠️ MCP 客户端超时问题（踩坑必读） **问题**：publish_content 通常需要 90-120 秒完成。WorkBuddy 的 DeferExecuteTool 约 60 秒超时，会报 MCP error -32001: Request timed out。 **解决方案**：超时后使用直接 HTTP 发布脚本，设置 180 秒超时： 1. initialize → 获取 session ID 2. notifications/initialized → 激活会话 3. tools/call publish_content → 长超时发布 关键要求： - Header Accept: application/json, text/event-stream - Header Mcp-Session-Id 在 initialize 之后的所有请求中携带 - 必须先完成 initialize 流程才能调用 tools/call ## 常见问题 - **MCP 工具不可用**：检查 Go 服务器是否运行（lsof -i :18060），重启后重启 WorkBuddy - **登录过期**：运行 check_login_status，过期则重新执行 xiaohongshu-login-darwin-arm64 - **标题太长**：严格计算中文字数（emoji=1字），修剪到20字以内 - **图片上传失败**：确认文件存在、PNG/JPG 格式、建议 1080x1440 - **MCP 配置冲突**：npm 的 xiaohongshu-mcp 包用 stdio 且没有 publish_content，只用 Go 版本 ## 使用方式 这是一个可直接加载的 WorkBuddy Skill。将内容保存为 ~/.workbuddy/skills/xiaohongshu-publish/SKILL.md 即可使用。 如果你也在做小红书内容运营，或者需要自动化发布笔记，这个 Skill 可以直接拿来用。欢迎评论交流。 ——年年 🌿