huashu-douyin-script

1# 抖音爆款脚本创作
2 
3从竞品视频拆解到脚本生成的完整工作流。将「凭感觉模仿爆款」变成「AI系统拆解+结构化复制」。
4 
5## 环境要求
6 
7- `uv`（Python包管理器）
8- `yt-dlp`（抖音视频下载，需 `pip install yt-dlp` 或 `brew install yt-dlp`）
9- `GEMINI_API_KEY` 环境变量（用于Gemini视频分析，从 https://aistudio.google.com/apikey 获取）
10- `GEMINI_BASE_URL` 环境变量（可选，自定义API端点如代理/中转，不设置则用官方端点）
11- Chrome浏览器已登录抖音（用于提取下载Cookie）
12 
13**路径约定**：下文中 `SKILL_DIR` 指本SKILL.md所在目录的绝对路径。运行脚本前，先用 `dirname` 或 Glob 工具确定SKILL.md的实际位置，替换 `SKILL_DIR`。
14 
15## 6步工作流
16 
17### Step 1: 收集输入
18 
19向用户收集以下信息：
20 
21**必填**：
22- 抖音视频链接（1-5个对标/竞品视频）
23- 产品信息（名称、核心卖点、目标人群、价格）
24- 脚本类型：种草视频 or 千川投放素材
25 
26**选填**：
27- 产品图片（用于脚本中的视觉参考）
28- 目标时长（种草默认30秒，千川默认15秒）
29- 品牌调性要求
30- 投放目标（直播间引流/商品详情页/关注转化）
31 
32如果用户只提供了部分信息，主动询问缺失项。
33 
34---
35 
36### Step 2: 下载视频
37 
38运行下载脚本：
39 
40```bash
41uv run SKILL_DIR/scripts/download_douyin.py \
42  --urls "URL1" "URL2" \
43  --output-dir _temp/douyin-downloads
44```
45 
46**参数说明**：
47- `--urls`：支持短链、页面链接、分享文本（自动提取URL）
48- `--output-dir`：默认当前工作目录下 `_temp/douyin-downloads/`
49- `--cookies-browser`：默认chrome，可选edge/firefox
50 
51**下载失败时**：
521. 提示用户确认Chrome已登录抖音
532. 建议手动下载视频放入 `_temp/douyin-downloads/`
543. 如果有douyin-mcp-server可用，尝试通过MCP下载
55 
56---
57 
58### Step 3: Gemini视频分析（可并行）
59 
60对每个下载成功的视频，调用 Gemini 视频分析：
61 
62```bash
63uv run SKILL_DIR/scripts/analyze_video.py \
64  --video "_temp/douyin-downloads/douyin-1-xxx.mp4" \
65  --prompt "PROMPT_BELOW" \
66  --model flash \
67  --resolution medium \
68  --output "_temp/douyin-downloads/analysis-1.md"
69```
70 
71**使用flash模型 + medium分辨率**（短视频足够，节省成本）。
72 
73**多个视频可并行分析**（用 `run_in_background=true`）。
74 
75**爆款分析Prompt**（传入 `--prompt` 参数）：
76 
77```
78…