一站式 YouTube 视频转录、搜索与频道管理工具，基于 TranscriptAPI 提供带时间戳字幕提取、频道监控和播放列表解析。
说明：
## 核心用法
`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 服务条款及原视频版权约束，禁止大规模未经授权的再分发
会员专属
