Youtube Research Mcp

YouTube Research MCP

🇺🇸 English

将 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 密钥。免费申请，每天提供 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 密钥（可选）

搜索和评论功能需要此密钥。免费，每天有 10,000 个单位——普通使用不会耗尽。

1. 访问 Google Cloud Console
2. 创建新项目
3. APIs & Services → Library → 搜索 YouTube Data API v3 → 启用
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
❌	不会访问缓存目录以外的本地文件
❌	不会执行 Shell 命令或访问系统

字幕和评论中包含 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