mcpField
Y
youtube-research

youtube-research

github.com/crawlora-org生産性140 回インストール2 日前に更新
リポジトリ

youtube-research について

youtube-researchは、Crawlora APIを通じて公開YouTube動画やチャンネルを調査するスキルです。分析担当者やコンテンツ研究者向けに、字幕、コメント、メタデータ、投稿動画、プレイリスト、検索結果を取得し、根拠に基づく要約や比較を支援します。

主な機能

  1. 01タイムスタンプ付き字幕の取得
  2. 02動画メタデータとコメントの取得
  3. 03チャンネル動画、Shorts、プレイリストの一覧
  4. 04キーワードによるYouTube動画検索
  5. 05字幕に基づくトピック調査

活用シーン

  1. 01字幕を使った動画の要約
  2. 02コメントの感情やテーマの分析
  3. 03チャンネルの最近の投稿一覧の作成
  4. 04タイムスタンプ付き字幕による動画比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill youtube-research

インストール後、Claude Code で/youtube-researchを入力して読み込まれたか確認します。

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

YouTube リサーチ

Crawlora API から YouTube の動画やチャンネルを特定し、文字起こし、コメント、再生リスト、検索結果を正規化された JSON として取得します。yt-dlp、ブラウザー、スクレイピングは不要です。

このスキルを使う場面

  • ユーザーが YouTube の URL を貼り付け、文字起こし、要約、または統計情報を求めている場合。
  • 「この動画のコメントを取得して」／「みんなは何と言っていますか？」
  • 「このチャンネルの最近の動画／ショート／再生リストを一覧表示して」
  • 「YouTube で…を検索して」または「…についてどんな動画がありますか？」
  • 文字起こしに基づく要約、センチメント分析、またはリサーチのパイプラインを構築する場合。
  • タイムスタンプ付きの文字起こしを根拠として、対象を限定した動画セットを比較する場合。

セットアップ（初回のみ）

  • 無料の Crawlora API キー（毎月 2,000 クレジット、カード不要）を https://crawlora.net で取得します。
  • ヘルパーを実行する前に、環境で CRAWLORA_API_KEY を設定します。
  • ヘルパーは環境から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

  1. ID を特定します。 YouTube の視聴 URL https://www.youtube.com/watch?v=<ID> （または https://youtu.be/<ID>）からは動画 IDを取得でき、チャンネル URL からは チャンネル IDを取得できます。呼び出す前に ID を抽出します。
  2. 文字起こし： /youtube/transcript/{id}（特定の言語が必要な場合は、先に /youtube/transcript/{id}/languages を使用します）。
  3. メタデータ／コメント： /youtube/video/{id}、/youtube/comments/{id}。
  4. チャンネル： /youtube/channel/{id}/videos、/channel/{id}/shorts、 /channel/{id}/playlists、/youtube/profile/{id}。
  5. 検索： キーワードで動画を探すには /youtube/search?q=... を使用します。

すべてのエンドポイント、メソッド、パラメーターについては、reference/endpoints.md を参照してください。

文字起こしに基づくトピック調査

トピックの概要を作成する場合は、まず検索し、動画 ID で重複を除外してから、指定された日付、言語、動画の種類を反映した対象数を限定したサンプルを選びます。字幕を取得する前に、利用可能な文字起こし言語を確認します。根拠を抽出するためにタイムスタンプ付きの JSON をリクエストし、各テーマや主張を実際の字幕セグメントと動画 URL に結び付けます。字幕や翻訳では音声を聞き間違えることがあり、それだけで事実に関する主張を独立して検証することはできません。文字起こしを利用できない場合はその旨を報告し、検索順位、再生回数、コメントのサンプルは需要と分けて扱います。

複数の動画やチャンネルにわたるトピックや形式の網羅状況をより広く把握するには、インストールされている場合は youtube-content-gap-analysis を使用します。

scripts/crawlora.sh /youtube/search q="home energy storage" type=video sort_by=relevance
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ/languages
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ format=json timestamps=true

API の呼び出し

# Transcript for a video id (GET):
scripts/crawlora.sh /youtube/transcript/dQw4w9WgXcQ | jq '.'

# Video metadata + comments:
scripts/crawlora.sh /youtube/video/dQw4w9WgXcQ | jq '.data'
scripts/crawlora.sh /youtube/comments/dQw4w9WgXcQ | jq '.data'

# Search:
scripts/crawlora.sh /youtube/search q="web scraping tutorial" | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用します。API キーがコマンドライン引数に露出しないようにできます。

エンドポイントリファレンス

このスキルで使用するすべての YouTube エンドポイント（メソッド、パス、パラメーター、説明）については、reference/endpoints.md を参照してください。

例

  • 動画を要約する： URL から ID を抽出 → /youtube/transcript/{id} → 文字起こしの各セグメントを結合 → 要約。
  • コメントのセンチメント分析： /youtube/comments/{id} → コメントをセンチメント別に分類し、 共通するテーマを提示。
  • チャンネルのダイジェスト： /youtube/channel/{id}/videos → 最近の投稿を再生回数と 公開日とともに一覧表示。

注意事項と制限

  • クレジット／成功時のみ課金： 課金対象は 2xx の場合のみです。無料プランでは毎月 2,000 クレジットを利用できます。 キーは https://crawlora.net で取得してください。
  • 公開データのみ — 公開されている YouTube ページが対象です。YouTube の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY のみに保存し、ハードコード、クエリパラメーターへの指定、コミットは絶対にしないでください。
  • すべての動画に字幕があるとは限りません。文字起こしのリクエスト結果が空の場合は、/youtube/transcript/{id}/languages を確認してください。

コメント

Markdown 対応