mcpField
C
captions

captions

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

关于 captions

captions 是通过 TranscriptAPI.com 提取 YouTube 视频字幕的技能。它可返回结构化字幕片段或纯文本，并支持时间戳和视频元数据选项。

主要功能

  1. 01通过视频网址或 ID 提取字幕
  2. 02返回结构化 JSON 或纯文本
  3. 03包含时间戳和片段时长
  4. 04可选附带视频元数据

适用场景

  1. 01以文本形式阅读视频字幕
  2. 02将字幕片段与视频时间对应

安装

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

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

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

附带文件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=json&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
参数必需默认值可选值
video_url是—YouTube URL 或视频 ID
format否jsonjson（结构化），text（纯文本）
include_timestamp否truetrue、false
send_metadata否falsetrue、false

响应（format=json——最适合无障碍访问和时间分析）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [
    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
  ],
  "metadata": { "title": "...", "author_name": "...", "thumbnail_url": "..." }
}
  • start：视频开始后的秒数
  • duration：字幕显示时长

响应（format=text——便于阅读）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules..."
}

提示

  • 使用 format=json 获取可同步的字幕（用于无障碍工具和时间分析）。
  • 使用 format=text 和 include_timestamp=false，获得整洁易读的文本。
  • 大多数视频都提供自动生成的字幕；手动字幕 CC 的质量更高。

错误

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

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

可直接复制的示例

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

评论

支持 Markdown