用途：面向 YouTube 的视频调研工具，既可执行单项操作（工具模式），也可对某主题进行自主搜索到综合的研究流程（研究模式），适合小众、新兴或资料分散主题的调研。
主要能力：搜索视频并返回结构化元数据，可按最短时长、发布日期、最低播放量过滤；下载并清洗字幕为适合大模型阅读的文本，支持时间戳与多语言列出；提取标题、描述、频道、时长、章节、播放与点赞数、标签、字幕语言、缩略图等信息；下载 mp3、m4a、opus、wav 音频；扫描频道的视频、Shorts、直播、播放列表并按时间或播放量排序；除 search 外各子命令支持 --batch 批量处理 URL 列表。
使用方式：所有操作通过同一 CLI 调用。例如搜索：python3 ${CLAUDE_PLUGIN_ROOT}/skills/search-youtube/scripts/yt_research.py search "<query>" --count 10；字幕：python3 ${CLAUDE_PLUGIN_ROOT}/skills/search-youtube/scripts/yt_research.py transcript "<url>"；元数据：python3 ${CLAUDE_PLUGIN_ROOT}/skills/search-youtube/scripts/yt_research.py metadata "<url>"；音频：python3 ${CLAUDE_PLUGIN_ROOT}/skills/search-youtube/scripts/yt_research.py audio "<url>" --audio-format mp3 -t <topic>；频道：python3 ${CLAUDE_PLUGIN_ROOT}/skills/search-youtube/scripts/yt_research.py channel "url-or-@handle" --limit 20。可用 --help 查询各子命令完整参数。
研究模式：先生成 4-6 个不同角度的查询变体并行搜索，去重后按“小众优先”启发式评估候选，再扫描相关频道并收敛查询，最后确认并并行下载 4-7 个视频字幕，综合成含关键发现、共识、分歧、独特见解、覆盖空白和来源表的报告；可用 WebSearch 或 brave-cli 交叉核对。
限制：搜索过滤为客户端执行，工具会自动多取结果补偿；exit 2 表示未安装 yt-dlp（pip install yt-dlp），exit 3 为网络或下载错误，exit 4 为无结果。YouTube 为主平台，其他 yt-dlp 支持的站点（Vimeo、Twitter、Twitch 等）亦可使用。具体收费、价格等信息暂未提供。