官方YouTube Data API v3封装工具包，支持频道分析、视频数据追踪、竞品对比与搜索分析，数据自动保存结构化。
说明：
## 核心用法
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 限制，防止异常流量导致服务中断。
会员专属
