mcpField
Y
yt

yt

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

关于 yt

yt 是通过 TranscriptAPI.com 快速查询 YouTube 的技能,面向需要搜索视频、获取字幕稿或查看频道最新视频的 Agent。

主要功能

  1. 01搜索视频或频道
  2. 02获取视频字幕稿
  3. 03查看频道最新 15 个视频
  4. 04免费解析频道 ID

适用场景

  1. 01快速查找 YouTube 视频
  2. 02读取视频字幕内容
  3. 03查看频道最新视频及播放量
  4. 04将频道句柄转换为频道 ID

安装

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

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

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

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

详细介绍

yt

通过 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)并阻止请求。

API 参考

完整的 OpenAPI 规范:transcriptapi.com/openapi.json——请参阅此规范以了解最新的参数和架构。

字幕 — 1 个额度

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

搜索 — 1 个额度

GET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
参数默认值取值
q—1-200 个字符(必填)
typevideovideo、channel
limit201-50

频道最新视频 — 免费

GET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

返回最新的 15 个视频,并提供准确的观看次数和发布日期。接受 @handle、频道 URL 或 UC... ID。

解析 handle — 免费

GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

用于将 @handle 转换为 UC... 频道 ID。

错误

代码含义处理方式
401API 密钥无效检查密钥
402无可用额度transcriptapi.com/billing
403/1010Cloudflare 拦截添加或修正 User-Agent 请求头
404未找到没有字幕或资源不存在
408超时重试一次

免费套餐:100 个额度。搜索和字幕各消耗 1 个额度。频道最新视频和解析功能免费。

可直接复制的示例

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

评论

支持 Markdown