用途:从 YouTube 视频中提取字幕与元数据,生成结构化概念分析,包括关键想法、论点、技术术语、可执行要点和多级摘要,无需 API key 或 MCP 服务器。
主要能力:核心脚本 scripts/fetch_transcript.py 负责字幕与元数据抓取(可命令行或作为模块导入);scripts/analyze_video.py 作为编排器完成抓取到导出脚手架;scripts/utils.py 处理 URL 解析、时间戳格式化与字幕分块。附 references/analysis-patterns.md 提供不同视频类型的提示模式,assets/output-template.md 为最终输出的 Markdown 模板。支持标准 watch、短链 youtu.be、Shorts、embed、live、带参数、纯 ID、移动端和 music 等多种 URL 格式。
使用方式:先安装依赖 uv pip install youtube-transcript-api yt-dlp -q,或用 uv run --with youtube-transcript-api --no-project python scripts/fetch_transcript.py "URL"。提取字幕运行 python fetch_transcript.py "YOUTUBE_URL" --lang en,输出含时间戳分段和合并文本的 JSON;也可 from fetch_transcript import fetch_video 导入使用。元数据由 yt-dlp --dump-json 自动获取,含标题、频道、时长、上传日期、描述、观看数与标签。分析深度可选 quick、standard、deep,视频类型可选 auto、lecture、tutorial、interview、podcast、tech-talk、panel。导出命令示例:python analyze_video.py "YOUTUBE_URL" --output ./analysis.md --depth standard --type auto,支持 --json 输出原始 JSON。
限制:仅基于字幕,不做视觉分析,幻灯片、图表、屏幕代码与演示不被捕获;自动字幕可能存在术语、专有名词与非英语口音错误;音乐视频歌词可能不可用;进行中的直播字幕可能不完整;请求过多可能触发临时封锁;英语效果最佳;字幕通常不标注说话人,需根据上下文推断。缺失事实(如收费、价格)暂未提供。