关于 yt
yt 是通过 TranscriptAPI.com 快速查询 YouTube 的技能,面向需要搜索视频、获取字幕稿或查看频道最新视频的 Agent。
主要功能
- 01搜索视频或频道
- 02获取视频字幕稿
- 03查看频道最新 15 个视频
- 04免费解析频道 ID
适用场景
- 01快速查找 YouTube 视频
- 02读取视频字幕内容
- 03查看频道最新视频及播放量
- 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 个字符(必填) |
type | video | video、channel |
limit | 20 | 1-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。
错误
| 代码 | 含义 | 处理方式 |
|---|---|---|
| 401 | API 密钥无效 | 检查密钥 |
| 402 | 无可用额度 | transcriptapi.com/billing |
| 403/1010 | Cloudflare 拦截 | 添加或修正 User-Agent 请求头 |
| 404 | 未找到 | 没有字幕或资源不存在 |
| 408 | 超时 | 重试一次 |
免费套餐:100 个额度。搜索和字幕各消耗 1 个额度。频道最新视频和解析功能免费。
可直接复制的示例
本文件中的每个请求都提供了可直接运行的单行命令:references/curl-examples.md
评论
支持 Markdown