Youtube Research Mcp

YouTube Research MCP

🇺🇸 英語

YouTube上のあらゆる情報を — 字幕、コメント、チャンネルをAIリサーチの情報源に。

AIに頼むだけで、字幕の収集、コメントの世論分析、複数動画の比較まで、すべてAIが直接処理します。 APIキーがなくても、字幕・チャンネル分析をすぐに利用できます。

---

どこで使えますか？

MCP（Model Context Protocol）に対応したAIクライアントなら、どこでも利用できます。

クライアント	対応状況
Claude Desktop	✅
Cursor	✅
Windsurf	✅
Cline	✅
MCP対応クライアント全般	✅

---

こんなことができます

AIチャット画面に、話しかけるように入力するだけです。

APIキーなしですぐに使う

이 영상 핵심만 요약해줘: https://www.youtube.com/watch?v=tTw1z10yMCI

@fireship 채널 최근 영상 5개 분석해서 요즘 어떤 기술 주제 다루는지 알려줘

이 3개 영상 비교해서 각자 어떤 주장 하는지, 공통점·차이점 정리해줘:
https://www.youtube.com/watch?v=aaa
https://www.youtube.com/watch?v=bbb
https://www.youtube.com/watch?v=ccc

APIキーがあればコメントの世論分析も

오늘 한국 주식 다룬 유튜버 영상 3개 댓글까지 조사해서 시장 이슈랑 분위기 체크해줘

이 스마트폰 리뷰 영상 — 크리에이터 평가랑 실제 댓글 반응이 얼마나 다른지 비교해줘

"AI 에이전트" 영상 4개 검색해서 각자 어떤 주장인지 비교하고, 댓글 반응도 정리해줘

実際にはどのような回答が返ってきますか？

👤 入力：

「このスマートフォンのレビュー動画の主な長所と短所をまとめて、コメントで最も多く繰り返されている不満を3つ教えて。」

🤖 AIの回答：

「動画では、制作者がカメラ性能とバッテリーを主な長所として挙げています。しかし、収集したコメントの分析結果では、実際のユーザーが最も多く挙げている不満は、①発熱の問題、②特定のアプリでのフレーム落ち、③充電速度でした。動画の肯定的な評価と実際のユーザー体験には、温度差があります。」

---

機能の概要

機能	APIキーなし	APIキーあり
動画の字幕収集	✅	✅
動画メタデータの取得	✅（yt-dlp経由）	✅
チャンネルの最新動画の分析	✅（yt-dlp経由）	✅
キーワード検索	❌	✅
コメント収集と世論分析	❌	✅
API使用量の確認	❌	✅

コメント・検索機能にはYouTube Data APIキーが必要です。無料で取得でき、1日あたり10,000ユニットが提供されます。

---

インストール

おすすめ — uvxでインストールせずにすぐ使う

uvをインストールするだけで、環境を別途設定せずにすぐ接続できます。

# uv 설치 (아직 없다면)
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS / Linux
# 또는: winget install astral-sh.uv               # Windows

代替方法 — pipでインストール

pip install youtube-research-mcp

---

MCPクライアントの接続

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.jsonファイルに追加します。

ファイルがない場合は新しく作成してください。Claude Desktopを一度起動すると、フォルダーが作成されます。

APIキーなし（字幕＋チャンネル分析）

{
  "mcpServers": {
    "youtube-research": {
      "command": "uvx",
      "args": ["youtube-research-mcp"]
    }
  }
}

APIキーあり（すべての機能）

{
  "mcpServers": {
    "youtube-research": {
      "command": "uvx",
      "args": ["youtube-research-mcp"],
      "env": {
        "YOUTUBE_API_KEY": "AIzaSy..."
      }
    }
  }
}

Cursor／Windsurf／その他のMCPクライアント

各クライアントのMCP設定ファイルに同じ方法で追加してください。commandとargsは同じです。

設定を保存した後、クライアントを完全に終了して再起動すると反映されます。

pipでインストールした場合は、"command": "youtube-research-mcp"、"args": []に設定してください。

---

YouTube APIキーの取得（任意）

検索・コメント機能に必要です。無料で、1日あたり10,000ユニットを利用できます。通常の使用で上限に達することはありません。

1. Google Cloud Consoleにアクセス
2. 新しいプロジェクトを作成
3. APIs & Services → LibraryでYouTube Data API v3を検索し、Enableをクリック
4. APIs & Services → Credentials → + Create Credentials → API key
5. 生成されたキーをコピー

セキュリティ設定の推奨事項： Edit API key → API restrictions → YouTube Data API v3のみを許可

---

インストールしても安全ですか？

一言で言うと、はい、安全です。

	このサーバーが行うこと
✅	YouTubeから字幕とメタデータを取得します
✅	結果をローカルのSQLiteファイルにキャッシュします
✅	APIキーを設定した場合にのみ、YouTube Data API v3を呼び出します
❌	収集したデータを外部サーバーに送信しません
❌	LLM・AI APIを呼び出しません
❌	キャッシュディレクトリ以外のローカルファイルにアクセスしません
❌	シェルコマンドの実行やシステムへのアクセスを行いません

