youtube-export

用途

youtube-export 用于将已经索引到本地语料库中的 yt-insights 视频转录导出为文件，支持 Markdown、纯文本和 VTT 三种格式，主要面向文章调研和来源存档场景。

主要能力

• 导出本地已存在的转录内容，支持 md、txt、vtt 三种格式。
• 通过只读 MCP 解析用户请求的视频。
• 返回精确的输出路径、video_id、语言、格式以及 source_sha256。
• 该工作流是确定性的，不调用 LLM，也不获取缺失素材。

使用方式

1. 通过只读 MCP 解析请求的视频。如果 MCP 不可用，且请求中未包含明确的 YouTube URL 或视频 ID，则向用户索取，而不是在 cwd 相对目录中搜索。除非能确定唯一一个已存在的视频，否则停止。
2. 使用用户请求的语言；否则省略 --lang。仅当 MCP 证据已显示多种语言，或导出命令返回明确的语言选项时，才向用户询问。
3. 运行命令：yt-insights export video VIDEO_OR_URL --format FORMAT --lang LANGUAGE --json；当转录语言明确时省略 --lang。支持的格式为 md、txt、vtt。
4. 从 JSON 结果中返回精确的输出路径、video_id、语言、格式和 source_sha256。

适用场景

• 为文章写作整理视频转录内容。
• 归档视频来源材料。

限制

• 只导出本地语料库中已存在的内容，不获取缺失的视频。
• 不编辑转录内容，不虚构 source hash。
• 除非用户明确授权 --force，否则不覆盖已有文件。
• 在命令成功执行前，不将输出路径视为证明。