抖音内容一站式创作

---
name: douyin-creator
description: 抖音内容创作全流程 — 头脑风暴、话题调研、竞品分析、智能撰写、封面生成、一键发布。当用户想发抖音、创作抖音内容、做抖音竞品研究、生成抖音封面时触发。
user_invocable: true
argument: topic or subcommand
---

# 抖音内容创作助手

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

整合能力：brainstorming、douyin MCP、Playwright MCP、HTML 封面生成（Playwright 截图）

## 调用方式

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

## 搜索策略

优先级：Playwright > chrome-cdp > douyin MCP（避免验证码）

详细搜索模板见 `references/playwright-search.md`。

---

## Phase 0: 头脑风暴

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

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

**Q1: 内容类型** — 图文帖子 / 视频帖子 / 先做竞品研究再决定

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

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

如果用户调用时已给出明确方向（如 `/douyin-creator "Claude Code 新手教程，干货风格"`），直接提取意图，只补问缺失项。

---

## Phase 1: 竞品研究

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

### 1A: 站内竞品搜索（Playwright + 抖音网页版）

1. 导航到 `https://www.douyin.com/search/关键词?type=video`
2. 用 `browser_run_code` 提取前 10-15 条搜索结果
3. 记录：标题、视频链接、作者、互动数据

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

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

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

### 详情抓取

从搜索结果中选取互动数据最高的 5-8 个视频，调用 `mcp__douyin__douyin_get_video_detail(url)` 获取完整信息。

### 作者分析

对 Top 3 高互动视频的作者调用 `mcp__douyin__douyin_user_profile(user_url)`。

### 输出格式

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

── 站内竞品 (抖音) ──
┌──────┬────────┬──────┬──────┬──────┬──────┐
│ 排名  │ 标题    │ 作者  │ 点赞  │ 评论  │ 时长  │
└──────┴────────┴──────┴──────┴──────┴──────┘
内容详情摘要:（每个视频的结构、亮点、标签）

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

---

## Phase 2: 模式分析

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

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

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

---

## Phase 3: 内容生成

### 标题规则

- 字数 <= 55 字符，提供 3 个候选，融入数字/情感词/悬念至少 1 种

### 描述/正文规则

- 300-800 字，短段落（2-3 句），开头抓注意力，结尾引导互动
- 风格遵循 Phase 0 选择，结构采用 Phase 2 推荐

### 标签规则

- 3-6 个，热门 1-2 + 精准 2-3 + 长尾 1，通过 tags 参数传递（不带 #）

### 封面图生成（HTML + Playwright 截图）

#### Step 3A: 创建 HTML/CSS 封面模板

根据内容类型和风格，创建一个 HTML 文件作为封面模板：

- **视频封面**: 16:9 横屏（1920x1080）
- **图文封面**: 3:4 竖屏（1080x1440）

HTML 模板应包含：
- 大标题文字（醒目、简洁）
- 品牌色/渐变背景
- 关键数字或亮点提炼
- 适当的图标或装饰元素（纯 CSS 实现）

模板保存到: `<YOUR_WORKSPACE>/douyin-creator/workspace/<run_id>/cover.html`

#### Step 3B: 用 Playwright 截图生成封面

使用 Playwright MCP 打开 HTML 文件并截图：

1. `browser_navigate` 打开 `file://<YOUR_WORKSPACE>/douyin-creator/workspace/<run_id>/cover.html`
2. `browser_take_screenshot` 截图保存为 `cover.png`

- run_id 使用时间戳如 `20260227_143000`
- 确保浏览器窗口尺寸匹配目标比例（16:9 或 3:4）

#### Step 3C: 封面不满意时

1. 调整 HTML/CSS 样式重新截图
2. 更换配色方案或布局
3. 用户自行提供封面图

### 自检清单

- [ ] 标题 <= 55 字符，描述 300-800 字
- [ ] 无 AI 腔、无敏感词
- [ ] 标签 3-6 个，封面图已生成且比例正确
- [ ] 语气自然，开头有吸引力，结尾有互动引导

---

## Phase 4: 人工审核

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

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

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

---

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

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

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

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

---

## Phase 5: 发布

### 登录检查

发布前调用 `mcp__douyin__douyin_check_login_status()`，未登录则调用 `mcp__douyin__douyin_get_login_qrcode()` 扫码。

### 发布图文帖子

```
mcp__douyin__douyin_publish_image_post:
  - images: [封面图绝对路径数组]（至少 1 张）
  - title: 确认的标题（<= 100 字符）
  - description: 正文描述（<= 2000 字符）
  - tags: [标签列表]（不带 # 号）
```

### 发布视频帖子

```
mcp__douyin__douyin_publish_video:
  - video_path: 视频文件绝对路径
  - title: 确认的标题（<= 100 字符）
  - description: 视频描述（<= 2000 字符）
  - tags: [标签列表]（不带 # 号）
  - cover_path: 封面图绝对路径（可选）
```

---

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

简化流程：理解需求 -> 创建 HTML 封面模板 -> Playwright 截图 -> 展示结果

1. 根据用户描述创建 HTML/CSS 封面（视频 16:9，图文 3:4）
2. 用 Playwright 打开 HTML 文件并截图为 PNG
3. 输出路径: `<YOUR_WORKSPACE>/douyin-creator/workspace/<run_id>/cover.png`

---

## 平台限制速查

| 项目 | 限制 |
|------|------|
| 标题 | 最多 100 个字符 |
| 描述 | 最多 2000 个字符（推荐 300-800 字） |
| 视频封面 | 16:9 横屏 |
| 图文封面 | 3:4 竖屏 |
| 标签 | 通过 `tags` 参数传递，不含 `#` 前缀 |
| 图片 | 至少 1 张（图文帖子） |
| 视频 | 本地文件绝对路径（视频帖子） |

## 注意事项

1. 登录检查：发布前先调用 `douyin_check_login_status` 确认已登录
2. 速率控制：搜索和详情请求之间保持自然间隔
3. 内容原创：不得复制/拼凑竞品内容
4. 数据隐私：不要暴露竞品作者的私人信息
5. 错误处理：MCP 调用失败时告知用户并提供替代方案
6. 研究数据：保存到 `workspace/<run_id>/` 目录
7. 封面图：HTML + Playwright 截图，无需外部 API
8. 封面设计：标题醒目、配色协调、布局清晰

## 参考文件

- `references/playwright-search.md` — Playwright 抖音搜索模板和代码
- `references/tts-voiceover.md` — MiniMax TTS 配音代码和声音 ID 列表