mcpField
S
subtitles

subtitles

github.com/zeropointrepo生产力1.1k817 次安装5 周前更新
代码仓库

关于 subtitles

subtitles 是通过 TranscriptAPI.com 获取 YouTube 字幕的 Agent 技能，支持便于阅读或翻译的纯文本，以及包含时间信息的结构化分段。

主要功能

  1. 01通过网址或视频 ID 获取字幕
  2. 02返回带时间信息的结构化分段
  3. 03省略时间戳以生成纯文本
  4. 04附带视频元数据

适用场景

  1. 01阅读不含时间戳的字幕文本
  2. 02准备字幕文本用于翻译
  3. 03观看视频时跟读字幕分段
  4. 04利用字幕时间信息学习语言

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zeropointrepo/youtube-skills --skill subtitles

安装后在 Claude Code 中输入/subtitles确认已加载。

附带文件references/auth-setup.mdreferences/curl-examples.md

详细介绍

字幕

通过 TranscriptAPI.com 获取 YouTube 视频字幕。

设置

如果未设置 $TRANSCRIPT_API_KEY，请阅读 references/auth-setup.md 并按照其中的说明获取和保存密钥。

必需的请求头

每个请求都需要两个请求头：

  • Authorization： Bearer $TRANSCRIPT_API_KEY
  • User-Agent： 如果已知，请填写 Agent 的名称和版本（例如 HermesAgent/0.11.0、ClaudeCode/1.0）。版本可选，仅填写 Agent 名称也可以。请勿省略此请求头，也不要发送默认的空值，否则 Cloudflare 会返回 403（错误代码 1010）并阻止请求。

GET /api/v2/youtube/transcript

GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=false&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
参数值用例
video_urlYouTube URL 或视频 ID必填
formatjson、textjson 用于获取带时间信息的同步字幕
include_timestamptrue、falsefalse 用于获取适合阅读和翻译的纯文本
send_metadatatrue、false包含标题、频道和描述

用于语言学习 — 不带时间戳的纯文本：

GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=text&include_timestamp=false
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

用于翻译 — 结构化片段：

GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=json&include_timestamp=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

响应（format=json）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [
    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 }
  ]
}

响应（format=text、include_timestamp=false）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "We're no strangers to love\nYou know the rules and so do I..."
}

提示

  • 许多视频都有多种语言的自动生成字幕。
  • 使用 format=json 获取每行字幕的时间信息（非常适合同步阅读）。
  • 使用 include_timestamp=false 获取适用于翻译应用的纯文本。

错误

代码含义操作
401API 密钥无效检查密钥
402没有额度transcriptapi.com/billing
403/1010Cloudflare 拦截添加或修正 User-Agent 请求头
404没有字幕没有可用字幕
408超时2 秒后重试一次

每个请求消耗 1 个额度。免费层级：100 个额度，每分钟 300 个请求。

复制粘贴示例

本文件中的每个请求都提供了可直接运行的单行命令：references/curl-examples.md

评论

支持 Markdown