SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场youtube-analytics

youtube-analytics

营销与增长

查看项目

更新于 10-15 09:23

技能介绍

用途

YouTube Analytics 是一个 YouTube 频道与视频表现分析技能，面向需要基于公开数据评估 YouTube 内容表现的场景。它通过 YouTube Data API v3 获取频道、视频和搜索趋势数据，并据此提供可执行的洞察。

主要能力

  • 频道分析：按用户名或 handle 获取频道信息，返回 snippet、statistics、contentDetails、brandingSettings 等部分。关键指标包括 statistics.viewCount（频道总观看量）、statistics.subscriberCount（订阅数）、statistics.videoCount（已发布视频总数），以及 contentDetails.relatedPlaylists.uploads（上传播放列表 ID，用于列出全部视频）。
  • 列出频道视频：通过上传播放列表获取视频列表，单次最多 50 条。
  • 视频表现：批量查询视频的 snippet、statistics、contentDetails，获取观看量、点赞数、评论数、视频时长（ISO 8601 格式）、发布时间和标签。
  • 搜索：按关键词搜索视频，支持 order=relevance、order=viewCount、order=date、order=rating 排序，支持 publishedAfter 日期过滤、videoDuration=short|medium|long 时长过滤、regionCode 地区过滤。
  • 指标计算：平均每视频观看量（总观看量 / 视频数）、上传频率（基于最近 50 条上传计算每周/每月视频数）、订阅观看比（平均观看量 / 订阅数）、互动率（(点赞 + 评论) / 观看量 × 100）。
  • 高表现内容识别：对最近 50 条视频按观看量、发布后日均观看速度、互动率、点赞观看比排序，并识别主题关键词、视频时长甜点区、标题模式、发布日与时间等规律。
  • 内容缺口分析：搜索频道核心关键词，对比排名靠前视频的覆盖内容与频道已有内容、同关键词下的竞品频道，以及频道尚未涉及的 trending 话题。
  • YouTube SEO 分析：检查标题（关键词在前 60 字符、有吸引力、少于 70 字符）、描述（200 词以上、关键词在前两行、含链接与时间戳）、标签（5-15 个相关标签，兼顾宽泛与具体）。缩略图和片尾画面无法通过 API 检查，会明确标注为 N/A。
  • 输出格式：生成频道分析报告，包含日期、订阅数、总观看量、视频数、频道年龄、表现概览表（含基准对比）、按观看量排序的前 10 视频表、内容模式（有效与表现不佳）、SEO 机会表、建议列表；也支持多频道对比表格。

使用方式

该技能需要 YOUTUBE_API_KEY。需在环境变量或 ~/.claude/.env.global 中检查该密钥；若未找到，会提示用户通过以下方式设置：

export YOUTUBE_API_KEY=your_key_here

或将其添加到 ~/.claude/.env.global。API 密钥可在 https://console.cloud.google.com/apis/credentials 获取，并需在 Google Cloud 项目中启用 “YouTube Data API v3”。

API 基础地址为 https://www.googleapis.com/youtube/v3。常用调用示例：

按 handle 获取频道： curl -s "https://www.googleapis.com/youtube/v3/channels?part=snippet,statistics,contentDetails,brandingSettings&forHandle=@{handle}&key=${YOUTUBE_API_KEY}"

按 ID 获取频道： curl -s "https://www.googleapis.com/youtube/v3/channels?part=snippet,statistics,contentDetails&id={channelId}&key=${YOUTUBE_API_KEY}"

获取上传播放列表： curl -s "https://www.googleapis.com/youtube/v3/playlistItems?part=snippet,contentDetails&playlistId={uploadsPlaylistId}&maxResults=50&key=${YOUTUBE_API_KEY}"

获取视频统计： curl -s "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics,contentDetails&id={videoId1},{videoId2}&key=${YOUTUBE_API_KEY}"

按关键词搜索： curl -s "https://www.googleapis.com/youtube/v3/search?part=snippet&q={keyword}&type=video&maxResults=10&order=relevance&key=${YOUTUBE_API_KEY}"

适用场景

  • 用户提出 “YouTube analytics”“check my channel”“video performance” 等需求时。
  • 需要评估频道整体表现、上传频率与互动健康度。
  • 需要找出高表现视频的共性并优化内容策略。
  • 需要发现内容缺口与关键词机会。
  • 需要检查视频的标题、描述、标签等 SEO 要素。
  • 需要对比多个频道的公开指标。

限制

  • YouTube Data API 每日配额为 10000 单位；每次搜索消耗 100 单位，每次视频/频道查询消耗 1-3 单位，需高效使用 API 调用。
  • 建议在单次请求中批量传入视频 ID（每次最多 50 个）以节省配额。
  • 订阅数低于 1000 时 YouTube 会隐藏，API 返回 0。
  • 若创作者隐藏点赞，likeCount 可能不可用。
  • API 结果仅为公开数据；观看时长、点击率、受众留存等私密分析需要频道所有者使用 YouTube Studio 或带 OAuth 的 YouTube Analytics API。
  • 缩略图与片尾画面无法通过 API 检查。