YouTube Analytics Toolkit 是一个基于 YouTube Data API v3 的分析工具包，用于分析 YouTube 频道、视频和搜索结果。
用途
该工具包面向需要获取和分析 YouTube 数据的场景，例如查看频道统计、分析视频表现、对比多个频道、按主题搜索视频或频道等。
主要能力
工具包提供高层函数与底层 API 函数两类接口。
高层函数：
- analyzeChannel(channelId)：完整频道分析，收集频道信息、近期视频、平均每视频观看量。
- compareChannels(channelIds)：对比多个频道，并排展示订阅数、观看量、视频数。
- analyzeVideo(videoId)：视频表现分析，包含观看量、点赞、评论、点赞率、评论率。
- searchAndAnalyze(query, maxResults?)：搜索并附带完整视频统计。
底层 API 函数（共 13 个，完整列表见 references/api-reference.md）： 频道函数：getChannel(channelId)、getChannelStats(channelId)、getMultipleChannels(channelIds)。 视频函数：getVideo(videoId)、getVideoStats(videoId)、getMultipleVideos(videoIds)、getChannelVideos(channelId)。 搜索函数：searchVideos(query, options?)、searchChannels(query, options?)。
使用方式
安装依赖： cd scripts && npm install
配置凭据：在项目根目录创建 .env 文件，内容为： YOUTUBE_API_KEY=AIzaSy...your-api-key YOUTUBE_DEFAULT_MAX_RESULTS=50
前置条件：需要一个已启用 YouTube Data API v3 的 Google Cloud 项目，并从 Google Cloud Console 获取 API 密钥。
调用函数：从 scripts/src/index.ts 导入，例如： import { analyzeChannel, searchAndAnalyze } from './scripts/src/index.js'; const analysis = await analyzeChannel('UCxxxxxxxx');
或使用 tsx 直接运行： npx tsx scripts/src/index.ts
工作流模式：每次分析遵循三个阶段——分析（调用 API 函数返回结构化数据）、自动保存（结果自动保存为 JSON 文件到 results/{category}/，命名方式为 {sanitized_name}.json 或 YYYYMMDD_HHMMSS__{operation}.json）、摘要（读取保存的 JSON 文件，在 results/summaries/ 生成含数据表格、对比和洞察的 Markdown 摘要）。
结果存储结构： results/ ├── channels/ # 频道数据与对比 ├── videos/ # 视频数据与分析 ├── search/ # 搜索结果 └── summaries/ # 人类可读的 Markdown 摘要
管理结果：可导入 listResults、loadResult、getLatestResult 等函数，例如 listResults('channels', 10)、loadResult(files[0])、getLatestResult('channels', 'channel_analysis')。
适用场景
- 查看或对比 YouTube 频道统计。
- 分析单个视频的表现指标。
- 按主题搜索 YouTube 视频或频道并获取统计。
- 获取频道近期上传内容。
- 批量查询多个频道或视频。
限制与提示
- 需要 Google Cloud 项目并启用 YouTube Data API v3，且需配置 API 密钥。
- 频道 ID 以 UC 开头（如 UCxxxxxxxx），可在频道 URL 或页面源代码中找到。
- 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。