Huashu Douyin Script

抖音爆款脚本创作

从竞品视频拆解到脚本生成的完整工作流。将「凭感觉模仿爆款」变成「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 视频分析：