Back to Details

int-youtube

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

YouTube Data API v3

YouTube Data API v3

YouTube integration to monitor Evolution channels and others. Supports multiple accounts via OAuth (Social Auth App) or API Key.
用于监控Evolution频道及其他频道的YouTube集成工具。支持通过OAuth（社交认证应用）或API Key实现多账户管理。

Setup

配置步骤

Accounts configured via 
make social-auth
(OAuth login) or manually in 
.env
:
env
SOCIAL_YOUTUBE_1_LABEL=Evolution API
SOCIAL_YOUTUBE_1_ACCESS_TOKEN=ya29...
SOCIAL_YOUTUBE_1_CHANNEL_ID=UC9kZHm3TnEt41ztGOLyQO9g
SOCIAL_YOUTUBE_1_REFRESH_TOKEN=1//0h...
可通过
make social-auth
（OAuth登录）或手动在
.env
文件中配置账户：
env
SOCIAL_YOUTUBE_1_LABEL=Evolution API
SOCIAL_YOUTUBE_1_ACCESS_TOKEN=ya29...
SOCIAL_YOUTUBE_1_CHANNEL_ID=UC9kZHm3TnEt41ztGOLyQO9g
SOCIAL_YOUTUBE_1_REFRESH_TOKEN=1//0h...

API Client

API客户端

bash
python3 {project-root}/.claude/skills/int-youtube/scripts/youtube_client.py <command> [args]
bash
python3 {project-root}/.claude/skills/int-youtube/scripts/youtube_client.py <command> [args]

Commands

命令列表

bash
undefined
bash
undefined

List configured accounts

列出已配置的账户

youtube_client.py accounts
youtube_client.py accounts

Channel stats (subscribers, views, total videos)

获取频道统计数据（订阅者、播放量、总视频数）

youtube_client.py channel_stats [account_label_or_index]
youtube_client.py channel_stats [account_label_or_index]

Last N videos with metrics (via playlistItems — 3 units)

获取最近N条带指标的视频（通过playlistItems接口 — 消耗3个单位配额）

youtube_client.py recent_videos [account] [N]
youtube_client.py recent_videos [account] [N]

Top N videos by views

获取按播放量排序的前N条视频

youtube_client.py top_videos [account] [N]
youtube_client.py top_videos [account] [N]

Stats for specific videos

获取特定视频的统计数据

youtube_client.py video_stats VIDEO_ID [VIDEO_ID...]
youtube_client.py video_stats VIDEO_ID [VIDEO_ID...]

Comments on a video

获取视频的评论

youtube_client.py comments VIDEO_ID [N]
youtube_client.py comments VIDEO_ID [N]

Summary of all accounts

获取所有账户的汇总信息

youtube_client.py summary
undefined
youtube_client.py summary
undefined

Output JSON exemplo

JSON输出示例

json
{
  "account": "Evolution API",
  "channel_id": "UC9kZHm3TnEt41ztGOLyQO9g",
  "subscribers": 7450,
  "total_views": 132462,
  "video_count": 27,
  "videos": [
    {
      "id": "abc",
      "title": "...",
      "published": "2026-...",
      "views": 7180,
      "likes": 500,
      "comments": 164,
      "engagement_rate": 9.25,
      "url": "https://youtube.com/watch?v=abc"
    }
  ]
}
json
{
  "account": "Evolution API",
  "channel_id": "UC9kZHm3TnEt41ztGOLyQO9g",
  "subscribers": 7450,
  "total_views": 132462,
  "video_count": 27,
  "videos": [
    {
      "id": "abc",
      "title": "...",
      "published": "2026-...",
      "views": 7180,
      "likes": 500,
      "comments": 164,
      "engagement_rate": 9.25,
      "url": "https://youtube.com/watch?v=abc"
    }
  ]
}

Key metrics

核心指标

  • Subscribers (daily/weekly/monthly delta)
  • Total views and per video
  • Engagement rate: (likes + comments) / views
  • Best video of the period
  • Publishing frequency
  • Recent comments (sentiment)
  • 订阅者数量（日/周/月变化量）
  • 总播放量及单视频播放量
  • 互动率：(点赞数 + 评论数) / 播放量
  • 周期内最佳视频
  • 发布频率
  • 最新评论（情感分析）

Quota

配额说明

  • 10,000 units/day (resets at midnight Pacific Time)
  • playlistItems
    : 1 unit (used instead of 
    search
    which costs 100)
  • channels
    , 
    videos
    , 
    commentThreads
    : 1 unit each
  • Each pagination is charged again
  • 每日10,000个单位配额（太平洋时间午夜重置）
  • playlistItems
    ：1个单位（替代消耗100个单位的
    search
    接口）
  • channels
    、
    videos
    、
    commentThreads
    ：各1个单位
  • 每次分页查询将再次消耗配额