用途：对任意 YouTube 主题或细分领域做数据调研，找出有效内容、识别内容缺口并生成有数据支撑的视频选题。
主要能力：脚本按相关性、观看量和日期三种排序搜索视频，批量获取视频与频道详情，计算观看量百分位、各内容形式表现、标题模式、标签云、异常爆款与饱和度信号，输出原始 JSON 并打印报告路径。报告结构涵盖执行摘要、市场概览、表现基准、内容形式分析、频道格局、标题模式、标签与 SEO、异常爆款、内容新鲜度、内容缺口与机会、视频选题、饱和度评估和配额使用。
使用方式：命令形如 /youtube-topic-researcher air fryer recipes，或 /youtube-topic-researcher --topic "home gym setup" --max-results 75。需先获取 YouTube Data API v3 密钥，并以 YT_API_KEY 环境变量运行脚本：YT_API_KEY=API_KEY python3 <skill-dir>/scripts/research_topic.py "TOPIC" [--max-results N]。依赖 pip3 install google-api-python-client。脚本写入 reports/data/topic-research-<topic-slug>-<YYYY-MM-DD>.json，报告写入 reports/topic-research-<topic-slug>-<YYYY-MM-DD>.md。
限制：--max-results 默认 50、最大 100；默认配额约 305 单位，设为 100 时约 507 单位，每日默认额度 10,000 单位，太平洋时间午夜重置。需自备 API 密钥。