yt

核心用法

yt skill 是围绕 TranscriptAPI.com 构建的 YouTube 内容检索工具，支持四大核心场景：

1. 视频字幕提取 — 通过视频URL或ID获取完整转录文本，可选时间戳与元数据（1积分/次）
2. 智能搜索 — 按关键词检索视频或频道，支持结果数量控制（1-50条，1积分/次）
3. 频道最新动态 — 免费获取指定频道最近15条视频的观看量与发布时间（@handle/URL/UCID均可）
4. 频道ID解析 — 免费将@handle转换为标准UC...频道ID

所有请求需配置TRANSCRIPT_API_KEY环境变量（免费注册100积分），并强制携带Authorization与User-Agent双请求头。API采用RESTful设计，响应格式为JSON，错误码覆盖401（密钥无效）、402（余额不足）、403（Cloudflare拦截）、404（无字幕/资源不存在）、408（超时）。

显著优点

• 零门槛试用：100免费积分无需绑卡，足够完成50次字幕提取或搜索
• 格式友好：字幕支持纯文本/带时间戳输出，便于AI摘要或引用定位
• 频道监控免费：最新视频与ID解析不计费，适合追踪创作者动态
• 轻量依赖：纯HTTP调用，无需本地运行时或复杂认证流程
• 元数据完整：返回精确观看数、发布日期、频道信息等结构化数据

潜在局限

• 仅限公开内容：无法获取未公开/私密视频或需要登录的内容
• 字幕可用性依赖：404错误常见于无CC字幕、自动字幕关闭或地区限制的视频
• 积分消耗明确：高频使用需付费（搜索与字幕各1积分），无无限额度方案
• 无上传/账号管理：明确不支持视频上传、评论操作或播放列表编辑
• 第三方单点依赖：服务可用性完全取决于TranscriptAPI.com的稳定运营

适合人群

• 内容研究者：批量提取演讲、课程、播客字幕进行文本分析
• 媒体监测：追踪特定频道更新，替代手动刷新YouTube通知
• AI工作流：为RAG系统、摘要生成、问答机器人提供视频文本源
• 创作者分析：快速获取竞品频道最新发布与基础数据

常规风险

• API密钥泄露：Bearer Token若暴露可能导致积分被盗刷，建议仅配置在可信环境变量
• Cloudflare误拦截：User-Agent缺失或格式不规范会触发403/1010错误，需严格按文档配置
• 数据合规边界：提取的字幕内容仍需遵守原视频版权与平台ToS，商用需确认授权
• 服务持续性：第三方API存在调价、限流或停止运营风险，关键业务需有备选方案

使用建议

优先使用channel/latest免费端点监控频道更新，仅在需要深入内容时调用付费字幕接口；生产环境务必配置规范User-Agent并监控402余额告警。

核心用法

yt 是一款专注于 YouTube 内容解析的文档型 Skill，通过 TranscriptAPI 提供四大核心功能：

1. 字幕提取 (/transcript) — 获取视频完整字幕文本，支持带时间戳格式
2. 内容搜索 (/search) — 按关键词搜索视频或频道，支持类型过滤和结果限制
3. 频道追踪 (/channel/latest) — 获取指定频道最新15个视频（免费端点）
4. 账号解析 (/channel/resolve) — 将 @handle 转换为标准频道 ID（免费端点）

使用方式极为简洁：配置 TRANSCRIPT_API_KEY 环境变量后，通过标准 HTTP 请求调用 API。免费账户含 100 积分，搜索和字幕各消耗 1 积分，频道相关功能零成本。

---

显著优点

| 维度 | 优势 |

|------|------|

| **安全架构** | 纯 Markdown 文档型 Skill，零可执行代码，天然免疫注入攻击 |

| **来源可信** | T2 级可信来源，维护者 therohitdas，公开注册于 OpenClaw/Hermes 生态 |

| **隐私合规** | 符合 GDPR 数据最小化原则，无静默数据收集，用户自主掌控 API 密钥 |

| **传输安全** | 全链路 HTTPS/TLS 1.2+，Cloudflare 防护 |

| **成本友好** | 免费额度充足，核心功能（频道追踪）永久免费 |

| **生态兼容** | 支持任意 Agent 调用，仅需标准网络访问能力 |

---

潜在缺点与局限性

• 功能单一性：仅限于 YouTube 内容消费场景（读取、搜索、追踪），不支持上传、评论、账号管理 等操作
• 外部依赖：功能完全依赖 TranscriptAPI 服务可用性，无本地降级方案
• 配额限制：免费 100 积分用尽后需付费，高频调用场景需成本规划
• 网络约束：必须能够访问 transcriptapi.com，企业内网需白名单配置
• 密钥管理：用户需自行安全存储 API Key，无内置密钥托管机制

---

适合人群

• 需要快速获取 YouTube 视频字幕进行内容分析的研究者、记者
• 希望追踪特定频道更新的内容创作者、行业观察者
• 构建 YouTube 内容聚合、知识库整理的开发者
• 对隐私敏感、偏好自主控制 API 凭证的用户

---

常规风险

| 风险类别 | 说明 | 缓解措施 |

|----------|------|----------|

| 密钥泄露 | API Key 若硬编码或分享将导致账户盗用 | 使用环境变量或密钥管理系统，定期轮换 |

| 服务中断 | TranscriptAPI 故障将导致功能不可用 | 实现错误处理和重试，关注服务状态 |

| 配额耗尽 | 高频调用超出免费额度 | 优先使用免费端点，监控用量 |

| 网络拦截 | 企业防火墙可能阻断 API 请求 | 配置代理或申请白名单 |

> 安全等级 S：经 CLS-Certify 静态分析，无危险代码，无依赖漏洞，API 调用透明可控。