核心用法
youtube-search 是一个基于 TranscriptAPI.com 的 YouTube 内容检索与转录工具，提供三层核心能力：
1. 全局搜索 (/api/v2/youtube/search)：按关键词检索视频或频道，支持 video/channel 类型过滤，单次最多返回 50 条结果，含视频时长、播放量、字幕可用性等元数据。
2. 频道内搜索 (/api/v2/youtube/channel/search)：针对特定频道（支持 @handle、频道 URL 或 UC... ID）进行精准内容检索，适合追踪特定创作者的主题视频。
3. 转录提取（配套工作流）：通过 videoId 获取带时间戳的字幕文本，支持 text/json/srt 格式输出。
典型工作流：搜索关键词 → 筛选含字幕视频 → 提取转录文本 → 用于内容分析、摘要生成或知识库构建。
显著优点
- 精准检索：支持频道内搜索，解决 YouTube 站内搜索体验差、结果混杂的痛点
- 字幕可用性预判：返回
hasCaptions字段，避免无效请求 - 多标识兼容：同时支持频道句柄、URL、ID 三种标识方式
- 成本可控：免费 tier 100 credits，单条搜索仅耗 1 credit，频道解析免费
- 格式灵活：转录支持纯文本、JSON、SRT 三种输出格式
潜在缺点与局限性
- 第三方依赖：核心功能依赖 TranscriptAPI.com 的可用性与定价策略，非官方 YouTube API
- 配额消耗：高频使用需付费（100 credits 约支持 100 次搜索或 50 次搜索+50 次转录）
- 速率限制：免费 tier 300 req/min，大规模批量处理需升级
- 字幕覆盖限制：仅返回
hasCaptions状态，无法区分自动字幕与人工字幕质量 - 地理/语言限制：未明确说明是否支持多语言搜索或区域过滤
适合人群
- 研究人员：需要批量获取 YouTube 讲座、访谈的转录文本进行质性分析
- 内容创作者：追踪竞品频道、分析热门话题趋势
- 学习者：快速定位特定频道的教学视频并提取字幕复习
- 知识管理用户：构建个人视频知识库，将视频内容转为可搜索文本
常规风险
- API 密钥安全：
TRANSCRIPT_API_KEY需妥善保管，避免硬编码泄露 - 服务连续性风险：第三方服务可能调整定价或停止运营
- 版权合规：转录内容的使用需遵守 YouTube 版权政策及原视频授权
- 数据隐私：用户搜索行为与视频偏好可能被第三方服务记录