Yt

# yt

通过 [TranscriptAPI.com](https://transcriptapi.com) 进行快速 YouTube 查询。

## 设置

如果未设置 `$TRANSCRIPT_API_KEY`，请协助用户创建账户（100 个免费积分，无需信用卡）：

**第 1 步 — 注册：** 询问用户的电子邮件。

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

→ OTP 已发送至电子邮件。询问用户：_"请检查您的电子邮件以获取 6 位验证码。"_

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

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

> API 密钥已保存至 `~/.openclaw/openclaw.json`。详情请参阅下方的 **文件写入**。修改前会备份现有文件。

手动选项：[transcriptapi.com/signup](https://transcriptapi.com/signup) → 仪表盘 (Dashboard) → API Keys。

## 文件写入

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

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

## API 参考

完整的 OpenAPI 规范：[transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — 请查阅此文以获取最新的参数和架构。

## 字幕记录 — 1 积分

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

## 搜索 — 1 积分

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

| 参数 | 默认值 | 取值 | | ------- | ------- | ---------------------- | | `q` | — | 1-200 个字符（必填） | | `type` | `video` | `video`、`channel` | | `limit` | `20` | 1-50 |

## 频道最新内容 — 免费

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

返回包含确切观看次数和发布日期的最近 15 个视频。接受 `@handle`、频道 URL 或 `UC...` ID。

## 解析 Handle — 免费

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

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

## 错误

| 代码 | 操作 | | ---- | -------------------------------------- | | 402 | 无积分 — transcriptapi.com/billing | | 404 | 未找到 / 无字幕 | | 408 | 超时 — 重试一次 |

免费套餐：100 个积分。搜索和字幕记录消耗 1 个积分。频道最新内容和解析是免费的。