小红书内容创作助手

---
name: xhs-creator
description: 小红书内容创作全流程 — 话题调研、竞品分析、智能撰写、封面生成、一键发布。当用户想发小红书、创作小红书笔记、做小红书竞品研究、生成小红书封面时触发。
user_invocable: true
argument: topic or subcommand
---

# 小红书内容创作助手

执行完整的小红书内容创作工作流：头脑风暴 -> 竞品研究 -> 模式分析 -> 内容生成 + AI封面 -> 人工审核 -> 发布

整合能力：brainstorming、xhs-autopilot MCP、HTML 封面生成

## 调用方式

- `/xhs-creator "话题关键词"` — 完整流程
- `/xhs-creator research "关键词"` — 仅竞品研究和分析
- `/xhs-creator write` — 跳过研究，直接撰写（需用户提供方向）
- `/xhs-creator image "描述"` — 仅生成封面图

---

## Phase 0: 头脑风暴

通过 1-3 个快速问题明确创作方向，每条消息只问一个。

### 必问问题（使用 AskUserQuestion）

**Q1: 内容目标** — 种草推荐 / 知识分享 / 经验分享 / 测评对比

**Q2: 风格偏好** — 干货满满 / 轻松有趣 / 专业权威 / 情感共鸣

**Q3: 封面风格**（可选）— AI实景风格 / 插画扁平风 / 文字排版为主 / AI自动推荐

如果用户调用时已给出明确方向，直接提取意图，只补问缺失项。

---

## Phase 1: 竞品研究

对话题执行双通道研究（站内竞品 + 站外情报）。

### 1A: 站内竞品搜索（小红书 MCP）— 并行执行 3 次

1. `search_feeds(keyword, {sort_by: "最多点赞"})` — 找爆款
2. `search_feeds(keyword, {sort_by: "最多收藏"})` — 找高价值收藏型
3. `search_feeds(keyword, {sort_by: "最新", publish_time: "一周内"})` — 找近期趋势

### 1B: 站外情报搜索（WebSearch）— 与 1A 并行

1. 行业动态: `WebSearch("[话题关键词] 最新进展 2026")`
2. 热点事件: `WebSearch("[话题关键词] 热门话题 争议")`
3. 专业深度（可选）: `WebSearch("[话题关键词] 深度分析 教程")`

站外情报的价值：获取尚未被小红书作者覆盖的新信息，形成信息差优势。

### 详情抓取

从搜索结果中选取互动数据最高的 5-8 篇，调用 `get_feed_detail(feed_id, xsec_token)` 获取完整内容 + 前10条评论。

### 作者分析

对 Top 3 高互动笔记的作者调用 `user_profile(user_id, xsec_token)`。

### 输出格式

```
═══ 竞品研究报告 ═══
话题: [关键词] | 研究时间: [日期]

── 站内竞品 (小红书) ──
┌──────┬────────┬──────┬──────┬──────┐
│ 排名  │ 标题    │ 点赞  │ 收藏  │ 评论  │
└──────┴────────┴──────┴──────┴──────┘
内容详情摘要:（每篇笔记的结构、亮点、标签）

── 站外情报 (Web) ──
◆ 行业动态 / ◆ 热点争议 / ◆ 信息差机会
```

---

## Phase 2: 模式分析

基于 Phase 1 数据分析并输出 Strategy Brief：

1. **标题模式**: 数字、情感词、悬念/好奇心、长度分布
2. **内容结构**: 清单体/教程体/故事体/对比体/测评体的分布
3. **标签策略**: 热门大标签 + 精准中标签 + 长尾小标签
4. **评论区洞察**: 高频问题、未满足需求
5. **差异化机会**: 结合站外情报找信息差和深度提升空间
6. **封面图分析**: 竞品封面风格、高互动共同特征、差异化建议

如果是 `research` 模式，到此结束。

---

## Phase 3: 内容生成

### 标题规则

- 字数 <= 20 字（小红书硬限制），提供 3 个候选，融入数字/情感词/悬念至少 1 种

