核心功能
YouTube Search 技能整合了 TranscriptAPI.com 的 API 能力，为用户提供三层搜索能力：全局视频搜索、频道搜索 及 频道内精准检索，并可衔接获取视频字幕/转录文本。
主要用法
1. 全局搜索 (/api/v2/youtube/search)：按关键词搜索 YouTube 视频或频道，支持 video/channel 类型切换，单次返回最多 50 条结果
2. 频道内搜索 (/api/v2/youtube/channel/search)：针对特定频道（支持 @handle、URL 或 UC... ID）进行内容筛选，适合追踪特定创作者的主题输出
3. 频道解析 (/api/v2/youtube/channel/resolve)：免费将 @handle 转换为标准 channel ID
4. 字幕获取（需配合 transcript 端点）：从搜索结果中提取 videoId 后可获取带时间戳的完整转录
搜索结果包含丰富的元数据：视频时长、观看量、发布时间、是否有字幕、频道认证状态、缩略图等，便于快速评估内容价值。
显著优点
- 分层检索设计：从全网到单频道，满足从泛调研到精追踪的不同场景
- 字幕友好：直接暴露
hasCaptions字段，并支持后续 transcript 获取，适合学术研究、内容分析、竞品监测 - 身份标识完善：同时返回
channelId、channelHandle、channelVerified，便于数据关联与可信度判断 - 免费起步：100 积分免费额度，单搜索仅消耗 1 积分，成本可控
局限性与风险
| 方面 | 说明 |
|------|------|
| **依赖第三方服务** | 完全依赖 TranscriptAPI.com 的可用性与数据质量，非官方 YouTube API，存在服务稳定性风险 |
| **速率限制** | 免费 tier 限 300 请求/分钟，大规模采集需升级付费 |
| **数据完整性** | YouTube 自身的字幕生成策略（自动 vs 上传）决定 `hasCaptions` 的实际可用性 |
| **版权合规** | 获取字幕涉及版权内容，需确保符合当地法规及 YouTube 服务条款，仅限个人研究用途 |
| **隐私暴露** | 注册需提供邮箱，API Key 存储于本地 `~/.openclaw/openclaw.json`，存在本地泄露风险 |
适合人群
- 研究人员：需要批量获取视频元数据及转录文本进行内容分析
- 内容创作者：追踪竞品频道、监测行业话题趋势
- 学习者：快速定位特定频道内的教学资源
- 数据分析师：构建 YouTube 内容数据集
常规风险
- 服务中断：第三方 API 可能因政策调整或技术故障停止服务
- 成本控制：高频使用易消耗积分，需监控用量
- 数据时效：搜索结果依赖 YouTube 索引，可能存在延迟