用途：这是一个 YouTube Data API v3 分析工具包，用于分析 YouTube 频道、视频和搜索结果，适合频道数据查看、竞品对比、视频表现评估和主题搜索分析。
主要能力：提供高层函数 analyzeChannel（频道完整分析，含频道信息、近期视频、平均播放量）、compareChannels（多频道并排对比订阅数、播放量、视频数）、analyzeVideo（播放、点赞、评论、点赞率、评论率）、searchAndAnalyze（搜索并附带完整视频统计）、getChannelStats、getVideoStats、searchChannels、getChannelVideos 等。另有 13 个细粒度 API 函数，涵盖频道、视频、搜索三类，支持批量获取。
使用方式：先安装依赖 cd scripts && npm install；在项目根目录创建 .env，填入 YOUTUBE_API_KEY=AIzaSy...your-api-key 与 YOUTUBE_DEFAULT_MAX_RESULTS=50。前置条件为在 Google Cloud 启用 YouTube Data API v3 并获取 API Key。可从 scripts/src/index.ts 导入函数调用，或用 npx tsx scripts/src/index.ts 直接运行。每次分析分三步：调用 API 获取结构化数据、自动保存为 JSON 到 results/{category}/、再读取 JSON 生成 Markdown 摘要到 results/summaries/。结果目录含 channels、videos、search、summaries。可用 listResults、loadResult、getLatestResult 管理结果。
限制：频道 ID 以 UC 开头；需自行准备 API Key 与 Google Cloud 项目；资料未提供收费、价格、平台支持范围及具体效果数据。