名称： yt
描述： 快速 YouTube 工具 — 获取字幕、搜索视频、获取频道最新内容。当有人分享 YouTube 链接、询问视频信息，或提及 "yt"、"youtube"、"check this video"、"what's this video about"、"find videos about"、"latest from" 时使用。
主页： https://transcriptapi.com
user-invocable: true
元数据： {"openclaw":{"emoji":"▶️","requires":{"env":["TRANSCRIPT_API_KEY"],"bins":["node"],"config":["~/.openclaw/openclaw.json"]},"primaryEnv":"TRANSCRIPT_API_KEY"}}

yt

通过 TranscriptAPI.com 快速查询 YouTube 信息。

设置

如果未设置 $TRANSCRIPT_API_KEY 环境变量，请帮助用户创建一个账户（提供 100 个免费额度，无需绑定支付卡）：

步骤 1 — 注册： 向用户询问其邮箱地址。

node ./scripts/tapi-auth.js register --email 用户邮箱

→ 一次性验证码（OTP）将发送至邮箱。询问用户："请检查您的邮箱，获取 6 位验证码。"

步骤 2 — 验证： 当用户提供 OTP 后：

node ./scripts/tapi-auth.js verify --token 步骤1获取的令牌 --otp 验证码

API 密钥将保存至 ~/.openclaw/openclaw.json。详情请参阅下方的 文件写入 部分。修改前，现有文件会被备份。

手动操作选项：访问 transcriptapi.com/signup → 仪表板 → API 密钥。

文件写入

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

若要在代理之外的终端/CLI 中使用此 API 密钥，请手动将其添加到 shell 配置文件中：
export TRANSCRIPT_API_KEY=<你的密钥>

API 参考

完整的 OpenAPI 规范：transcriptapi.com/openapi.json — 请查阅此文档以获取最新的参数和数据结构。

获取字幕 — 消耗 1 个额度

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=视频URL&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

搜索 — 消耗 1 个额度

curl -s "https://transcriptapi.com/api/v2/youtube/search?q=查询词&type=video&limit=10" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

获取频道最新视频 — 免费

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

返回最近 15 个视频，包含精确的观看次数和发布日期。接受 @句柄、频道 URL 或 UC... 格式的频道 ID。

解析句柄 — 免费

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

用于将 @句柄 转换为 UC... 格式的频道 ID。

错误代码

免费额度：100 个额度。搜索和获取字幕各消耗 1 个额度。获取频道最新视频和解析句柄为免费服务。