youtube-full

核心用法

youtube-full 是一套完整的 YouTube 数据获取工具，通过 TranscriptAPI.com 提供六大核心能力：

1. 视频转录（Transcript） — 提取任意 YouTube 视频的字幕文本，支持 JSON/Text 格式、时间戳嵌入及元数据返回，单次调用消耗 1 credit。

2. 全局搜索（Search） — 按关键词检索视频或频道，支持分页（1-50 条），单次调用 1 credit。

3. 频道解析（Resolve） — 通过 @handle 获取标准 channel_id，完全免费。

4. 频道内容浏览 — 获取最新 15 条视频（免费）或完整视频列表（分页，1 credit/页），支持频道内关键词搜索。

5. 播放列表管理 — 提取播放列表全部视频，支持 PL/UU/LL/FL/OL 等格式 ID，分页计费。

显著优点

• 功能集成度高：单一 skill 覆盖转录、搜索、频道、播放列表四大场景，无需多工具切换
• 免费层级友好：注册即送 100 credits，频道解析和最新视频查询零成本
• 定价透明：大部分操作 1 credit/次，无隐藏费用
• 格式灵活：转录支持带时间戳的纯文本或结构化 JSON，便于下游 NLP 处理

潜在局限

• 依赖第三方服务：数据源自 TranscriptAPI.com，非 YouTube 官方 API，存在服务稳定性风险
• 字幕可用性：404 错误常见于无字幕或字幕禁用视频
• 速率限制：免费版 300 req/min，大规模抓取需升级付费计划
• 地域内容限制：部分区域受限视频可能无法获取元数据

适合人群

• AI Agent 开发者：需要结构化 YouTube 数据作为 RAG 知识源
• 内容研究员：批量提取教育/技术类视频字幕进行分析
• 营销分析师：监控竞品频道更新，追踪热门内容趋势
• 播客/视频创作者：快速获取参考素材的完整文本稿

常规风险

• API 密钥泄露：TRANSCRIPT_API_KEY 需妥善保管，泄露可能导致 credits 被恶意消耗
• 服务终止风险：第三方服务若调整策略或停运，将影响依赖该 skill 的工作流
• 版权合规：转录内容受原视频版权约束，商业用途需评估法律风险
• 数据新鲜度：非实时同步，热门视频可能存在数分钟延迟

核心功能

youtube-full 是一个综合型 YouTube 数据获取工具，通过 TranscriptAPI.com 提供五大核心能力：

1. 字幕提取 — 支持带时间戳的 JSON 或纯文本格式，自动获取视频元数据
2. 内容搜索 — 视频/频道双模式搜索，支持自定义结果数量（1-50）
3. 频道管理 — 手柄解析（免费）、最新视频（免费）、全量视频分页、频道内搜索
4. 播放列表 — 支持 PL/UU/LL/FL/OL 等标准前缀的分页获取
5. 智能认证 — 内置 CLI 工具引导注册、验证、密钥存储全流程

显著优势

• 功能完整：单 Skill 覆盖 YouTube 数据获取的 90%+ 场景，无需多个工具组合
• 成本控制：频道解析和最新视频免费，100 积分免费额度足够初期使用
• 格式灵活：字幕支持 JSON（结构化）和纯文本两种输出，适配不同下游处理
• 工作流友好：搜索→选取→转录的标准研究流程，以及频道监控场景均有示例
• 安全架构：纯外部 API 调用模式，无本地复杂依赖，代码经审计无恶意行为

局限与风险

| 维度 | 说明 |

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

| **服务依赖** | 100% 依赖 TranscriptAPI.com，服务中断则功能全失；数据隐私受第三方条款约束 |

| **成本累积** | 分页获取大频道全部视频或长播放列表时，积分消耗可能超出预期 |

| **配置侵入** | `save-key` 命令会修改 shell 配置文件（~/.zshenv、~/.bashrc 等）和 agent 配置，用户需知情同意 |

| **来源可信度** | T3 级个人开发者维护，商业服务持续性需自行评估 |

| **速率限制** | 免费档 300 req/min，大规模抓取需升级付费方案 |

适用人群

• 研究人员：需要批量获取视频字幕进行 NLP 分析、主题建模
• 内容创作者：监控竞品频道、追踪行业趋势
• 自动化工作流：构建 YouTube 内容监控、摘要生成、多语言翻译 pipeline
• 教育机构：制作带时间戳的学习资料索引

常规风险

• API Key 以明文形式存储于本地配置文件，共享环境存在泄露风险
• 字幕可用性取决于视频上传者是否开启，404 错误常见于无字幕内容
• 第三方服务定价策略变更可能影响长期使用成本