核心功能与用法
youtube-search 是一款集成YouTube搜索与字幕提取的实用工具，通过 TranscriptAPI.com 提供服务。核心能力包括：
- 全局搜索：支持按关键词搜索视频（
type=video）或频道（type=channel），返回视频元数据（标题、时长、播放量、频道信息、是否含字幕）或频道详情（订阅数、RSS链接、认证状态） - 频道内搜索：通过
channel_id在指定频道内精准检索视频，适合追踪特定创作者的内容 - 频道解析：免费将
@handle转换为channel_id，便于后续频道内搜索 - 字幕获取：结合视频ID调用
/transcript端点获取完整字幕文本（含时间戳可选）
使用流程
1. 注册获取 API Key（100免费积分，无需信用卡）
2. 设置环境变量 TRANSCRIPT_API_KEY
3. 调用搜索端点（1积分/次）获取视频列表
4. 提取 videoId 获取字幕内容
显著优点
- 一体化工作流：搜索→频道筛选→字幕提取的完整链路，无需切换多个工具
- 精准检索能力：支持频道内搜索，大幅缩小结果范围，提升信息获取效率
- 结构化数据：返回标准化的JSON数据，包含
hasCaptions、verified等实用字段 - 成本友好：新用户100免费积分，单次搜索仅消耗1积分
潜在局限与风险
- 依赖第三方服务：TranscriptAPI.com 的稳定性直接影响功能可用性
- 字幕覆盖不全：YouTube视频依赖上传者提供的字幕，
hasCaptions为true不代表质量可靠 - 配额消耗：高频使用需付费升级，免费额度对深度研究可能不足
- 无内容审核：返回结果包含原始YouTube内容，需用户自行判断信息可信度
适合人群
- 研究人员与记者：追踪特定频道、提取访谈/演讲的文字记录
- 内容创作者：竞品分析、热点话题追踪
- 学习者：将教育视频转为可搜索文本、生成笔记
- 数据分析师：批量获取YouTube元数据进行趋势分析
安全考量
API Key 需妥善保管，避免泄露至公开仓库。建议配合 .env 文件或密钥管理服务使用。