SuperAPI AI 工具集

youtube-transcript

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:该技能用于获取 YouTube 视频的字幕文本和可用字幕语言,基于独立 Python CLI 工具实现,不依赖 MCP 服务器。它只负责数据检索,摘要与分析需由 AI 完成。

主要能力:获取指定视频的完整字幕文本;列出可用字幕语言;区分自动生成与人工字幕。字幕条目通常包含 text、start、duration 字段,语言信息包含 language_code、language、is_generated。

使用方式:先安装依赖 python3 -m pip install youtube-transcript-api。获取带时间戳字幕:python3 youtube_transcript_tool.py --mode transcript --url "https://www.youtube.com/watch?v=VIDEO_ID" --lang en --include-timestamps true。获取纯文本字幕(推荐用于摘要):python3 youtube_transcript_tool.py --mode transcript --url "VIDEO_ID" --include-timestamps false。列出字幕语言:python3 youtube_transcript_tool.py --mode languages --url "https://youtu.be/VIDEO_ID"。默认输出 JSON(--json true),成功返回 ok: true 及 mode、video_id 和对应数据;失败返回 ok: false 及 error.code、error.message、error.hint。可用 --json false 输出可读文本。

适用场景:需要完整字幕文本、字幕语言列表,或为 AI 摘要、要点提取、引用整理提供输入。长视频建议关闭时间戳以节省上下文;有子代理时可在子代理中完成检索与摘要。

限制:仅做字幕检索,不做摘要分析;可能遇到 InvalidVideoId、TranscriptsDisabled、NoTranscriptFound、VideoUnavailable、TooManyRequests、CouldNotRetrieveTranscript 等异常,需按提示处理,如换语言、稍后重试或安装依赖。默认 --lang en、--include-timestamps true、--json true。