yt

核心用法

yt 是一个基于 TranscriptAPI.com 的 YouTube 工具集，提供三项主要功能：

1. 字幕提取（1 credit）— 获取任意 YouTube 视频的字幕文本，支持时间戳和元数据
2. 视频搜索（1 credit）— 按关键词搜索视频或频道，支持分页
3. 频道最新内容（免费）— 获取指定频道最近 15 条视频，包含精确观看数和发布日期
4. Handle 解析（免费）— 将 @用户名 转换为标准频道 ID

显著优点

• 无需翻墙：通过 API 中转，国内网络可用
• 字幕即文本：直接获取可复制的纯文本字幕，省去手动下载
• 低成本起步：100 免费额度，频道查询不消耗额度
• 程序化友好：标准 REST API，curl 即用

局限与风险

• 依赖第三方服务：TranscriptAPI 并非官方 YouTube API，存在服务稳定性风险
• 无字幕视频失效：404 错误常见于无自动生成字幕或上传者关闭字幕的视频
• 额度消耗快：频繁提取长视频字幕会快速耗尽免费额度
• 注册流程繁琐：需邮箱验证 + OTP，自动化部署不够顺畅

适合人群

• 需要批量分析 YouTube 内容的研究者、内容创作者
• 希望快速了解视频主题而不观看完整内容的用户
• 构建视频摘要、问答系统的开发者

常规风险提醒

• 字幕版权归属原视频上传者，商业使用需注意合规
• API 密钥请妥善保管，避免泄露导致额度被盗用

核心用法

yt Skill 是一款轻量级 YouTube 实用工具，通过 TranscriptAPI.com 服务提供三项核心功能：

| 功能 | 调用方式 | 消耗 |

|:---|:---|:---|

| **视频转录** | 提供视频 URL 获取带时间戳的完整字幕 | 1 积分 |

| **内容搜索** | 按关键词搜索视频或频道 | 1 积分 |

| **频道最新** | 获取指定频道最近 15 个视频 | 免费 |

| **解析句柄** | 将 `@handle` 转换为频道 ID | 免费 |

配置流程

首次使用需完成三步注册：提供邮箱 → 接收并输入 6 位验证码 → 自动保存 API Key。系统会修改 shell 配置文件（~/.zshenv、~/.bashrc 等）和 Agent 配置以持久化密钥。

---

显著优点

• 极简依赖：零第三方 npm 包，仅使用 Node.js 内置模块，供应链攻击面极小
• 行为透明：所有网络请求定向至 transcriptapi.com 已知端点，无异常流量
• 权限最小化：API Key 机制符合最小权限原则，用户明确授权
• 免费入门：100 积分免费额度，足够体验核心功能

---

潜在缺点与局限

| 类别 | 说明 |

|:---|:---|

| **服务依赖** | 功能完全依赖 TranscriptAPI 商业服务，存在可用性和定价变更风险 |

| **付费模式** | 转录和搜索消耗积分，高频使用需付费（具体费率未公开） |

| **无本地回退** | 不支持 YouTube 官方 API 直连，无法绕过第三方服务 |

| **配置侵入性** | `save-key` 命令自动修改用户 shell 和 Agent 配置文件，需人工复核 |

---

适合人群

• 内容创作者/研究员：需要批量获取视频字幕进行文本分析
• 信息整合者：快速了解视频内容而不完整观看
• 频道追踪者：监控特定创作者的最新发布

不适合：对数据隐私极度敏感、需要 100% 服务可用性保障、或不愿使用第三方商业 API 的用户。

---

常规风险

1. 配置文件变更：Skill 会写入 ~/.zshenv、~/.profile、~/.bashrc 及 ~/.clawdbot/moltbot.json，建议使用后核查文件内容
2. API Key 存储：密钥以明文形式存储于 ~/.transcriptapi（权限 600），需确保文件系统安全
3. 第三方数据处理：视频 URL、搜索关键词等元数据会发送至 transcriptapi.com，需接受其隐私政策
4. 维护不确定性：T3 来源（个人开发者），长期更新支持存疑