youtube-research

YouTube リサーチ

ワークスペースのコンテキスト

質問する前に、ブートストラップ用のコンテキストを確認してください。ブランド、オーディエンス、オファー、チャネル、ツール、制約、指標については strategy/brand.md を、個人の語り口については about/me.md を、コンテンツ計画については content/ideas.md と content/calendar.md を確認してください。以前のプロダクトマーケティング関連のコンテキストファイルは、ほかに手がかりがない場合にのみ使用してください。生成したドラフトは content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md に保存し、長期的に役立つ学びは strategy/brand.md、about/me.md、または content/ideas.md に反映してください。

運用上の契約

このスキルは、フロントマターで定義された範囲について自己完結しています。ローカルの指示、参照資料、スクリプト、アセットを手引きとして使用してください。不足しているタスク固有の入力のみを尋ね、範囲を広げるのではなく関連するスキルに引き継ぎ、実行可能な成果物、判断、計画、ドラフト、または診断を返してください。

1つのスキルで3つのモードを提供します。

1. トピックリサーチ — 動画を企画する前に、競合状況、コンテンツのギャップ、戦略的な洞察を調査します
2. 動画分析 — トランスクリプトを詳細に分析し、バイラルの定石や視聴者維持の仕組みを抽出します
3. API クエリ — YouTube Data API v3 に直接アクセスして、検索、統計、コメント、チャンネル情報を取得します

---

使用するタイミング

• 制作を企画する前に動画のトピックを調査するとき
• 競合動画を分析し、効果を上げている要因を抽出するとき
• API 経由でチャンネルの統計、動画の指標、コメントを取得するとき
• ニッチ分野のコンテンツのギャップや機会を特定するとき

---

YouTube Data API のセットアップ

1. API キーを取得する

1. Google Cloud Console → APIs & Services → Library に移動します
2. YouTube Data API v3 を有効にします
3. Create Credentials → API Key を選択します

export YOUTUBE_API_KEY="your-api-key-here"

重要： curl の出力をパイプで渡す場合は、環境変数を保持するため、コマンドを bash -c '...' で囲んでください。

bash -c 'curl -s "https://..." -H "..." | jq .'

2. 主な API コマンド

動画を検索：

bash -c 'curl -s "https://www.googleapis.com/youtube/v3/search?part=snippet&q=YOUR_QUERY&type=video&maxResults=10&order=viewCount&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {videoId: .id.videoId, title: .snippet.title, channel: .snippet.channelTitle}'

動画の詳細を取得（統計、再生時間）：

bash -c 'curl -s "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics,contentDetails&id=VIDEO_ID&key=${YOUTUBE_API_KEY}"' | jq '.items[0] | {title: .snippet.title, views: .statistics.viewCount, likes: .statistics.likeCount, duration: .contentDetails.duration}'

ハンドル名でチャンネルを取得：

bash -c 'curl -s "https://www.googleapis.com/youtube/v3/channels?part=snippet,statistics&forHandle=@HANDLE&key=${YOUTUBE_API_KEY}"' | jq '.items[0] | {id: .id, title: .snippet.title, subscribers: .statistics.subscriberCount, videos: .statistics.videoCount}'

動画のコメントを取得：

bash -c 'curl -s "https://www.googleapis.com/youtube/v3/commentThreads?part=snippet&videoId=VIDEO_ID&maxResults=20&order=relevance&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {author: .snippet.topLevelComment.snippet.authorDisplayName, text: .snippet.topLevelComment.snippet.textDisplay, likes: .snippet.topLevelComment.snippet.likeCount}'

トレンド動画を取得：

bash -c 'curl -s "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&chart=mostPopular&regionCode=US&maxResults=10&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {title: .snippet.title, channel: .snippet.channelTitle, views: .statistics.viewCount}'

割り当て量： 1 日あたり 10,000 ユニット。検索は 100 ユニット、その他のほとんどは 1 ユニットです。

詳細については、YouTube Data API docs を参照してください。

---

モード 1：トピックリサーチ

新しい動画を企画する前に調査します。データを並べるのではなく、洞察と大きな効果をもたらす要因に焦点を当ててください。

ワークフロー

ステップ 0：リサーチファイルを作成する

すべてのリサーチを次の場所に保存します：./youtube/episode/[episode_number]_[topic_short_name]/research.md

すでにファイルがある場合は、読み込んで前回の続きから進めてください。

ステップ 1：トピックを理解する

• この動画はどのような問題を解決しますか？
• どのような理由で視聴者はクリックしますか？
• 今このトピックが関連性を持つのはなぜですか？

ステップ 2：自分のチャンネルを調査する

API を使って、すでに公開した関連動画を探してください。次の内容を記録します。

• 関連動画（タイトル、動画 ID、URL、主な指標）
• すでに取り上げた内容と、差別化の方法

ステップ 3：競合を調査する

トピックに関する上位動画を 5～8 本検索します。それぞれについて、次の内容を確認します。

