用途：为智能体提供自主的 YouTube 数据检索能力，可搜索视频、频道与播放列表，并提取元数据、字幕与分析数据，无需用户干预。资料按环境条件给出五种可选方式，并提供方法选择指南。
主要能力：方法 A 使用内置 web_search 工具，零配置即可搜索视频与频道；方法 B 使用 YouTube Data API v3，需 YOUTUBE_API_KEY，可获取最丰富的结构化数据，包括视频统计、时长、标签与频道统计，并说明配额成本（search.list 100 单位，videos.list、channels.list、playlists.list 各 1 单位，每日免费 10000 单位）；方法 C 使用 SerpAPI 的 YouTube 引擎，需 SERPAPI_KEY，搜索结果直接包含观看量、时长与发布日期；方法 D 使用 youtube-transcript-api 按视频 ID 获取字幕文本与可用语言列表，无需 API 密钥；方法 E 使用 yt-dlp 进行深度元数据抓取与字幕下载，无需密钥。
使用方式：根据项目环境中的配置选择方法。未配置任何密钥时从方法 A 起步；设置 YOUTUBE_API_KEY 后用方法 B；设置 SERPAPI_KEY 后用方法 C；已知视频 ID 需字幕时用方法 D；需要深度抓取时用方法 E。方法 D 与方法 E 需安装命令：pip install youtube-transcript-api yt-dlp --break-system-packages。文中还给出环境变量设置示例与自动化工作流模式，包括竞品主题研究、零配置内容发现与频道监控。
适用场景：视频与频道检索、竞品或主题调研、字幕内容分析、摘要与关键词提取、频道更新监控等。
限制：方法 A 无结构化 JSON，需文本解析；方法 B 存在配额消耗且需密钥；方法 D 在字幕被禁用时会报错；方法 E 直接请求 YouTube，在受限网络环境中可能被屏蔽，建议先用 yt-dlp --version 测试。各方法的具体可用性依赖实际环境，资料未提供保证。