| name | short-video-replicator |
| description | 短视频爆款复刻一站式工具。输入抖音/B站/YouTube链接或本地视频路径，自动完成： 视频下载与语音转录 → 结构化文字稿 → 三维度爆款分析 → 文案二创 → 口播脚本×3 + 小剧情脚本×3 → Viral-5D评分 → PDF报告导出（可选飞书推送）。 使用场景：拆解爆款视频、学习短视频文案技巧、生成可直接拍摄的二创脚本。 关键词：短视频复刻、爆款分析、口播脚本、小剧情、文案二创、视频转录、PDF报告、抖音、B站
|
| tags | ["Video","Media","Content"] |
| aliases | ["短视频复刻","爆款分析","口播脚本","文案二创"] |
short-video-replicator
短视频爆款复刻全流程 Skill。从一条链接到一套可拍摄脚本，7步完成。
运行环境： 本 Skill 主要面向云端主机上的 OpenClaw 运行。Agent 拥有浏览器操作能力，应 优先使用浏览器工具 访问用户提供的视频链接，进行播放、观察和辅助下载。
快速开始
python skills/short-video-replicator/scripts/main.py "<视频URL或本地路径>"
生成 canvas/{date}/{video_id}/{video_id}_transcript.md，之后按 7 步工作流执行。
7步工作流
Step 1 — 运行转录脚本
1a. 浏览器预访问（优先）
收到用户视频链接后，第一步始终用浏览器工具打开该 URL：
- 用浏览器导航到视频页面，等待页面加载完成
- 登录弹窗处理： 国内平台（抖音、B站等）几乎都会弹出登录窗口。直接关闭弹窗（点击关闭按钮 / 点击弹窗外部区域），然后 点击视频播放区域，绝大多数情况下可以在游客模式正常播放
- 确认视频可正常播放后，记录页面最终 URL（可能发生重定向），供后续脚本使用
- 如果浏览器获取到了可直接使用的视频直链或有用信息（如标题、时长），一并记录
1b. 运行下载+转录脚本
python skills/short-video-replicator/scripts/main.py "<URL>"
- 抖音：自动尝试 iesdouyin 分享页 → yt-dlp → 浏览器 cookies
- 其他平台（B站/YouTube）：yt-dlp
- 脚本下载失败时： 回到浏览器，尝试通过页面交互获取可用的视频链接（如点分享→复制链接，取短链后重跑脚本）
产出：canvas/{date}/{video_id}/{video_id}_transcript.md（ASR直出）
Step 2 — 结构化文字稿
读取 _transcript.md（只处理 ## Full Transcript 之后的正文，忽略元数据），
按 references/structuring.md 规范校正并结构化，输出到会话 + 保存为 _structured.md。
Step 3 — 三维度分析
读取 _structured.md，按 references/analysis-guide.md 框架进行分析，直接在会话输出：
- TextContent 叙事结构 + 声音 + 修辞 + 词库
- Viral-5D 初步诊断
- 执行迭代框架（脚本结构 / 亮点 / 优化建议）
Step 4 — 文案二创
基于 Step 3 分析结论，按 references/de-ai-guide.md 去AI化风格生成文案二创，直接在会话输出。
Step 5 — 口播脚本 × 3 + 小剧情脚本 × 3
- 口播：参照 references/voiceover.md，3个版本方向明显差异
- 小剧情：参照 references/minidrama.md，3个版本痛点场景不同
- 全程参照 references/de-ai-guide.md 去AI化
Step 6 — Viral-5D 整体诊断 + 综合评分
对 Step 4 + Step 5 全部输出进行整体打分：
Viral-5D 整体诊断
| 维度 | 评分 | 说明 |
|------|------|------|
| Hook | ⭐⭐⭐⭐ | ... |
| Emotion | ⭐⭐⭐ | ... |
| 爆点结构 | ⭐⭐⭐⭐ | ... |
| CTA | ⭐⭐⭐ | ... |
| 社交货币 | ⭐⭐⭐⭐ | ... |
综合得分：XX/100
推荐优先拍摄：[版本名称 + 理由]
Step 7 — PDF 报告导出
-
将 Step 2-6 原文逐字写入 canvas/{date}/{video_id}/{video_id}_report.md（禁止删减/改写）
- 标题规范：
# 仅用于报告总标题；## 大板块；### 小节；#### 子项
_structured.md 自带 H1，拼入时降为 ## 结构化文字稿，其子 ## 降为 ###
-
生成 PDF：
python skills/short-video-replicator/scripts/convert.py \
canvas/{date}/{video_id}/{video_id}_report.md \
canvas/{date}/{video_id}/{video_id}_report.pdf
- 飞书推送判断：读取
~/.easyclaw/easyclaw.json 中 channels.feishu：
enabled: true + appId 非空 → 用飞书 Doc 能力推送，返回链接enabled: true + appId 为空 → 提示用户在 EasyClaw 设置中配置 appId/appSecretenabled: false → 询问用户需要什么格式（Word / 纯文本 / 飞书 / 其他）
输出目录结构
canvas/{date}/{video_id}/
├── {video_id}_transcript.md # Step 1 脚本生成
├── {video_id}_structured.md # Step 2 Agent生成
└── {video_id}_report.md # Step 7 完整报告
└── {video_id}_report.pdf # Step 7 PDF
重要约束
- 所有输出必须使用 Markdown 格式，严禁 HTML 标签（
<table> <thead> 等）
- 所有输出必须完整，不得截断；内容较长时分段持续输出直到完毕
- 禁止使用本地模型（FunASR、Whisper 本地版等）
- 输出目录由脚本自动管理，Agent 不得修改
References
| 文件 | 用途 |
|---|
references/structuring.md | Step 2 校正+结构化规范 |
references/analysis-guide.md | Step 3 三维度分析框架 + Viral-5D |
references/de-ai-guide.md | 去AI化写作风格（Step 4-5全程参照） |
references/voiceover.md | Step 5 口播脚本生成指南 |
references/minidrama.md | Step 5 小剧情脚本生成指南 |
浏览器操作要点
本 Skill 运行在云端 OpenClaw 环境，Agent 可直接操控浏览器。以下是关键操作规范：
- 优先浏览器： 收到视频链接后，第一反应是用浏览器打开，而非直接跑脚本
- 登录弹窗一律关闭： 抖音、B站、快手等国内平台打开后几乎都会弹登录框。处理方式统一：
- 点击弹窗的关闭按钮（×），或点击弹窗外部蒙层区域关闭
- 关闭后点击视频播放区域，即可进入 游客模式播放
- 无需登录、无需扫码、无需输入账号
- 不要在弹窗上浪费时间： 遇到任何要求登录/注册/下载APP的弹窗，全部直接关闭
- 重定向注意： 部分分享链接会经过多次跳转，以浏览器地址栏最终 URL 为准
故障排除
| 问题 | 解决 |
|---|
| API 401 | 重新登录 EasyClaw |
| 抖音下载失败 | 脚本自动多方案重试；仍失败则在浏览器中关闭登录弹窗→点击播放→复制当前页URL重跑 |
| 登录弹窗遮挡页面 | 关闭弹窗（点×或点蒙层），再点击视频区域即可游客播放 |
| 下载 403 | yt-dlp 添加 cookies 或换 IP |
| 中文 PDF 乱码 | macOS 自带 STHeiti 无需配置；Linux 安装 fonts-noto-cjk |
| pandoc 未找到 | 可选安装（macOS: brew install pandoc mactex；Win: winget install pandoc MiKTeX.MiKTeX）；未安装时自动降级 fpdf2 |
