YouTube MCP 서버

Claude를 YouTube 채널에 연결하세요. Claude Desktop, Claude Code 또는 모든 MCP 클라이언트에서 분석 읽기, 전체 동영상 메타데이터(비공개/일부 공개/초안 포함) 가져오기, 업로드 검색, 제목/설명/태그 업데이트를 수행할 수 있습니다.

이것은 무엇인가요?

OAuth2를 통해 Claude를 YouTube Data API v3 및 YouTube Analytics API에 연결하는 Model Context Protocol (MCP) 서버입니다.

YouTube 스튜디오에서 AI 도구로 데이터를 복사하는 대신, Claude에게 다음과 같이 요청하세요:

*"이 동영상의 전체 제목, 설명, 태그를 가져와줘"
*"이번 달 실적이 가장 좋은 동영상은 무엇인가요?"
*"최근 업로드한 동영상의 제목과 태그를 업데이트해줘"
*"내 트래픽은 어디에서 오나요?"

Claude는 귀하의 실제 비공개 채널 데이터를 읽고 동영상 SEO를 직접 업데이트할 수 있습니다.

Claude  →  YouTube MCP Server  →  YouTube APIs  →  Your Channel Data
(you)        (this repo)           (OAuth2)         (stays local)

모든 작업은 귀하의 기기에서 실행됩니다. 읽기 + 쓰기 액세스 권한. 제3자에게 전송되는 데이터는 없습니다.

10가지 도구 사용 가능

동영상 메타데이터 (읽기 + 쓰기)

도구	기능
`get_video_details`	ID 또는 URL로 모든 동영상의 전체 메타데이터(제목, 전체 설명, 모든 태그, 카테고리, 공개 상태(공개/일부 공개/비공개/초안), 통계, 길이, 썸네일 URL) 가져오기
`search_my_videos`	키워드로 내 채널의 동영상 검색. 일치하는 동영상의 메타데이터 + 통계 반환
`update_video_seo`	모든 동영상의 제목, 설명 및/또는 태그를 직접 업데이트. 제공한 필드만 변경

채널 분석

도구	기능
`get_channel_overview`	구독자 수, 총 조회수, 동영상 수, 채널 설명, 생성일
`get_all_videos`	통계(조회수, 좋아요, 댓글, 태그, 공개 상태)가 포함된 모든 동영상 목록. 날짜 또는 조회수별 정렬
`get_analytics_over_time`	특정 기간 동안의 일별 조회수, 시청 시간, 구독자 증감
`get_top_videos_analytics`	조회수 기준 상위 동영상(유지율 %, 시청 시간, 구독자 증가 포함)
`get_audience_demographics`	시청자 분석: 상위 국가, 기기 유형, 연령대, 성별
`get_traffic_sources`	시청자 유입 경로: YouTube 검색, 추천 동영상, 탐색 기능, 외부, 직접 유입
`analyze_and_suggest_topics`	AI 기반 주제 분석을 위해 채널 + 상위 동영상 데이터 가져오기

설치

옵션 A: npx (설치 불필요 — 바로 실행)

npx youtube-studio-mcp

옵션 B: 전역 설치

npm install -g youtube-studio-mcp

— Claude Code에 연결

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (Mac) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)을 편집하세요:

{
  "mcpServers": {
    "youtube-analytics": {
      "command": "node",
      "args": ["/full/path/to/youtube-studio-mcp/server.js"]
    }
  }
}

또는 npm을 통해 설치한 경우:

{
  "mcpServers": {
    "youtube-analytics": {
      "command": "npx",
      "args": ["-y", "youtube-studio-mcp"]
    }
  }
}

Claude Code (터미널)

claude mcp add youtube-analytics node /full/path/to/youtube-studio-mcp/server.js

VS Code

.vscode/settings.json에 추가:

{
  "mcp.servers": {
    "youtube-analytics": {
      "command": "npx",
      "args": ["-y", "youtube-studio-mcp"]
    }
  }
}

바로 사용할 수 있는 프롬프트

SEO 감사 (모든 동영상)

Get the full details for this video: [paste URL or ID]
Check what keywords it's ranking for and suggest optimized title + tags

채널 성과 보고서

Pull my channel overview, top 20 videos by watch time, 90-day analytics,
traffic sources and audience demographics. Give me a full performance report.

동영상 주제 조사

Get my top 20 videos by watch time. What patterns do you see —
topics, lengths, title styles? Suggest 10 new video ideas.

동영상 SEO 업데이트

Search my videos for "elementor menu". Pull the full details.
Write an optimized title, description, and tags — then update it.

시청자 심층 분석

Show my full audience demographics — age, gender, countries, devices.
What content style and posting schedule fits my actual audience?

실적 저조 동영상 진단

Get all my videos. Compare bottom 10 vs top 10 by views.
Why did the lower ones underperform? What would you change?

스킬과 MCP의 연동 방식

You: "Optimize this video: youtube.com/watch?v=abc123"

Claude:
  1. youtube-seo-optimizer skill activates
  2. Calls get_video_details → pulls current title, description, tags
  3. Checks YouTube SERP for current rankings
  4. Lists PROTECTED keywords (won't remove)
  5. Writes 3 new title options + full description + 20 tags
  6. Can call update_video_seo to apply changes directly

스킬은 Claude에게 무엇을 해야 할지 알려줍니다. MCP 도구는 Claude에게 데이터에 대한 액세스 권한을 제공합니다. 이 둘이 결합되어 완벽한 YouTube AI 워크플로우를 생성합니다.

스킬 설치

Claude Desktop / Claude Code:

# Copy a skill to your Claude skills directory
cp skills/youtube-seo-optimizer.md ~/.claude/skills/

또는 8개 모두 설치:

cp skills/youtube-*.md ~/.claude/skills/

OAuth 범위

범위	목적
`youtube`	동영상 메타데이터 읽기 + 쓰기 (제목, 설명, 태그)
`youtube.readonly`	동영상 데이터 읽기, 검색, 목록 조회
`yt-analytics.readonly`	비공개 분석 데이터 읽기 (조회수, 시청 시간, 구독자, 인구 통계)
`youtubepartner-channel-audit`	확장 채널 감사 데이터

쓰기 액세스 권한을 활성화하려면 (update_video_seo), tokens.json을 삭제하고 node auth.js를 다시 실행하세요. 새로운 인증 흐름에서 youtube 쓰기 범위를 요청합니다.

파일

youtube-studio-mcp/
├── server.js          ← MCP server (10 tools)
├── auth.js            ← Run once to link YouTube account
├── package.json       ← Dependencies + npm config
├── skills/            ← 8 AI skills for YouTube creators
├── LICENSE            ← MIT
├── credentials.json   ← YOU add this (never commit!)
└── tokens.json        ← Auto-created after auth (never commit!)

기여

기능

자막 추출 (YouTube 자막 API)
YouTube 쇼츠 전용 분석
수익/수익 창출 데이터 (YouTube 보고 API)
재생목록 관리 도구
댓글 관리 도구
썸네일 업로드

라이선스

Adiya Sharma MIT

YouTube MCP Server