小红书笔记发布助手，支持图文笔记和视频笔记两种发布类型。自动校验标题长度、素材有效性，用户确认后执行发布。可设置定时发布、话题标签和可见范围。适用于小红书账号运营者日常发布种草笔记、好物分享、生活记录等内容。
name: post-to-xhs description: | 发布内容到小红书，支持图文笔记和视频笔记。自动判断发布类型，校验标题和素材，用户确认后发布。 当用户想在小红书发布内容时使用——包括发笔记、发图文、发视频、上传图片、写一篇小红书、把内容发到红书上、种草笔记、好物分享等，即使用户只说"帮我发一下"但上下文明确是小红书也应触发。
小红书笔记发布助手
【适用场景】
- 想把图文内容或视频发布到小红书平台 - 需要在小红书发笔记、种草、好物分享 - 想通过手机照片或视频快速生成小红书内容并发布 - 小红书账号运营者日常发布内容
【操作步骤】
第一步：确认登录状态
在发布内容前，先确认是否已登录小红书账号。调用 MCP 工具的 `check_login_status` 检查登录状态。
- 若已登录 → 进入第二步 - 若未登录 → 先引导用户完成登录后再继续
第二步：收集发布信息
向用户询问以下必要信息：
| 信息项 | 说明 | 是否必填 |
|---|---|---|
| 标题 | 小红书笔记标题，最多20个中文字或英文单词 | 必填 |
| 正文 | 笔记正文内容 | 必填 |
| 图片/视频 | 图文笔记提供图片（1张及以上），视频笔记提供本地视频文件绝对路径 | 必填其一 |
| 话题标签 | #话题标签，可选 | 可选 |
| 定时发布 | 定时发布时间，ISO8601格式 | 可选 |
| 原创声明 | 仅图文笔记可选是否声明原创 | 可选 |
| 可见范围 | 公开/仅自己/仅互关好友 | 可选 |
注意事项： - 标题不能超过20个字，超长会被平台截断 - 图文笔记至少需要1张图片（平台不允许纯文字笔记） - 图片和视频只能二选一，不能混用 - 正文不要包含 # 标签，标签通过 `tags` 参数单独传递
第三步：内容校验
收到用户信息后，进行以下校验：
1. 标题长度检查：确认标题不超过20个中文字符 2. 素材检查：确认图片路径或视频路径有效（建议使用绝对路径） 3. 素材类型判断： - 提供视频文件 → 发布视频笔记 - 提供图片 → 发布图文笔记
若用户提供的是URL内容，先用工具提取文本和图片。
第四步：用户确认
在执行发布前，向用户展示完整的发布预览：
``` 📝 即将发布的小红书笔记预览：
标题：[标题内容] 正文：[正文内容] 图片：[图片列表或视频路径] 话题：#话题1 #话题2 定时：[定时时间或"立即发布"] 可见范围：[公开/仅自己/互关好友]
⚠️ 发布后无法撤回，确认发布吗？ ```
等待用户明确确认后再执行发布。
第五步：执行发布
图文笔记 — 调用 `publish_content` MCP工具，参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | string | 标题 |
| content | string | 正文 |
| images | string[] | 图片路径或URL列表 |
| tags | string[] | 话题标签列表 |
| schedule_at | string | 定时发布时间（可选） |
| is_original | bool | 是否原创（可选） |
| visibility | string | 可见范围（可选） |
视频笔记 — 调用 `publish_with_video` MCP工具，参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| title | string | 标题 |
| content | string | 正文 |
| video | string | 本地视频绝对路径 |
| tags | string[] | 话题标签列表 |
| schedule_at | string | 定时发布时间（可选） |
| visibility | string | 可见范围（可选） |
第六步：发布结果
发布成功后，告知用户： - 笔记ID - 发布状态 - 如有定时，告知预计发布时间
【代码模板】
发布图文笔记
```markdown 用户：发一篇小红书笔记
助手：请提供以下信息： - 标题：（不超过20字） - 正文：（笔记内容） - 图片：（本地路径或URL） - 话题标签：（可选，如：#穿搭 #好物分享）
用户：[提供信息]
助手：📝 发布预览确认... [等待用户确认]
用户：确认发布
助手：✅ 发布成功！ 笔记ID：xxxxx 状态：已发布/定时中 ```
【复盘要点】
发布失败处理
| 失败原因 | 解决办法 |
|---|---|
| 未登录 | 引导用户先完成小红书账号登录 |
| 标题超长 | 提示用户缩短标题至20字以内 |
| 图片路径无效 | 提示用户检查图片路径是否正确 |
| 视频使用相对路径 | 提示用户提供视频的绝对路径 |
| 发布被平台拒绝 | 展示错误信息，检查内容是否违规 |
关键约束
- 登录优先：每次发布前必须确认登录状态 - 用户确认：发布前必须展示内容并等待用户确认 - 不可撤回：发布操作一旦执行无法撤销 - 参数来源：feed_id、xsec_token等参数必须从真实搜索或浏览结果中获取，禁止编造
【技能信息】
- 来源：autoclaw-cc/xiaohongshu-mcp-skills - 原始文件：skills/post-to-xhs/SKILL.md - GitHub：https://github.com/autoclaw-cc/xiaohongshu-mcp-skills