用途：分析自己拥有的 YouTube 频道，使用只有频道主才能获取的私密数据。套件中其他技能读取公开数据，本技能则以频道主身份认证，从 YouTube Analytics API v2 拉取留存、流量来源、观看时长、受众画像、订阅归因和收益。
主要能力：
- overview：每日观看、观看时长、平均观看时长与百分比、订阅增减、点赞、评论、分享。
- top-videos：按观看时长排序的优质视频，附带标题、时长、发布日期。
- retention：观众留存曲线及与同类视频的相对留存。
- traffic：流量来源结构，并下钻搜索词、推荐视频。
- audience：年龄/性别、主要国家、设备与操作系统。
- subscribers：每个视频的订阅增减，及每千次观看订阅数。
- revenue：收益、广告收益、CPM、RPM、广告展示、变现播放（需授权收益范围）。
使用方式：需一次性配置 Google Cloud 项目，启用 YouTube Data API v3 与 YouTube Analytics API，配置 OAuth 同意屏幕并发布到生产环境（测试模式下刷新令牌 7 天过期），创建桌面应用 OAuth 客户端，将 JSON 保存为 ~/.config/youtube-skills/client_secret.json，然后执行 pip3 install google-api-python-client google-auth-oauthlib、python3 scripts/auth.py 授权；收益指标加 --with-revenue。之后可用 /youtube-channel-insights、--days 28 等参数调用，完整分析执行 python3 scripts/fetch_insights.py all --days 90，输出 reports/data/channel-insights-<YYYY-MM-DD>.json，再据此撰写 Markdown 报告。
限制：仅申请只读范围，脚本拒绝写入权限；仅限 channel==MINE，不能分析竞争对手。缩略图展示量与点击率不开放，需在 YouTube Studio 查看；数据延迟 2–3 天；小样本下人口统计会被隐去；观看量低于约 100 的视频通常无留存曲线；收益需加入合作伙伴计划并授予收益范围。公开资料未提供定价与价格信息。