YouTube Analytics技能使用说明
2026-03-31
新闻来源：网淘吧
围观:19
电脑广告
手机广告
YouTube Analytics Toolkit
设置
安装依赖项：
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 密钥。
快速开始
| 用户说 | 调用函数 |
|---|---|
| "分析这个 YouTube 频道" | analyzeChannel(channelId) |
| "比较这两个频道" | compareChannels([id1, id2]) |
| "这个视频表现如何？" | analyzeVideo(videoId) |
| "搜索 YouTube 上的 [主题]" | searchAndAnalyze(query) |
| "获取这个频道的统计数据" | getChannelStats(channelId) |
| "获取此视频的观看次数" | getVideoStats(videoId) |
| "查找关于[主题]的频道" | searchChannels(query) |
| "显示此频道最近的上传内容" | getChannelVideos(channelId) |
通过从以下位置导入来执行函数：scripts/src/index.ts：
import { analyzeChannel, searchAndAnalyze } from './scripts/src/index.js';
const analysis = await analyzeChannel('UCxxxxxxxx');
或直接使用 tsx 运行：
npx tsx scripts/src/index.ts
工作流模式
每次分析都遵循三个阶段：
1. 分析
运行 API 函数。每次调用都会访问 YouTube Data API 并返回结构化数据。
2. 自动保存
所有结果会自动保存为 JSON 文件到results/{category}/目录。文件命名模式：
- 命名结果：
{sanitized_name}.json - 自动生成：
YYYYMMDD_HHMMSS__{operation}.json
3. 总结
分析完成后，读取已保存的JSON文件，并在results/summaries/目录下创建包含数据表格、对比和洞察的Markdown总结。
高级功能
| 功能 | 目的 | 收集内容 |
|---|---|---|
analyzeChannel(channelId) | 频道全面分析 | 频道信息、近期视频、每视频平均观看量 |
compareChannels(channelIds) | 多频道对比 | 并排显示订阅者数、观看量、视频数量 |
analyzeVideo(videoId) | 视频表现分析 | 观看量、点赞、评论、点赞率、评论率 |
searchAndAnalyze(query, maxResults?) | 搜索 + 统计 | 附带完整视频统计数据的搜索结果 |
独立API功能
如需进行细粒度控制，可从API模块导入特定函数。完整列表请查阅references/api-reference.md该文档包含13个API函数的完整参数、类型及示例说明。
频道功能
| 函数 | 功能 |
|---|---|
getChannel(channelId) | 获取完整频道详情 |
getChannelStats(channelId) | 获取简化统计数据（订阅数、观看量、视频数量） |
getMultipleChannels(channelIds) | 批量获取多个频道 |
视频功能
| 函数 | 功能 |
|---|---|
getVideo(videoId) | 获取完整视频详情 |
getVideoStats(videoId) | 获取简化统计数据（观看量、点赞数、评论数） |
getMultipleVideos(videoIds) | 批量获取多个视频 |
getChannelVideos(channelId) | 获取频道最新上传内容 |
搜索功能
| 函数 | 功能说明 |
|---|---|
searchVideos(查询语句, 选项参数?) | 搜索视频内容 |
searchChannels(查询语句, 选项参数?) | 搜索频道信息 |
结果存储
结果自动保存至results/ 目录采用以下结构：
results/
├── channels/ # Channel data and comparisons
├── videos/ # Video data and analyses
├── search/ # Search results
└── summaries/ # Human-readable markdown summaries
结果管理
import { listResults, loadResult, getLatestResult } from './scripts/src/index.js';
// List recent results
const files = listResults('channels', 10);
// Load a specific result
const data = loadResult(files[0]);
// Get most recent result for an operation
const latest = getLatestResult('channels', 'channel_analysis');
使用技巧
- 使用频道ID—— 频道ID以
UC开头（例如：UCxxxxxxxx - ）。可通过频道URL或页面源代码查找。请求数据摘要
- —— 获取数据后，可要求生成包含表格和深度分析的Markdown格式摘要。频道对比
compareChannels()用于并行对比竞争对手的基准。 - 批量请求— 使用
getMultipleChannels()或getMultipleVideos()进行高效的批量查找。 - 搜索 + 分析—
searchAndAnalyze()将搜索与完整的视频统计数据结合在一次调用中完成。
微信扫一扫，打赏作者吧～文章底部电脑广告
手机广告位-内容正文底部