字幕とコメントにはsafety_noticeフィールドが含まれ、プロンプトインジェクションを防ぎます。 ソースコード全体はGitHubで公開されています。

---

設計原則

• LLMの呼び出しなし — データ収集のみを担当します。分析・要約・判断はAIアシスタントが行います。
• プロンプトインジェクション対策 — 字幕とコメントにsafety_noticeを含め、外部コンテンツであることを明示します。
• API料金の急増を防止 — 字幕・コメント・検索結果をSQLiteにキャッシュし、重複した呼び出しを防ぎます。
• キーなしでも主要機能を利用可能 — 字幕収集とチャンネル分析は、yt-dlpを使ってAPIキーなしで動作します。

---

ツール一覧

APIキーなしで利用可能

get_transcript — 動画の字幕を取得

이 영상 핵심 내용만 요약해줘:
https://www.youtube.com/watch?v=tTw1z10yMCI

パラメーター	説明	デフォルト値
url_or_video_id	YouTube URLまたはvideo ID	必須
languages	字幕の言語の優先順位（例：["ko", "en"]）	自動選択

---

analyze_videos — 여러 영상 한 번에 분석

URL 목록을 주면 자막·메타데이터를 병렬 수집합니다. API 키가 있으면 댓글도 함께 수집합니다.

이 3개 영상 분석해서 각자 어떤 주장인지, 공통점과 차이점 정리해줘:
https://www.youtube.com/watch?v=aaa
https://www.youtube.com/watch?v=bbb
https://www.youtube.com/watch?v=ccc

파라미터	설명	기본값
urls_or_video_ids	URL 또는 video ID 목록	필수
languages	자막 언어 우선순위	자동 선택
include_comments	댓글 포함 여부 (⚠️ API 키 필요)	true
max_comments_per_video	영상당 최대 댓글 수	25
max_transcript_chars	자막 최대 글자 수 (0 = 제한 없음)	8000

---

analyze_channel — 채널 분석

채널 핸들(@채널명) 또는 채널 ID로 최신 영상 N개를 수집·분석합니다.

@ycombinator 채널 최근 영상 5개 보고 어떤 스타트업 트렌드 다루는지 분석해줘

파라미터	설명	기본값
channel_id_or_handle	채널 핸들 또는 ID	필수
max_videos	수집할 영상 수 (최대 8)	5
min_duration_seconds	최소 영상 길이 (초)	120
max_duration_seconds	최대 영상 길이 (초)	7200
include_comments	댓글 포함 여부 (⚠️ API 키 필요)	true

---

get_capabilities — 현재 사용 가능한 기능 확인

지금 어떤 기능을 쓸 수 있어?

---

API 키 필요

search_videos — 키워드로 영상 검색

"AI agent" 관련 최신 영상 5개 검색해줘

파라미터	설명	기본값
query	검색어	필수
max_results	최대 결과 수	5
published_after	이후 날짜 (YYYY-MM-DD)	없음
published_before	이전 날짜 (YYYY-MM-DD)	없음
exclude_shorts	쇼츠 제외 여부	false

---

get_video_comments — 댓글 수집

파라미터	설명	기본값
url_or_video_id	YouTube URL 또는 video ID	필수
max_comments	최대 댓글 수	50
order	정렬 방식 (relevance / time)	relevance
include_replies	대댓글 포함 여부	false

---

collect_video_discussion — 자막 + 댓글 한 번에

크리에이터 주장과 시청자 반응을 한 번에 비교할 때 유용합니다.

이 영상 내용이랑 댓글 반응 같이 분석해줘:
https://www.youtube.com/watch?v=tTw1z10yMCI

---

collect_research_sources — 검색 → 자막 묶음 수집

"러스트 vs 고 비교" 영상 5개 검색해서 각 영상이 어떤 결론 내리는지 정리해줘

파라미터	설명	기본값
query	검색어	필수
max_videos	수집할 영상 수 (최대 8)	5
min_duration_seconds	최소 영상 길이 (초)	120
exclude_shorts	쇼츠 제외 여부	true
min_view_count	최소 조회수	0

---

collect_research_discussions — 검색 → 자막 + 댓글 묶음 수집

가장 강력한 리서치 도구. 검색·자막·댓글을 한 번에 병렬 수집합니다.

"LLM 파인튜닝" 영상 3개 검색해서
크리에이터들이 공통으로 강조하는 것, 서로 다른 의견, 댓글에서 반복되는 질문 정리해줘

---

get_quota_usage — API 사용량 조회

오늘 사용한 YouTube API 쿼터와 남은 양을 확인합니다.

---

캐시 동작 방식

같은 영상을 여러 번 분석해도 추가 API 쿼터가 소비되지 않습니다.

데이터	캐시 유효 기간
자막	30일
댓글	6시간
검색 결과	2시간
영상 메타데이터	영구

캐시 위치 (OS 자동 선택, YOUTUBE_RESEARCH_CACHE_DB 환경 변수로 변경 가능):

• macOS: ~/Library/Application Support/youtube-research-mcp/cache.db
• Windows: %APPDATA%\youtube-research-mcp\cache.db
• Linux: ~/.local/share/youtube-research-mcp/cache.db

---

라이선스

MIT