youtube-analytics

📺 YouTube 数据洞察与竞品分析利器

基于 Google 官方 YouTube Data API v3 的频道与视频数据分析工具,支持竞品对比、趋势追踪,为内容创作者和营销人员提供数据驱动的决策支持。

收藏
16.2k
安装
3.9k
版本
v1.0.0
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

核心用法

YouTube Analytics Toolkit 是一套完整的 YouTube 数据分析解决方案,通过调用 Google 官方 YouTube Data API v3 实现。用户可通过环境变量配置 API 密钥后,调用 analyzeChannel()() 获取频道全景分析,使用 compareChannels()() 进行多频道横向对比,或借助 searchAndAnalyze()() 完成关键词搜索与视频表现评估。所有分析结果自动以 JSON 格式保存至 results// 目录,并支持生成 Markdown 格式的可视化摘要报告。

显著优点

该 Skill 的最大优势在于其官方 API 背书自动化工作流设计。依托 Google 官方 googleapis 库,数据准确性与接口稳定性得到充分保障;三阶段工作流(Analyze → Auto-Save → Summarize)实现了从数据采集到洞察输出的无缝衔接,大幅降低用户的技术门槛。批量查询功能(getMultipleChannelsgetMultipleVideos`)有效提升效率,特别适合需要监控大量账号的 MCN 机构或营销团队。此外,本地化的结果存储机制确保数据隐私,避免敏感商业信息外泄。

潜在缺点与局限性

首先,API 配额限制是核心瓶颈——YouTube Data API v3 对免费项目设有每日 10,000 单位的调用上限,大规模数据采集可能迅速耗尽额度。其次,该 Skill 仅支持公开数据获取,无法访问私有视频、受众画像或实时观看数据等深度分析维度。第三,输出依赖本地文件系统,缺乏云端协作或实时仪表板功能,团队共享需额外配置。最后,频道 ID 的获取对非技术用户不够友好,且 sanitizeFilename()() 的大写转换可能影响结果文件的可读性。

适合的目标群体

  • 内容创作者与 UP 主:追踪自身频道成长趋势,优化内容策略
  • 数字营销与品牌运营:监测竞品动态,评估 KOL 合作价值
  • MCN 机构与经纪公司:批量管理旗下达人账号,生成运营周报
  • 市场研究人员:分析行业热点,识别新兴趋势与潜在机会
  • 自媒体投资者:基于数据评估频道商业价值与增长潜力

使用风险

1. 配额耗尽风险:高频调用可能触发 API 限制,建议实施请求速率控制并在 Google Cloud Console 监控用量
2. 密钥泄露风险:API 密钥若误提交至版本控制,可能被恶意利用导致配额盗刷

3. 数据时效性:API 返回数据存在数分钟延迟,不适合实时决策场景

4. 依赖维护风险googleapis 等依赖库的版本更新可能引入破坏性变更,需锁定版本或定期回归测试

安全解读

核心功能

YouTube Analytics Toolkit 是一套基于官方 YouTube Data API v3 的 TypeScript 数据分析工具,提供完整的频道、视频和搜索分析能力。核心用法包括:

  • 频道分析:获取订阅数、总观看量、视频数量及近期上传表现,支持多频道横向对比
  • 视频诊断:深度解析单条视频的观看量、点赞数、评论数,自动计算互动率(like rate/comment rate)
  • 搜索洞察:关键词搜索 + 自动获取结果视频的完整统计数据,快速发现热门内容
  • 自动存档:所有 API 结果自动保存为结构化 JSON,支持结果管理、历史回溯与 Markdown 汇总报告

显著优点

1. 官方 API 保障:直连 Google 官方 youtube.googleapis.com,数据权威、实时、合规
2. 安全架构:API 密钥通过环境变量配置,无硬编码风险;TLS 1.3 加密传输

3. 工程规范:TypeScript 类型完整,8 个模块 572 行代码结构清晰,依赖精简(仅 4 个直接依赖)

4. 高效批量getMultipleChannels/getMultipleVideos 支持批量请求,降低 API 配额消耗

5. 开箱即用:提供 13 个细粒度 API 函数 + 4 个高阶组合函数,覆盖从简单统计到竞品分析的全场景

潜在局限

  • 配置门槛:需用户自行前往 Google Cloud Console 申请 YouTube Data API v3 密钥并配置 .env 文件
  • 配额限制:Google 默认每日配额 10,000 单位,高频调用需注意用量控制
  • 本地存储:分析结果自动落盘至本地 results/ 目录,需手动清理释放空间
  • 公开数据局限:仅能获取公开频道/视频数据,无法访问私密或 YouTube Analytics 后台的详细受众数据

适合人群

  • 内容创作者:监测频道成长、分析爆款视频特征、追踪竞品频道
  • 数字营销人员:KOL 筛选与价值评估、投放效果追踪、行业趋势洞察
  • 研究人员:YouTube 内容生态的定量分析与学术调研

常规风险

  • API Key 泄露风险:若误将 .env 文件提交至 GitHub,密钥可能被滥用导致配额耗尽
  • 数据隐私合规:虽仅处理公开数据,但批量抓取后本地存储需符合用户所在地区的数据法规
  • API 变更风险:YouTube Data API 存在版本迭代或策略调整的可能,需关注官方公告
  • T3 来源可信度:由个人开发者维护,虽通过 S 级安全扫描,但建议用户审阅代码后再用于敏感场景

youtube-analytics 内容

references文件夹
scripts文件夹
src文件夹
api文件夹
config文件夹
core文件夹
手动下载zip · 26.7 kB
api-reference.mdtext/markdown
请选择文件