核心用法
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 的工作流
- 版权合规:转录内容受原视频版权约束,商业用途需评估法律风险
- 数据新鲜度:非实时同步,热门视频可能存在数分钟延迟