通过 APIFY API 获取 YouTube 视频字幕，支持云服务器 IP 环境，内置本地缓存和批量处理，每月免费额度可处理约 714 个视频。
说明：
## 核心用法
`youtube-apify-transcript` 是一款面向开发者和自动化工作流的 YouTube 字幕获取工具。其核心解决思路是：利用 APIFY 平台的住宅代理网络，绕过 YouTube 对云服务器 IP（AWS、GCP、Hetzner 等）的机器人检测机制，从而稳定获取视频字幕数据。
### 主要功能特性
**1. APIFY 代理中转**
– 将字幕抓取请求通过 APIFY 的住宅代理网络转发
– 有效规避 YouTube 的 IP 封禁和验证码挑战
– 支持从云服务器环境直接运行
**2. 智能本地缓存**
– 默认开启本地文件缓存，重复请求完全免费
– 缓存目录可自定义（`YT_TRANSCRIPT_CACHE_DIR` 环境变量）
– 提供缓存统计和清理命令
**3. 多格式输出**
– 纯文本格式：适合直接阅读或输入 LLM
– JSON 格式：包含时间戳、视频标题等元数据
– 支持语言偏好指定
**4. 批量处理模式**
– 从文件读取 URL 列表批量抓取
– 自动统计成功/失败/缓存命中数量
– 适合内容归档、数据分析等场景
### 显著优点
– **云环境友好**：突破传统 yt-dlp 等工具在云服务器上被封锁的限制
– **成本极低**：$0.007/视频，免费额度每月约 714 个视频
– **零门槛试用**：无需信用卡即可注册使用
– **开箱即用**：单一 Python 脚本依赖，仅需 `requests` 库
### 潜在缺点与局限性
– **依赖第三方服务**：APIFY 服务可用性直接影响功能
– **隐私考量**：视频 URL 需发送至 APIFY 服务器处理
– **字幕覆盖不全**：仅能获取 YouTube 官方字幕，无人工上传字幕时返回失败
– **非实时工具**：不适合需要即时响应的交互场景
– **Python 环境依赖**：需要本地配置 Python 3 和依赖
### 适合人群
– 从云服务器批量处理 YouTube 内容的数据工程师
– 需要构建视频内容分析 pipeline 的开发者
– 希望为 AI 工作流获取视频文本输入的技术用户
– 内容创作者进行竞品分析或素材整理
### 常规风险
– **API 密钥泄露**：`APIFY_API_TOKEN` 需妥善保管，避免硬编码提交至版本控制
– **成本失控**：批量任务前建议测试小规模样本，监控 console.apify.com 用量
– **服务条款合规**：需确保使用场景符合 YouTube 和 APIFY 的服务条款
– **数据驻留**：敏感视频内容的元数据会经过 APIFY 基础设施
会员专属
