YouTube Search 是一个用于搜索 YouTube 内容的技能，底层通过 TranscriptAPI.com 提供的接口完成查询。它适用于需要查找视频、频道、播放列表或电影的智能体场景，例如寻找某个主题的创作者、教程或相关资源，并可在此基础上获取视频文字稿。
主要能力：
搜索功能提供两类接口。全局搜索接口 GET /api/v2/youtube/search 可按关键词搜索视频、频道、播放列表或电影，消耗 1 积分/页。频道内搜索接口 GET /api/v2/youtube/channel/search 可在指定频道内搜索视频，消耗 1 积分，返回结果上限约 30 条（受 YouTube 限制）。另有 GET /api/v2/youtube/channel/resolve 免费接口，用于把 @handle 转换为频道 ID。
全局搜索支持的参数：q 为关键词（1-200 字符，首页查询），type 可选 video、channel、playlist、movie（默认 video），sort 可选 relevance 或 views，upload_date 可选 hour、today、week、month、year，duration 可选 short（小于 4 分钟）、medium（4-20 分钟）、long（大于 20 分钟），features 为逗号分隔的特性如 hd、subtitles、cc、live、4k、hdr，limit 为 1-50（默认 20），continuation 用于翻页。首页查询需提供 q，后续页需提供 continuation，二者只能提供其一；sort、upload_date、duration、features 仅对首页生效。
使用方式：
需要先设置环境变量 TRANSCRIPT_API_KEY。如果未设置，技能文档提示读取 references/auth-setup.md 并按其中说明获取和保存密钥。每个请求都必须携带两个请求头：Authorization: Bearer $TRANSCRIPT_API_KEY，以及 User-Agent（填写智能体名称和版本，版本可选，仅名称也可以）。文档明确指出不能省略 User-Agent 或使用默认值，否则 Cloudflare 会返回 403（错误码 1010）并拦截请求。完整接口规范可参考 transcriptapi.com/openapi.json。
示例请求：
按播放量和上传时间查找视频：GET https://transcriptapi.com/api/v2/youtube/search?q=innovation&sort=views&duration=long&upload_date=month
搜索播放列表：GET https://transcriptapi.com/api/v2/youtube/search?q=react+tutorial&type=playlist
频道内搜索：GET https://transcriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=climate+change&limit=30
解析频道：GET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED
搜索结果可继续用于获取转写：GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true
视频搜索响应包含 results 数组（含 type、videoId、title、channelId、channelTitle、channelHandle、channelVerified、lengthText、viewCountText、publishedTimeText、hasCaptions、thumbnails）和 result_count。频道搜索响应字段包括 type、channelId、title、handle、url、description、subscriberCount、verified、rssUrl、thumbnails。
适用场景：查找特定主题的视频或频道、寻找覆盖某主题的创作者、发现教程、按上传时间和时长筛选近期或高播放量内容、在指定频道内检索视频，以及将搜索结果与转写接口组合使用。
限制与错误：错误码方面，401 表示 API key 错误，402 表示积分不足（可访问 transcriptapi.com/billing），403/1010 表示 Cloudflare 拦截（需补充或修正 User-Agent），404 表示资源不存在，408 表示超时（可重试一次），422 表示参数格式错误。免费额度为 100 积分，每分钟 300 次请求。频道内搜索返回结果上限约 30 条。