核心用法
youtube-full 是一个集成式 YouTube 数据工具，通过 TranscriptAPI.com 提供服务。主要功能包括：视频字幕提取（支持时间戳和纯文本格式）、YouTube 搜索（视频/频道）、频道管理（解析 handle、获取最新视频、分页获取全部视频、频道内搜索）以及播放列表遍历。所有操作通过统一的 REST API 完成，返回标准 JSON 格式。
显著优点
- 功能全面：单一 skill 覆盖字幕、搜索、频道、播放列表四大场景，无需切换多个工具
- 成本透明：采用积分制计费，基础功能（频道解析、最新视频）免费，其他操作 1 积分/次，新用户赠送 100 积分
- 格式灵活：字幕支持 JSON（带时间戳）和纯文本两种输出，满足不同下游处理需求
- 标识符兼容：支持多种输入格式（URL、@handle、ID），自动解析无需手动转换
- 分页友好：频道视频和播放列表支持 continuation token 分页，可处理大规模数据集
潜在缺点与局限性
- 第三方依赖：核心服务依赖 TranscriptAPI.com，若服务商稳定性或政策变化将直接影响可用性
- 付费门槛：免费额度有限（100 积分），重度使用需订阅（$5/月 1000 积分），无永久免费层
- 无官方背书：非 Google/YouTube 官方 API，数据准确性和服务持续性无官方保障
- 地区与版权限制：部分视频因地区限制或无字幕而无法提取，错误码 404 场景较多
- 速率限制：免费层 300 请求/分钟，高并发场景可能受限
适合人群
- 研究人员：需要批量获取 YouTube 视频字幕进行 NLP 分析或内容研究
- 内容创作者：监控竞品频道、分析热门话题趋势
- 数据分析师：构建 YouTube 内容数据集，支持播放列表归档
- 自动化工作流开发者：通过脚本实现频道监控、新视频自动转录等场景
常规风险
- API 密钥安全：需配置
TRANSCRIPT_API_KEY，若泄露可能导致积分被盗用，建议配合环境变量管理 - 服务连续性风险：第三方聚合服务存在合规风险，历史上类似 YouTube 转录服务曾因 ToS 问题被限制
- 数据隐私：上传或处理的视频 URL 可能被服务商记录，敏感内容需谨慎
- 误用风险：大规模爬取可能触发 YouTube 或服务商的反滥用机制，导致账号受限