YouTube 提文案

问题：视频文案落不了地

拿到 YouTube 视频的口播文案后，真正要做的事情往往是总结、翻译、改写、竞品分析或播客存档。但手动复制字幕、浏览器插件导出、音频转写都有几个反复出现的问题：字幕轨混杂，时间戳干扰阅读，中英文不一致，导出格式也不统一。目标其实很窄：输入链接，拿到结构化文案，能直接 Markdown 存档，也能导出 Excel 归档。

核心能力与流程

这个技能处理的是“从 YouTube 视频链接到可处理文案”这一段。输入支持完整 URL、https://youtu.be/... 短链和纯视频 ID，会自动识别。文字稿来自字幕轨，包括手动字幕和自动生成字幕（asr）。选轨优先级是 zh,en,asr：视频有中文轨时直接输出中文；没有中文轨时回退英文，并由脚本自动翻译为中文。默认输出不带时间戳，需要定位原片进度时加 --timestamp。

大致流程如下：

• 用 video_url 传入视频链接或视频 ID，这是必填位置参数。
• 脚本获取标题、频道等元数据，并按优先级选择字幕轨。
• 默认生成纯文案全文，终端展示标题、语言、片段数和总时长。
• Markdown 默认保存到 ~/Downloads/QoderYoutubeDigest/，文件名形如 {视频ID}_{时间戳}.md，包含视频信息头表和全文。
• 需要归档或分享时加 --excel，导出四列 .xlsx：标题、时长、视频链接、文案内容。
• 展示层固定使用表格呈现标题、时长、文案内容，非中文字幕默认已经翻译为中文。

中文优先，但翻译可控。 --language 只控制字幕选轨，--no-translate 才关闭自动翻译。这样既能让中文视频直接可用，也能保留英文原稿给后续改写。--json 输出原始响应，适合程序消费；--no-save、--output-dir、--no-metadata 则分别覆盖默认存档、输出目录和元数据获取行为。

适用边界与注意点

不是所有视频都能提取。文字稿必须来自字幕轨，完全无字幕且无自动生成字幕的视频无法处理，部分受限或私享视频也不支持。脚本会处理网络异常、状态码错误和空数据，采用递增延迟重试；遇到限频 3108 会自动等待 5 秒再试。使用时需要 RedFox API Key，可通过 REDFOX_API_KEY 环境变量或 --api-key 传入；Key 无效通常是 3106/3107，链接无效则返回 Invalid YouTube URL or video ID 且不扣积分，两者需要分开排查。

拿到文案后，适合继续交给 AI 做章节总结、翻译、改写、公众号排版或推送草稿。如果只是判断一个视频是否值得深看，先提取纯文案再决定，通常比直接看视频更快。整体上，这是一个围绕“字幕提取、中文可读、可存档可导出”的窄切口工具。