用途:从 YouTube 视频中提取字幕转写文本,适用于用户提供 YouTube URL 或视频 ID 并索取转写、字幕、说明文字的场景。
主要能力:通过 youtube-transcript-api 获取字幕,优先使用自动生成或手动添加的可用字幕;手动字幕不可用时回退到自动生成字幕。默认输出纯文本,每个字幕片段一行;加 --timestamps 后输出 [MM:SS] 文本格式,较长视频为 [HH:MM:SS]。支持多种 URL 形式:https://www.youtube.com/watch?v=VIDEO_ID、https://youtu.be/VIDEO_ID、https://youtube.com/embed/VIDEO_ID,以及 11 位原始视频 ID。
使用方式:用 uv 运行脚本,传入视频 URL 或 ID:uv run scripts/get_transcript.py "VIDEO_URL_OR_ID";需要时间戳时加参数:uv run scripts/get_transcript.py "VIDEO_URL_OR_ID" --timestamps。
输出处理:不得修改返回的转写内容。若为无时间戳版本,可整理为完整段落,避免句子在行中间断开。若用户指定保存文件,则保存到指定文件;未指定时,使用视频 ID 加 -transcript.txt 后缀命名。
限制:要求视频已启用字幕;若没有可用字幕则无法提取。具体安装、依赖版本及完整参数暂未提供。