• 動画の詳細（再生回数、高評価数、再生時間）を取得する
• タイトル、切り口、成功している要因を記録する
• 共通するパターンやアプローチをまとめる

ステップ 4：コンテンツのギャップを分析する

次の内容を記録します。

• 飽和している内容 — 過剰に取り上げられている切り口を 3～5 個
• ギャップ（機会） — ⭐⭐⭐ 高／⭐⭐ 中／⭐ 低で評価
• 推奨する焦点 — 具体的な切り口と独自の価値提案

評価基準：

• ⭐⭐⭐ 高：大きなギャップ、強い需要、明確な差別化
• ⭐⭐ 中：中程度のギャップ、ある程度の競合、十分な可能性
• ⭐ 低：小さなギャップ、競争が激しい

リサーチファイルのテンプレート

# [Episode]: [Topic] - Research

## Episode Overview
**Topic**: [Brief description]
**Target Audience**: [Who this is for]
**Goal**: [What viewers will learn/gain]

## YouTube Research
### Your Previous Videos
[Related videos with metrics]

### Top Competing Videos
[5-8 videos: title, channel, views, angle, what works]

### Key Insights
[Patterns and findings synthesized]

## Content Gap Analysis
### What's Already Well-Covered
[List]

### Content Gaps (Opportunities)
[Rated list with ⭐ ratings]

### Recommended Focus
[Specific angle and unique value proposition]

## Production Notes
**Status**: Research Complete
**Created**: [Date]

並行リサーチ

ホスト環境が並行リサーチに対応している場合は、競合の検索、自分のチャンネルの確認、コメントの調査など、焦点を絞ったタスクに分割してください。対応していない場合は、順番に進め、各セクションの後に調査結果をまとめてください。

落とし穴

• データの羅列 — 競合は5～8件に絞り、すべての動画を列挙するのではなく、パターンをまとめます
• 曖昧なギャップ — 「このテーマのコンテンツはあまりない」ではなく、具体的に不足している切り口を特定します
• 長すぎるレポート — インサイトと大きな効果をもたらす要素に焦点を当てます

次のステップ： この調査に基づいて動画を企画するには、youtube-content スキルを使用します。

---

モード 2：動画分析

動画のトランスクリプトを綿密に分解し、バイラルの法則、フック、視聴維持の仕組みを抽出します。

トランスクリプトの取得

自動取得：

python skills/youtube-research/scripts/fetch_transcript.py "YOUTUBE_URL_OR_VIDEO_ID"

手動で貼り付け： YouTube の組み込みトランスクリプト（「...」→「文字起こしを表示」をクリック）または ytscribe.ai を使用します。

分析フレームワーク

トランスクリプトを犯罪現場のように捉え、体系的にあらゆる要素を抽出します。完全なチェックリストとテンプレートについては、reference/analysis-framework.md を参照してください。

以下の11の観点を分析します。

1. フックの構造 — メインフック（最初の3～8秒）、フックの種類、サブフック、穴埋め式テンプレート
2. 構成の設計図 — コンテンツの枠組み（PAS、ストーリー・教訓・CTA、リスト・詳細・まとめ）、ビートマップ、ペース配分
3. 視聴維持の仕組み — オープンループ、パターンの中断、好奇心のギャップ、報酬のポイント
4. 感情の設計 — 感情の弧、トリガーワード、アイデンティティフック、「私たち対彼ら」の構図
5. ストーリーテリングの要素 — 物語の枠組み、登場人物の位置づけ、対立・賭けられたもの、具体性
6. 言語のパターン — 力強いフレーズ、文のリズム、反復、会話を促すきっかけ
7. アルゴリズムのシグナル — 視聴時間を伸ばす要素、エンゲージメントを促す仕掛け、共有・保存を促すきっかけ
8. CTA の構造 — メイン CTA、控えめな CTA、タイミング、価値の交換
9. バイラル係数 — 共有されやすさのスコア（1～10）、コメントを促す仕掛けの密度、他分野への展開の可能性
10. 再利用可能なテンプレート — 穴埋め式の冒頭フック（3パターン）、セクションテンプレート、トランジション集
11. 実践ガイド — そのまま活用できる上位10の要素、ニッチに合わせた調整、A/B テストの提案

分析の前に、背景情報を収集する

• あなたのニッチ／テーマ
• あなたのコンテンツスタイル（カジュアル、教育的、ハイテンションなど）
• 対象プラットフォームと動画の目標尺

出力形式

11のセクションすべてを含めて構成します。抽出したパターンをすぐに実践できるよう、最後に1ページの要約 クイックリファレンス・チートシート を付けます。

---

ツール

• YouTube API：bash -c 'curl ...' と $YOUTUBE_API_KEY を使用
• MCP（利用可能な場合）：mcp__plugin_yt-content-strategist_youtube-analytics__search_videos、get_video_details、get_channel_details
• Web：業界のトレンドや背景情報の調査に WebSearch と WebFetch を使用