yt

通过 TranscriptAPI.com 快速查询 YouTube。

设置

如果未设置 $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 — 请查阅此文档获取最新参数和架构。

转录 — 1 积分

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

搜索 — 1 积分

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

频道最新视频 — 免费

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

返回最近 15 个视频及其精确播放次数和发布日期。接受 @handle、频道 URL 或 UC... ID。

解析句柄 — 免费

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

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

错误

免费套餐：100 积分。搜索和转录消耗 1 积分。频道最新视频和解析免费。