核心用法
youtube-full 是一款围绕 TranscriptAPI 构建的完整 YouTube 工具集，通过单一 API 密钥实现视频转录、搜索、频道管理和播放列表解析四大核心能力：
1. 转录提取 — 支持任意 YouTube 视频链接或 11 位视频 ID，可获取带时间戳的字幕文本（JSON/Text 格式），同时返回视频元数据（标题、作者、频道链接）。单次调用消耗 1 credit，是内容摘要、引用提取、翻译准备的核心入口。
2. 智能搜索 — 支持视频/频道双模式搜索，Query 长度 1-200 字符，结果数量 1-50 可调。适用于主题研究、教程发现、专家讲座定位等场景。
3. 频道管理 — 提供 handle 解析（免费）、最新 15 个视频获取（免费）、全量视频翻页浏览（1 credit/页）、以及频道内搜索（1 credit）四层能力。支持 @handle、频道 URL 或 UC... ID 三种输入格式，无需手动转换。
4. 播放列表解析 — 支持标准播放列表（PL）及系统列表（UU/LL/FL/OL）的分页获取，单次 1 credit/页，返回完整视频列表及续页令牌。
显著优点
- 零基础设施：纯 HTTP API 调用，无需本地 FFmpeg、yt-dlp 或浏览器环境
- 成本透明：免费 tier 100 credits/月，付费 $5/月获 1,000 credits，按需阶梯计费
- 输入友好：直接识别
@handle、短链接、完整 URL 等多种格式，减少前置处理 - 工作流完备：从搜索发现 → 转录提取 → 批量监控形成闭环，适合研究自动化
潜在局限
- 依赖第三方服务：TranscriptAPI 的稳定性与数据新鲜度直接决定技能可用性
- 字幕依赖：无人工/自动字幕的视频无法转录（返回 404）
- 无上传/账户功能：仅限内容消费端，不支持视频上传、评论管理、播放列表编辑
- 速率限制：免费档 300 req/min，大规模批量处理需升级或配合重试逻辑
适合人群
研究人员、内容创作者、媒体分析师、教育工作者、播客制作团队，以及任何需要结构化处理 YouTube 视频信息的自动化工作流用户。
常规风险
- API 密钥泄露：
TRANSCRIPT_API_KEY需妥善保管，避免硬编码或日志泄露 - Cloudflare 拦截：未设置或格式错误的
User-Agent将导致 403/1010 错误 - credits 耗尽：402 错误时需及时充值，避免任务中断
- 版权合规：转录内容仍需遵守 YouTube 服务条款及原视频版权约束，禁止大规模未经授权的再分发