mcpField
T
transcript

transcript

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

关于 transcript

transcript 是通过 TranscriptAPI.com 获取 YouTube 视频字幕的 Agent 技能。它可返回带时间戳的分段或纯文本，并可附带视频元数据。

主要功能

  1. 01通过网址或视频 ID 获取字幕
  2. 02选择文本或 JSON 输出
  3. 03添加或省略时间戳
  4. 04附带视频元数据

适用场景

  1. 01根据字幕总结视频
  2. 02获取特定引文的时间戳
  3. 03准备便于翻译的纯文本
  4. 04分析字幕内容

安装

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

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

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

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

详细介绍

Transcript

通过 TranscriptAPI.com 获取视频转录文本。

设置

如果未设置 $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=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
参数必填默认值可选值
video_url是—YouTube URL 或 11 位视频 ID
format否jsonjson、text
include_timestamp否truetrue、false
send_metadata否falsetrue、false

支持：完整 URL（youtube.com/watch?v=ID）、短 URL（youtu.be/ID）、Shorts（youtube.com/shorts/ID）或纯视频 ID。

默认值： 除非用户另有指定，否则始终使用 format=text&include_timestamp=true&send_metadata=true。

响应（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": "Rick Astley - Never Gonna Give You Up",
    "author_name": "Rick Astley",
    "author_url": "https://www.youtube.com/@RickAstley",
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  }
}

响应（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...",
  "metadata": {...}
}

错误

代码含义操作
401API 密钥无效检查密钥或重新设置
402无可用额度前往 transcriptapi.com/billing 充值
403/1010被 Cloudflare 拦截添加或修正 User-Agent 请求头
404无转录文本视频可能未启用字幕
408请求超时2 秒后重试一次
429请求频率受限等待后重试

提示

  • 对于较长的视频，请先总结要点，并根据请求提供完整转录文本。
  • 引用特定时刻时，如需精确时间戳，请使用 format=json。
  • 如需适合翻译或分析的纯文本，请使用 include_timestamp=false。
  • 每次成功请求消耗 1 个额度。错误不会消耗额度。
  • 免费套餐：100 个额度，每分钟 300 次请求。

可直接复制的示例

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

评论

支持 Markdown