抖音爆款脚本创作

从竞品视频拆解到脚本生成的完整工作流。将「凭感觉模仿爆款」变成「AI系统拆解+结构化复制」。

环境要求

• uv（Python包管理器）
• yt-dlp（抖音视频下载，需 pip install yt-dlp 或 brew install yt-dlp）
• GEMINI_API_KEY 环境变量（用于Gemini视频分析，从 https://aistudio.google.com/apikey 获取）
• GEMINI_BASE_URL 环境变量（可选，自定义API端点如代理/中转，不设置则用官方端点）
• Chrome浏览器已登录抖音（用于提取下载Cookie）

路径约定：下文中 SKILL_DIR 指本SKILL.md所在目录的绝对路径。运行脚本前，先用 dirname 或 Glob 工具确定SKILL.md的实际位置，替换 SKILL_DIR。

6步工作流

Step 1: 收集输入

向用户收集以下信息：

必填：

• 抖音视频链接（1-5个对标/竞品视频）
• 产品信息（名称、核心卖点、目标人群、价格）
• 脚本类型：种草视频 or 千川投放素材

选填：

• 产品图片（用于脚本中的视觉参考）
• 目标时长（种草默认30秒，千川默认15秒）
• 品牌调性要求
• 投放目标（直播间引流/商品详情页/关注转化）

如果用户只提供了部分信息，主动询问缺失项。

---

Step 2: 下载视频

运行下载脚本：

uv run SKILL_DIR/scripts/download_douyin.py \
  --urls "URL1" "URL2" \
  --output-dir _temp/douyin-downloads

参数说明：

• --urls：支持短链、页面链接、分享文本（自动提取URL）
• --output-dir：默认当前工作目录下 _temp/douyin-downloads/
• --cookies-browser：默认chrome，可选edge/firefox

下载失败时：

1. 提示用户确认Chrome已登录抖音
2. 建议手动下载视频放入 _temp/douyin-downloads/
3. 如果有douyin-mcp-server可用，尝试通过MCP下载

---

Step 3: Gemini视频分析（可并行）

对每个下载成功的视频，调用 Gemini 视频分析：

uv run SKILL_DIR/scripts/analyze_video.py \
  --video "_temp/douyin-downloads/douyin-1-xxx.mp4" \
  --prompt "PROMPT_BELOW" \
  --model flash \
  --resolution medium \
  --output "_temp/douyin-downloads/analysis-1.md"

使用flash模型 + medium分辨率（短视频足够，节省成本）。

多个视频可并行分析（用 run_in_background=true）。

爆款分析Prompt（传入 --prompt 参数）：

作为资深抖音电商视频分析师，请对这个视频进行7维度深度拆解。
特别注意：前3秒是最关键的部分，需要逐帧级别的详细拆解。

## 1. 钩子分析（前3秒）⭐ 最关键
前3秒 = 文案钩子 + 视觉钩子，两条线都要详细分析。

### 1a. 文案钩子
- 钩子类型（反常识/痛点/数据/场景/悬念/利益）
- 钩子文案完整转录
- 文案与产品的关联度（强关联/弱关联）

### 1b. 视觉钩子（逐帧描述）
- 第0秒画面：暂停在最开始，描述这一帧的构图、色调、主体
- 视觉钩子类型（视觉奇观/产品堆叠/画面突变/动作冲击/文字弹出/第一人称POV）
- 具体画面描述：景别、色调、运镜方式、特效、人物表情和动作
- 视觉信息密度：画面中同时出现了多少信息元素

### 1c. 文案×视觉配合
- 文案和画面是否同步强化同一个信息
- 声音设计：前3秒有无音效/BGM变化/人声语气变化
- 综合钩子强度评分（1-10）及理由

## 2. 分镜结构
用表格拆解每个镜头：
| 时间 | 景别 | 画面内容 | 旁白/字幕 | 转场方式 |