YouTube API

通过 TranscriptAPI.com 访问 YouTube 数据——无需 Google API 配额。

设置

如果未设置 $TRANSCRIPTAPIKEY，请帮助用户创建账户（100 个免费积分，无需银行卡）：

第 1 步 — 注册： 询问用户的邮箱。

bash
node ./scripts/tapi-auth.js register --email USER_EMAIL

→ 验证码发送至邮箱。询问用户：请检查邮箱中的 6 位验证码。

第 2 步 — 验证： 用户提供验证码后：

bash
node ./scripts/tapi-auth.js verify --token TOKENFROMSTEP_1 --otp CODE

API 密钥已保存至 ~/.openclaw/openclaw.json。详情见下方文件写入。修改前会对现有文件进行备份。

手动选项：transcriptapi.com/signup → 控制台 → API 密钥。

文件写入

验证和保存密钥命令会将 API 密钥保存至 ~/.openclaw/openclaw.json（设置 skills.entries.transcriptapi.apiKey 和 enabled: true）。修改前会将现有文件备份至 ~/.openclaw/openclaw.json.bak。

要在代理之外的终端/命令行中使用 API 密钥，请手动添加到 shell 配置文件中：
export TRANSCRIPTAPIKEY=

API 参考

完整 OpenAPI 规范：transcriptapi.com/openapi.json — 查阅此文档获取最新参数和模式。

端点参考

所有端点：https://transcriptapi.com/api/v2/youtube/...

频道端点接受 channel — @handle、频道 URL 或 UC... ID。播放列表端点接受 playlist — 播放列表 URL 或 ID。

端点	方法	费用
/transcript?video_url=ID	GET	1
/search?q=QUERY&type=video

GET | 1 |
| /channel/resolve?input=@handle | GET | 免费 |
| /channel/latest?channel=@handle | GET | 免费 |
| /channel/videos?channel=@handle | GET | 1/页 |
| /channel/search?channel=@handle&q=Q | GET | 1 |
| /playlist/videos?playlist=PL_ID | GET | 1/页 |

快速示例

搜索视频：

bash
curl -s https://transcriptapi.com/api/v2/youtube/search\
?q=python+tutorial&type=video&limit=10 \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

获取字幕：

bash
curl -s https://transcriptapi.com/api/v2/youtube/transcript\
?videourl=dQw4w9WgXcQ&format=text&includetimestamp=true&send_metadata=true \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

解析频道句柄（免费）：

bash
curl -s https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

最新视频（免费）：

bash
curl -s https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

浏览频道上传内容（分页）：

bash
curl -s https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

使用响应中的续传令牌获取下一页

浏览播放列表（分页）：

bash
curl -s https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PLPLAYLISTID \
-H Authorization: Bearer $TRANSCRIPTAPIKEY

参数验证

字段	规则
channel	@handle、频道 URL 或 UC... ID
playlist

播放列表 URL 或 ID（PL/UU/LL/FL/OL 前缀） | | q（搜索） | 1-200 字符 | | limit | 1-50 | | continuation | 非空字符串 |

为何不使用 Google 的 API？

	Google YouTube Data API	TranscriptAPI
配额	10,000 单位/天（100 次搜索）	基于积分，无每日上限
设置

OAuth + API 密钥 + 项目 | 单一 API 密钥 | | 字幕 | 不可用 | 核心功能 | | 定价 | 超额 $0.0015/单位 | $5/1000 积分 |

错误

代码	含义	操作
401	API 密钥无效	检查密钥
402

积分不足 | transcriptapi.com/billing | | 404 | 未找到 | 资源不存在 | | 408 | 超时/可重试 | 等待 2 秒后重试一次 | | 422 | 验证错误 | 检查参数格式 | | 429 | 请求频率限制 | 等待，遵循 Retry-After |

免费套餐：100 积分，300 请求/分钟。入门版（$5/月）：1,000 积分。