核心用法
YouTube Analytics Toolkit 是一套基于官方 YouTube Data API v3 的 Node.js/TypeScript 分析工具集。核心功能涵盖四大模块：
1. 频道分析：analyzeChannel() 获取频道信息、近期视频列表及平均观看量；compareChannels() 实现多频道横向对比
2. 视频追踪：analyzeVideo() 深入分析单条视频的观看量、点赞数、评论数及互动率指标
3. 搜索整合：searchAndAnalyze() 将关键词搜索与视频统计数据一键合并输出
4. 批量操作：getMultipleChannels() / getMultipleVideos() 支持高效批量查询
所有 API 调用结果自动保存至 results/{category}/ 目录，支持 JSON 结构化存储与 Markdown 摘要生成，便于后续数据复用与报告输出。
显著优点
- 官方数据源：直接调用 Google 官方 API，数据权威性无可争议
- 工作流闭环：分析 → 自动保存 → Markdown 摘要，无需手动整理
- 灵活粒度：既有高层封装函数，也提供13个底层 API 函数满足精细控制需求
- TypeScript 原生：完整的类型定义与 IntelliSense 支持
局限与风险
- 配额限制：YouTube Data API 有每日调用配额上限（默认 10,000 units），大规模分析易触顶
- API Key 泄露风险：
.env文件管理不善可能导致密钥外泄，被他人滥用消耗配额 - 数据延迟：部分统计数据存在数小时至数天的延迟，非实时数据
- 功能边界：无法获取非公开数据（如收益、观众画像 demographics），仅限公开指标
适合人群
内容创作者、数字营销从业者、竞品分析人员、自媒体运营团队，以及需要程序化获取 YouTube 公开数据的研究者。
常规风险提醒
请妥善保管 YOUTUBE_API_KEY，避免提交至版本控制系统；建议在 Google Cloud Console 中设置配额告警与 IP 限制，防止异常流量导致服务中断。