用途：用于发现和分析 YouTube 竞品频道，基于 YouTube Data API v3，通过关键字搜索、类目匹配、内容相似度和直接输入等渠道找出竞争对手并做对比分析。
主要能力：发现竞品（关键字搜索 search.list(type=channel)，内容相似度取自用户最近 25 条视频标题的高频词，或直接通过 --competitors 传入 @handle、频道 ID、URL）；竞品排名使用 sizeSimilarity 与 relevanceScore 计算 overallScore=sizeSimilarity0.3+relevanceScore0.7，无 --channel 时 sizeSimilarity 固定为 0.5；对前 N（默认 12）个竞品做近 25 条内容画像，包括平均时长、Shorts 占比、平均近期播放、上传间隔、偏好发布日、热门标题词和标签；另做对比分析（订阅数、总播放、视频数、每视频播放、播放/订阅、月上传数、频道年龄）、定位对比、内容缺口分析和配额使用说明。
使用方式：需一个启用 YouTube Data API v3 的 Google Cloud Console API Key；安装依赖 pip3 install google-api-python-client；运行脚本 scripts/analyze_competitors.py，示例：YT_API_KEY=API_KEY python3 <skill-dir>/scripts/analyze_competitors.py --channel "@MyChannel"；数据写入 reports/data/competitor-analysis-<slug>-<YYYY-MM-DD>.json，报告写入 reports/competitor-analysis-<slug>-<YYYY-MM-DD>.md。
参数：--channel、--competitors、--keywords、--max-queries N（默认 3）、--top N（默认 12）；--channel 与 --competitors 至少需提供一个。
限制：需自行准备 API Key 并承担配额（发现模式约 328 单位，直接模式约 40 单位，每日默认 10000 单位，太平洋时间午夜重置）；搜索消耗较大，但发现后均使用 1 单位端点；报告内容取决于 API 返回数据，未提供价格、平台扩展、具体效果保证等信息。