YouTube数据分析

技能简介

YouTube Data API v3 数据分析工具包，用于获取频道信息、视频表现数据、搜索结果及互动指标，支持批量查询与自动保存。

业务背景

内容运营和市场团队需要持续追踪YouTube频道表现，但手动收集数据耗时易错。该工具包自动获取频道核心指标、视频互动数据及竞品对比信息，帮助团队快速评估内容效果、识别爆款规律，为投放决策和内容策略调整提供及时的数据支撑。

落地案例：品牌运营团队每周需输出社媒周报。运营人员输入目标频道ID，工具自动拉取订阅增长、总观看量及近期视频互动率；同时搜索竞品关键词获取行业热门视频数据，生成对比分析。结果自动保存为JSON和Markdown报告，直接用于周会汇报，省去人工整理表格的时间。

能做什么

• 查询频道订阅数、总观看量、视频数量等核心指标
• 分析单个视频的观看、点赞、评论数据及互动率
• 对比多个频道的关键数据
• 按关键词搜索视频或频道并获取完整统计
• 获取指定频道的近期上传列表
• 自动将结果保存为 JSON 文件并生成 Markdown 汇总

使用说明

1. 安装依赖
   进入 scripts 目录执行：cd scripts && npm install
2. 配置密钥
   在项目根目录创建 .env 文件，写入：

   YOUTUBE_API_KEY=你的API密钥
   YOUTUBE_DEFAULT_MAX_RESULTS=50

   需先在 Google Cloud Console 启用 YouTube Data API v3 并获取 API 密钥。

3. 运行方式
   导入函数调用：import { analyzeChannel } from './scripts/src/index.js';
   或直接执行：npx tsx scripts/src/index.ts
4. 工作流
   执行分析 → 自动保存至 results/{category}/ → 生成 Markdown 汇总至 results/summaries/

输入与输出

见下方输入与输出表格。

风险提示

• 需自行申请并保管 YouTube Data API v3 密钥，注意配额限制
• 频道 ID 以 UC 开头，需从 URL 或页面源码获取
• API 调用受 Google 每日配额约束，大量请求可能触发限制
• 结果文件默认本地存储，需注意磁盘空间管理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/adamkristopher/youtube-analytics/SKILL.md
来源类型：开源社区技能