yt

核心功能与用法

yt skill 是一款专注于 YouTube 内容获取的实用工具，通过 TranscriptAPI.com 提供三种核心能力：

1. 视频字幕提取（1 credit）：输入视频 URL 或 ID，可获取完整字幕文本，支持时间戳标记和元数据返回
2. 内容搜索（1 credit）：按关键词检索视频或频道，支持结果数量限制（1-50条）
3. 频道最新内容（免费）：查询任意频道的最近 15 个视频，包含精确播放量和发布日期

显著优点

• 开箱即用：仅需单一 API key，无需复杂运行时依赖
• 成本友好：免费 tier 含 100 credits，频道查询完全免费
• 格式灵活：支持 @handle、完整 URL、UC...ID 等多种输入格式
• 合规访问：通过规范 User-Agent 头绕过 Cloudflare 防护

局限性与风险

• 字幕依赖：仅提取官方字幕，无字幕视频返回 404
• 额度消耗：高频使用需付费（transcriptapi.com/billing）
• 外部依赖：完全依赖 TranscriptAPI 服务可用性
• 无上传功能：仅限内容检索，不支持视频上传或账户管理

适合人群

内容创作者、研究人员、AI 训练数据收集者、需要批量处理 YouTube 视频信息的自动化工作流用户。

常规风险提示

• 需妥善保管 API key，避免泄露导致额度盗用
• 尊重 YouTube 内容版权，商用需确认授权
• 注意 Cloudflare 403 错误，必须配置正确 User-Agent

核心用法

yt 是一个纯文档型 Skill，用于 YouTube 内容查询。它不提供本地可执行代码，而是通过标准化的 curl 示例，指导 AI Agent 调用 TranscriptAPI.com 服务完成以下操作：

1. 视频字幕获取 (/youtube/transcript)：提取指定 YouTube 视频的字幕文本，支持带时间戳格式
2. 内容搜索 (/youtube/search)：按关键词搜索视频或频道，支持类型过滤与结果数量限制
3. 频道最新视频 (/youtube/channel/latest)：获取指定频道的最近 15 条视频（免费调用）
4. Handle 解析 (/youtube/channel/resolve)：将 @handle 转换为标准 UC... 频道 ID（免费调用）

使用需配置 TRANSCRIPT_API_KEY 环境变量（Bearer Token 认证），并必须设置 User-Agent 请求头以避免 Cloudflare 拦截。

显著优点

• 零依赖零风险：纯 Markdown 文档，无本地代码、无依赖包、无危险函数（eval/exec/system），从根本上杜绝代码执行风险
• 透明可审计：所有 API 调用指向单一可信服务商（transcriptapi.com），HTTPS 加密传输，请求参数完全可见
• 成本可控：免费 tier 提供 100 积分，字幕与搜索仅消耗 1 积分/次，频道查询和 Handle 解析完全免费
• 即开即用：无需复杂部署，配置 API Key 后即可通过标准 HTTP 请求使用

潜在缺点与局限性

• 外部服务依赖：完全依赖 TranscriptAPI.com 的可用性与定价策略，若服务中断或政策变更将直接影响功能
• T3 来源可信度：维护者为个人开发者（therohitdas），非企业级背书，长期维护稳定性存在不确定性
• 功能边界明确：仅支持查询类操作，不支持视频上传、账号管理、评论交互等 YouTube 原生功能
• 字幕覆盖限制：部分视频无字幕或字幕被创作者禁用时将返回 404

适合人群

• 需要快速提取 YouTube 视频内容的 AI Agent 开发者
• researchers、内容创作者、知识管理用户，需批量获取视频字幕或频道信息
• 对代码安全性要求极高、偏好「无本地执行」架构的保守型用户

常规风险

• API Key 管理：TRANSCRIPT_API_KEY 需用户自行保管，泄露可能导致积分被盗用
• 网络可用性：依赖国际网络访问 transcriptapi.com，部分地区可能需要代理
• 隐私合规：搜索关键词与视频 URL 会传输至第三方服务，虽经 GDPR 合规评估，但敏感场景仍需谨慎
• 服务持续性：个人维护项目，建议关注服务状态并准备替代方案