### 正文规则

- 600-900 字（上限约1000字，emoji按多字符计，需留余量）
- 短段落（2-4 句），开头抓注意力，结尾引导互动
- 风格遵循 Phase 0 选择，结构采用 Phase 2 推荐

### 标签规则

- 5-8 个，热门 2-3 + 精准 2-3 + 长尾 1-2
- 不在正文中写 #标签，所有标签通过 tags 参数传递

### 封面图生成（HTML + 截图方案）

#### Step 3: 生成封面图

1. 使用 HTML/CSS 创建精美封面模板（3:4 竖屏，3000x4000px）
2. 封面需包含：主标题（醒目大字）、副标题/关键词、背景色/渐变/图案
3. 使用 Playwright 截图生成 PNG：
```bash
# 启动本地 HTML 文件后截图
playwright screenshot cover.html cover.png --viewport-size=3000,4000
```
4. 设计风格参考：小红书热门笔记封面，避免 AI 感，追求自然排版

#### 封面不满意时

1. 调整 HTML 样式重新截图
2. 更换配色/排版方案
3. 使用 Pillow 方案作为备选（见 `references/cover-fallback.md`）

### 自检清单

- [ ] 标题 <= 20 字，正文 600-900 字
- [ ] 无 AI 腔、无敏感词
- [ ] 标签 5-8 个，封面图已生成（3:4 竖屏）
- [ ] 语气自然，开头有吸引力，结尾有互动引导
- [ ] （视频帖子）如需配音，见 `references/tts-voiceover.md`

---

## Phase 4: 人工审核

展示完整预览（标题候选、推荐标题、标签、正文、封面图、自检结果、建议发布时间），然后用 AskUserQuestion 提供选项：

1. 确认发布（立即）
2. 定时发布（指定时间）
3. 修改内容
4. 重新生成封面
5. 重新生成全部
6. 放弃本次创作

发布时间参考：早7-9(通勤)、中12-14(午休)、晚18-20(下班)、晚21-23(黄金时段)

---

## Phase 4.5: 视频配音（可选，仅限视频帖子）

如需添加旁白/配音，用 MiniMax TTS 生成并用 ffmpeg 混入视频。

详细代码和声音 ID 见 `references/tts-voiceover.md`。

需要设置环境变量 `$MINIMAX_API_KEY`。

---

## Phase 5: 发布

### 立即发布

```
调用 publish_content:
  - title: 确认的标题
  - content: 正文内容（不含标签）
  - images: [封面图绝对路径]
  - tags: [标签列表]
```

### 定时发布

```
调用 publish_content:
  - title / content / images / tags（同上）
  - schedule_at: ISO8601 格式时间（用户指定）
```

---

## 仅生成封面模式（`/xhs-creator image "描述"`）

使用 HTML 模板生成封面：
1. 根据用户描述创建 HTML 封面（3:4 竖屏）
2. 使用 Playwright 截图导出 PNG

---

## 平台限制速查

| 项目 | 限制 |
|------|------|
| 标题 | 最多 20 个中文字符 |
| 正文 | 约 1000 字上限（emoji 按多字符计，安全区间 600-900 字） |
| 封面图 | 3:4 竖屏，最大 5MB |
| 标签 | 通过 `tags` 参数传递，不含 `#` 前缀 |

## 注意事项

1. 登录检查：执行任何操作前先调用 `check_login_status` 确认已登录
2. 速率控制：搜索和详情请求之间保持自然间隔
3. 内容原创：不得复制/拼凑竞品内容
4. 数据隐私：不要暴露竞品作者的私人信息
5. 错误处理：MCP 调用失败时告知用户并提供替代方案
6. 研究数据：保存到 `workspace/<run_id>/` 目录
7. 封面图回退：HTML 截图失败时使用 Pillow 方案（见 `references/cover-fallback.md`）

## 参考文件

- `references/tts-voiceover.md` — MiniMax TTS 配音代码和声音 ID 列表
- `references/cover-fallback.md` — 封面图备选方案（HTML+Playwright / Pillow）