核心用法
youtube-search 是一套基于 TranscriptAPI.com 的 YouTube 搜索与字幕获取解决方案。核心功能包括三项：
1. 全局搜索 (/api/v2/youtube/search)：按关键词搜索 YouTube 视频或频道，支持 type=video|channel 切换，单次返回 1-50 条结果，消耗 1 credit。
2. 频道内搜索 (/api/v2/youtube/channel/search)：针对特定频道 ID 进行视频检索，适合追踪特定创作者的内容，同样消耗 1 credit。
3. 频道解析与字幕获取：通过 /channel/resolve 将 @handle 转为 channel ID（免费），再结合 transcript API 获取视频字幕，支持纯文本或带时间戳格式。
典型工作流
# 搜索 Python 教程视频 → 获取第一条字幕 curl .../search?q=python+tutorial&limit=5 curl .../transcript?video_id=VIDEO_ID&format=text
显著优点
- 搜索+字幕闭环：从发现内容到提取文本一站式完成，无需手动下载视频
- 频道级精准搜索：可直接在知名频道内检索，过滤低质内容
- 轻量计费：搜索仅 1 credit/次，免费额度 100 credits 足够小规模试用
- 标准化输出：返回结构化 JSON，包含观看量、发布时间、频道认证状态等元数据
潜在缺点与局限
- 依赖第三方 API：TranscriptAPI.com 为商业服务，存在服务中断、调价或终止风险
- 字幕覆盖率：
hasCaptions字段仅表示存在字幕，不保证语言匹配或质量 - YouTube 反爬限制：频道内搜索实际依赖 YouTube 内部接口，结果上限约 30 条，且可能因平台策略变化失效
- 无视频下载功能：仅提供元数据与字幕，不解决视频本体获取需求
适合人群
- 研究人员：需要批量提取 YouTube 教育/演讲内容做文本分析
- 内容运营：监控竞品频道更新、追踪热门话题视频
- 开发者：构建基于 YouTube 内容的 RAG、摘要、翻译等 AI 应用
常规风险
- API Key 泄露：需妥善保管
TRANSCRIPT_API_KEY，避免硬编码提交到仓库 - 配额耗尽：免费 tier 100 credits 约支持 50 次搜索+字幕组合调用，生产环境需订阅付费计划
- 版权合规：提取的字幕仍受原视频版权保护，商用需获得授权
- 服务连续性：TranscriptAPI.com 为独立商业实体，建议评估替代方案（如官方 YouTube Data API + 第三方字幕服务）作为灾备