youtube-transcript

youtube-transcript

热门

从YouTube视频中提取转录文本。当用户要求获取YouTube视频的转录、字幕或隐藏式字幕,并提供YouTube网址(youtube.com/watch?v=、youtu.be/等格式)时使用。支持带或不带时间戳的输出。

279Star
25Fork
更新于 2026/4/25
SKILL.md
readonly只读
name
youtube-transcript
description

从YouTube视频中提取转录文本。当用户要求获取YouTube视频的转录、字幕或隐藏式字幕,并提供YouTube网址(youtube.com/watch?v=、youtu.be/等格式)时使用。支持带或不带时间戳的输出。

YouTube 转录

使用 youtube-transcript-api 从 YouTube 视频中提取转录文本。

使用方法

使用 YouTube 网址或视频 ID 运行脚本:

uv run scripts/get_transcript.py "VIDEO_URL_OR_ID"

带时间戳:

uv run scripts/get_transcript.py "VIDEO_URL_OR_ID" --timestamps

默认设置

  • 不带时间戳(默认):纯文本,每个字幕片段一行
  • 带时间戳[MM:SS] text 格式(较长视频使用 [HH:MM:SS]

支持的网址格式

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://youtube.com/embed/VIDEO_ID
  • 原始视频 ID(11个字符)

输出

  • 重要:你绝不能修改返回的转录文本
  • 如果转录文本不带时间戳,你应该对其进行整理,使其按完整段落排列,并且行不会在句子中间断开。
  • 如果要求将转录文本保存到特定文件,则保存到指定文件。
  • 如果未指定输出文件,则使用 YouTube 视频 ID 并添加 -transcript.txt 后缀。

备注

  • 获取自动生成或手动添加的字幕(以可用的为准)
  • 要求视频已启用字幕
  • 如果手动字幕不可用,则回退到自动生成的字幕