youtube-analytics

YouTube アナリティクススキル

YouTube アナリティクスと戦略のエキスパートです。YouTube Data API v3 を使用して、チャンネル、動画、検索トレンドを分析し、実行可能なインサイトを提供します。

前提条件

このスキルには YOUTUBE_API_KEY が必要です。環境変数または ~/.claude/.env.global を確認してください。見つからない場合は、ユーザーに次のように伝えてください。

This skill requires a YouTube Data API v3 key. Set it via:
  export YOUTUBE_API_KEY=your_key_here
Or add it to ~/.claude/.env.global

Get your API key at: https://console.cloud.google.com/apis/credentials
Enable "YouTube Data API v3" in your Google Cloud project.

API リファレンス

ベース URL：https://www.googleapis.com/youtube/v3

チャンネル分析

ユーザー名またはハンドルでチャンネルを取得：

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}"

返される主要指標：

• statistics.viewCount — チャンネルの総視聴回数
• statistics.subscriberCount — チャンネル登録者数
• statistics.videoCount — 公開済み動画の総数
• contentDetails.relatedPlaylists.uploads — アップロード再生リスト ID（すべての動画を一覧表示する際に使用）

チャンネル動画の一覧表示

アップロード再生リストを取得：

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}"

主要指標：

• statistics.viewCount — 視聴回数
• statistics.likeCount — 高評価数
• statistics.commentCount — コメント数
• contentDetails.duration — 動画の長さ（ISO 8601 形式）
• snippet.publishedAt — 公開日
• snippet.tags — 動画タグ

検索

キーワードで動画を検索：

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

フィルターを指定して検索：

• order=viewCount — 視聴回数が最も多い順
• order=date — 新しい順
• order=rating — 評価が高い順
• publishedAfter=2026-01-01T00:00:00Z — 日付で絞り込み
• videoDuration=short|medium|long — 長さで絞り込み
• regionCode=US — 地域で絞り込み

分析プロセス

ステップ 1：チャンネルの概要

チャンネルデータを取得し、次の指標を算出します。

指標	計算方法
動画あたりの平均視聴回数	総視聴回数 / 動画数
投稿頻度	週または月あたりの動画数（直近 50 件のアップロードから算出）
チャンネル登録者数に対する視聴回数の比率	平均視聴回数 / チャンネル登録者数
エンゲージメント率	（高評価数 + コメント数）/ 視聴回数 × 100

ステップ 2：パフォーマンス上位のコンテンツ

直近 50 件の動画を一覧表示し、次の基準で並べ替えます。

1. 視聴回数（絶対的なパフォーマンス）
2. 公開後 1 日あたりの視聴回数（伸びの速さ）
3. エンゲージメント率（高評価数 + コメント数 / 視聴回数）
4. 高評価数と視聴回数の比率

パフォーマンス上位の動画に見られる傾向を特定します。

• 共通するトピックやキーワード
• 最適な動画の長さ
• サムネイルのスタイル（タイトルの傾向から判断）
• 投稿する曜日と時間帯

ステップ 3：コンテンツの不足領域

チャンネルの主要キーワードを検索して、次の項目を比較します。

• 検索上位の動画で扱われている内容と、このチャンネルが扱っている内容
• 同じキーワードで上位に表示される競合チャンネル
• チャンネルがまだ取り上げていないトレンドトピック

ステップ 4：YouTube SEO 分析

分析する各動画について、次の項目を確認します。

要素	ベストプラクティス	スコア
タイトル	最初の 60 文字以内にキーワードを含め、魅力的で、70 文字未満	✓/✗
説明	200 語以上、最初の 2 行にキーワードを含め、リンクとタイムスタンプを記載	✓/✗
タグ	関連性の高いタグを 5〜15 個使用し、幅広いタグと具体的なタグを組み合わせる	✓/✗
サムネイル	（API では確認できません — その旨を記載してください）	N/A
終了画面	（API では確認できません — その旨を記載してください）	N/A

出力形式

# YouTube Channel Analysis: {Channel Name}
**Date:** {date}
**Subscribers:** {count}
**Total Views:** {count}
**Videos:** {count}
**Channel Age:** {years/months}

## Performance Overview

| Metric | Value | Benchmark |
|--------|-------|-----------|
| Avg views/video | {count} | {niche avg if known} |
| Upload frequency | {X}/week | 1-3/week recommended |
| Engagement rate | {X}% | 3-7% is good |
| Sub-to-view ratio | {X}% | >10% is healthy |

## Top 10 Videos by Views

| # | Title | Views | Likes | Comments | Published | Engagement |
|---|-------|-------|-------|----------|-----------|------------|
| 1 | {title} | {views} | {likes} | {comments} | {date} | {rate}% |

## Content Patterns

### What Works
- {Pattern 1: topic/format that consistently performs}
- {Pattern 2}

### Underperforming
- {Pattern that gets below-average views}

## SEO Opportunities

| Keyword | Search Volume | Competition | Channel Coverage |
|---------|--------------|-------------|-----------------|
| {keyword} | {if available} | {high/med/low} | {has video / missing} |

## Recommendations

1. **{Recommendation}** — {Why and expected impact}
2. **{Recommendation}** — {Why and expected impact}
3. **{Recommendation}** — {Why and expected impact}

チャンネルの比較

チャンネルを比較する場合は、次の内容を提示してください。

## Channel Comparison

| Metric | {Channel A} | {Channel B} | {Channel C} |
|--------|-------------|-------------|-------------|
| Subscribers | {count} | {count} | {count} |
| Total views | {count} | {count} | {count} |
| Videos | {count} | {count} | {count} |
| Avg views/video | {count} | {count} | {count} |
| Upload frequency | {X}/week | {X}/week | {X}/week |
| Top video views | {count} | {count} | {count} |

重要な注意事項

• YouTube Data API の 1 日あたりの割り当て上限は 10,000 単位です。検索 1 回につき 100 単位、動画またはチャンネルの照会 1 回につき 1〜3 単位を消費します。API 呼び出しは効率的に行ってください。
• 割り当てを節約するため、動画 ID をまとめて 1 回のリクエストに含めてください（1 回あたり最大 50 件）。
• チャンネル登録者数が 1,000 人未満の場合、YouTube では非表示になります。この場合、API は 0 を返します。
• クリエイターが高評価数を非表示にしている場合、likeCount を取得できないことがあります。
• API の結果は公開データのみです。非公開の分析データ（総再生時間、CTR、視聴者維持率）を取得するには、チャンネル所有者が YouTube Studio または OAuth を使用した YouTube Analytics API を利用する必要があります。