用途:从 YouTube 视频中提取字幕和文字稿,适用于视频转文字、字幕提取、获取视频说明文字等需求。
主要能力:提供三种提取方式。首选命令行工具 yt-dlp,快速可靠;当命令行失败时,回退到 Chrome 浏览器自动化;也可通过 youtube-transcript-api 进行 Python 编程访问。支持手动字幕与自动生成字幕,可指定语言,输出 VTT、SRT、TXT 等格式。
使用方式:yt-dlp 基本命令为 yt-dlp --write-auto-sub --write-sub --sub-lang en --skip-download -o "%(title)s.%(ext)s" "VIDEO_URL"。常用参数包括 --write-sub(下载手动字幕)、--write-auto-sub(下载自动字幕)、--sub-lang LANG(指定语言,如 en、zh-Hans)、--skip-download(不下载视频)、--cookies-from-browser chrome(对受限视频使用浏览器 Cookie)。浏览器回退流程为:打开视频页、展开说明、点击 Show transcript、从 DOM 提取文本,选择器包括 ytd-transcript-segment-renderer、.segment-timestamp、.segment-text。将 VTT 转为纯文本可用:sed '/^[0-9]/d; /^$/d; /WEBVTT/d; /-->/d' video.vtt > video.txt。
语言代码:英语 en、简体中文 zh-Hans、繁体中文 zh-Hant、西班牙语 es,多语言可写 en,es,zh-Hans。
限制与常见问题:需要登录时添加 --cookies-from-browser chrome;找不到字幕说明视频无可用字幕;年龄限制视频需使用已登录浏览器的 Cookie。并非所有视频都有字幕,建议优先尝试手动字幕(质量高于自动生成),并检查多语言字幕。
适用场景:视频内容整理、字幕文件生成、视频编辑与媒体播放、批量视频转文字等。