核心用法
youtube-apify-transcript 是一款专为云服务器环境设计的YouTube字幕获取工具。核心痛点在于YouTube会主动屏蔽AWS、GCP、Hetzner等云服务商的IP地址，导致常规爬虫脚本失效。该工具通过APIFY平台调用住宅代理网络，绕过YouTube的反爬虫机制，实现稳定可靠的字幕抓取。
基础用法极为简单：安装后执行 python3 scripts/fetch_transcript.py "视频URL" 即可获取纯文本字幕。支持标准YouTube链接和短链接（youtu.be）两种格式。通过 --json 参数可输出带时间戳的结构化数据，便于后续音视频同步处理。--lang 参数允许指定优先语言，对多语言视频尤为实用。
智能缓存系统是该工具的最大亮点。首次请求消耗APIFY额度（$0.007/视频），结果自动存入本地 .cache/ 目录。重复请求同一视频时直接读取缓存，成本降为$0。配合 --batch 批量模式，可一次性处理URL列表，自动区分新视频与已缓存视频，并在最后输出成本统计报告。
显著优点
1. 云环境友好：彻底解决云服务器IP被封的行业难题，无需维护代理池
2. 成本极低：免费额度$5/月约处理714个视频，付费仅0.7美分/视频
3. 零门槛注册：无需绑定信用卡即可开始使用
4. 本地缓存：重复请求零成本，适合需要反复处理相同内容的场景
5. 批量处理：支持文件输入，自动进度报告和成本估算
潜在局限
- 依赖第三方服务：APIFY平台政策变更可能影响可用性
- 非实时处理：需等待APIFY任务队列调度，非即时响应
- 无内置摘要功能：需用户自行调用模型处理文本（文档明确说明不要使用--summarize）
- 隐私考量：视频URL需发送至APIFY第三方服务器
- 缓存管理：长期运行需手动清理缓存目录避免磁盘膨胀
适合人群
- 部署在云服务器（AWS/Hetzner/GCP）上的自动化工作流
- 需要批量处理YouTube内容的开发者、研究人员、内容创作者
- 预算有限但需稳定可靠字幕服务的个人项目
- 对技术细节要求不高、追求开箱即用的用户
常规风险
- API密钥泄露：APIFY_TOKEN需妥善保管，避免提交到版本控制
- 配额耗尽：免费额度用尽后服务中断，需监控使用量
- 服务终止风险：依赖单一商业平台，存在供应商锁定