核心用法
youtube-full 是基于 TranscriptAPI.com 的综合性 YouTube 数据获取工具，为 AI Agent 提供完整的 YouTube 内容访问能力。核心功能涵盖五大模块：
1. 字幕提取 — 支持按视频 URL 或 ID 获取完整字幕，可选 JSON（带时间戳）或纯文本格式，同时返回视频元数据（标题、作者等）
2. 智能搜索 — 支持视频与频道双类型搜索，自定义返回数量（1-50条）
3. 频道管理 — 提供 handle 解析（免费）、最新15条视频（免费）、全量视频分页获取、频道内搜索等功能
4. Playlist 处理 — 支持标准 playlist ID 格式（PL/UU/LL/FL/OL 前缀）的分页视频列表获取
5. API 密钥管理 — 内置自动化脚本辅助用户完成注册、验证、密钥保存全流程
典型工作流包括「搜索→选视频→取字幕」的研究模式，以及「解析频道→获取最新→取字幕」的监控模式。
显著优点
- 功能全面：单 skill 覆盖 YouTube 核心数据需求，避免多工具切换
- 成本透明：按 credits 计费，resolve 和 latest 端点完全免费
- 格式灵活：字幕支持 JSON（结构化）与 text（简洁）双模式
- 分页友好：channel/videos 和 playlist 均支持 continuation token 翻页
- 开发体验好：详细的参数验证规则、错误码对照表、curl 示例完整
潜在局限
- 外部依赖：完全依赖 TranscriptAPI 服务可用性，非官方 YouTube API
- 信用门槛：免费仅100 credits，大规模使用需付费订阅
- 速率限制：300 req/min 上限，高频场景需额外处理
- 字幕覆盖：依赖视频本身是否有字幕，404 时需人工处理
- 无写权限：纯数据获取工具，不支持上传、评论、点赞等互动操作
适合人群
- 需要批量获取 YouTube 字幕的研究者与内容分析师
- 构建频道监控、竞品分析的自动化工作流开发者
- 希望规避官方 API 复杂配额管理的个人开发者与小团队
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 服务中断 | TranscriptAPI 服务故障导致全功能不可用 | 关键业务保留官方 API 作为 fallback |
| 数据时效 | 非实时数据，存在分钟级延迟 | 对时效敏感场景增加校验逻辑 |
| 成本失控 | credits 消耗超出预期 | 启用 usage alerts，定期 audit 调用日志 |
| 合规风险 | 抓取数据需遵守 YouTube ToS 及版权法规 | 仅用于个人研究，避免商用分发 |
| 密钥泄露 | API key 硬编码或日志泄露 | 使用环境变量，启用 key rotation |