YouTube MCP Server

MCP-Server, der YouTube zu Claude Code bringt – Videotranskripte, Suche, Metadaten, Kanalinformationen, Playlists, Kommentare, Trendvideos, Engagement-Analysen, Kapitel-Extraktion, SponsorBlock-Integration und Heatmaps der am häufigsten wiederholten Stellen. Verwendet die YouTube Data API v3, youtube-transcript und SponsorBlock.

Schnellstart

Schritt 1: API-Schlüssel abrufen

1. Gehen Sie zu Google Cloud Console

2. Erstellen Sie ein Projekt (oder wählen Sie ein vorhandenes aus)

3. Aktivieren Sie die YouTube Data API v3:

   • Gehen Sie zur API-Bibliothek

   • Klicken Sie auf Aktivieren

4. Erstellen Sie einen API-Schlüssel:

   • Gehen Sie zu Anmeldedaten

   • Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel

5. Kopieren Sie den Schlüssel (Sie benötigen ihn in Schritt 3)

Schritt 2: Voraussetzungen installieren

• Node.js 18+ - Hier herunterladen

• Claude Code CLI - Installationsanleitung

Schritt 3: MCP-Server installieren

3.1 Repository klonen

git clone https://github.com/wynandw87/claude-code-youtube-mcp.git
cd claude-code-youtube-mcp

3.2 Abhängigkeiten installieren

macOS / Linux / Windows:

npm install

Hinweis: Die Abhängigkeiten werden installiert und der Server wird automatisch in einem Schritt erstellt.

3.3 Bei Claude Code registrieren

Wählen Sie Ihren Installationsumfang:

Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen YouTube-Data-API-Schlüssel und verwenden Sie den vollständigen Pfad zu dist/index.js.

Tipp: Um den vollständigen Pfad zu erhalten, führen Sie dies aus dem geklonten Verzeichnis aus:

• macOS/Linux: echo "$(pwd)/dist/index.js"

• Windows: echo %cd%\dist\index.js

macOS / Linux:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_API_KEY -- node /full/path/to/dist/index.js

Windows (CMD):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" -- node "C:\full\path\to\dist\index.js"

Windows (PowerShell):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" '--' node "C:\full\path\to\dist\index.js"

Alternative: npm-Helfer verwenden (wenn der API-Schlüssel in der Umgebung festgelegt ist)

export YOUTUBE_API_KEY=YOUR_API_KEY
npm run install:claude

Schritt 4: Claude Code neu starten

Schließen Sie Claude Code und öffnen Sie es erneut, damit die Änderungen wirksam werden.

Schritt 5: Installation überprüfen

claude mcp list

Sie sollten youtube mit dem Status „Verbunden“ aufgelistet sehen.

Related MCP server: youtube-research

Funktionen

Transkripte & Untertitel

• Get Transcript (get_transcript) – Vollständige Videotranskripte mit Zeitstempeln abrufen, unterstützt mehrere Sprachen

• Search Transcript (search_transcript) – Finden, wo ein Schlüsselwort oder eine Phrase in einem Video mit Zeitstempeln vorkommt

• Clean Transcript (get_clean_transcript) – Transkript ohne Sponsor-Abschnitte, Intros, Outros und Füllmaterial, entfernt über SponsorBlock

• Extract Chapters (extract_chapters) – Kapitel-Zeitstempel aus Videobeschreibungen extrahieren

Suche & Entdeckung

• Search Videos (search_videos) – Vollständige YouTube-Suche mit Filtern nach Datum, Dauer, Typ und Sortierreihenfolge

• Search Within Channel (search_within_channel) – Suche nach Videos von einem bestimmten Ersteller

• Get Trending Videos (get_trending_videos) – Aktuell trendende Videos nach Region und Kategorie

• Get Channel Videos (get_channel_videos) – Neueste Uploads eines Kanals, sortiert nach Datum oder Aufrufen

Video- & Kanalinformationen

• Video Metadata (get_video_metadata) – Titel, Beschreibung, Dauer, Aufrufe, Likes, Tags und mehr

• Channel Info (get_channel_info) – Abonnentenzahl, Videoanzahl, Beschreibung, Land

• Playlist Items (get_playlist_items) – Alle Videos in einer Playlist mit Positionen und Metadaten

Analysen & Engagement

• Calculate Engagement (calculate_engagement) – Like-Rate, Kommentarrate und Engagement-Rate aus öffentlichen Statistiken

• Most Replayed (get_most_replayed) – Heatmap-Daten, die zeigen, welche Teile Zuschauer am häufigsten erneut ansehen

• Video Comments (get_video_comments) – Top-Kommentare mit Like- und Antwortzahlen

Hilfsprogramme

• Parse YouTube URL (parse_youtube_url) – Video-/Kanal-/Playlist-IDs aus jedem YouTube-URL-Format extrahieren

Verwendung

Nach der Installation verwenden Sie Auslösephrasen, um YouTube-Tools aufzurufen:

Oder fragen Sie natürlich:

• „Holen Sie das Transkript dieses YouTube-Videos und fassen Sie es zusammen“

• „Was sind die am häufigsten erneut angesehenen Teile dieses Videos?“

• „Finden Sie aktuelle Videos über TypeScript auf diesem Kanal“

• „Wie viele Aufrufe und Likes hat dieses Video?“

• „Holen Sie die Kommentare zu diesem Video und fassen Sie die Stimmung zusammen“

• „Zeigen Sie mir die Kapitel für dieses Tutorial“

• „Holen Sie ein sauberes Transkript ohne Sponsor-Einblendungen“

• „Was ist gerade auf YouTube im Gaming-Bereich im Trend?“

Tool-Referenz

parse_youtube_url

Analysiert jedes YouTube-URL-Format und extrahiert Kennungen. Kein API-Schlüssel erforderlich.

Parameter:

• url (string, erforderlich) – Jede YouTube-URL oder Video-ID

Unterstützte Formate: youtube.com/watch?v=, youtu.be/, /shorts/, /embed/, /playlist?list=, /channel/, /@handle, /c/, /user/, reine Video-IDs

get_transcript

Ruft das vollständige Transkript/die Untertitel eines YouTube-Videos ab. Kein API-Schlüssel erforderlich.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

• lang (string, optional) – Sprachcode für Untertitel (Standard: "en")

search_transcript

Durchsucht das Transkript eines Videos nach einem Schlüsselwort oder einer Phrase.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

• query (string, erforderlich) – Schlüsselwort oder Phrase, nach der gesucht werden soll

• lang (string, optional) – Sprachcode für Untertitel (Standard: "en")

extract_chapters

Extrahiert Kapitel-Zeitstempel aus der Beschreibung eines Videos.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

get_clean_transcript

Ruft Transkript ab, bei dem Sponsor-Einblendungen, Intros, Outros und Füllmaterial über SponsorBlock entfernt wurden.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

• lang (string, optional) – Sprachcode für Untertitel (Standard: "en")

get_most_replayed

Ruft die Heatmap-Daten „Most Replayed“ ab, die zeigen, welche Teile Zuschauer am häufigsten erneut ansehen.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

Hinweis: Erfordert ungefähr 50.000+ Aufrufe, damit Heatmap-Daten verfügbar sind.

search_videos

Durchsucht YouTube mit vollständiger Filterunterstützung.

Parameter:

• query (string, erforderlich) – Suchanfrage

• max_results (number, optional) – Anzahl der Ergebnisse, 1-50 (Standard: 10)

• order (string, optional) – "relevance", "date", "viewCount", "rating" (Standard: "relevance")

• duration (string, optional) – "short" (<4 Min.), "medium" (4-20 Min.), "long" (>20 Min.)

• upload_date (string, optional) – "hour", "day", "week", "month", "year"

• type (string, optional) – "video", "channel", "playlist" (Standard: "video")

get_video_metadata

Ruft detaillierte Metadaten für ein YouTube-Video ab.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

Rückgabe: Titel, Beschreibung, Kanal, Dauer, Aufruf-/Like-/Kommentaranzahl, Tags, Kategorie, Thumbnails, Live-Status und mehr.

get_channel_info

Ruft YouTube-Kanalinformationen ab.

Parameter:

• url (string, erforderlich) – YouTube-Kanal-URL, @handle oder Kanal-ID

Rückgabe: Titel, Beschreibung, Abonnenten-/Video-/Aufrufzahlen, Land, benutzerdefinierte URL und Thumbnail.

get_playlist_items

Ruft alle Videos in einer YouTube-Playlist ab.

Parameter:

• url (string, erforderlich) – YouTube-Playlist-URL oder Playlist-ID

• max_results (number, optional) – Anzahl der Elemente, 1-50 (Standard: 25)

get_channel_videos

Ruft aktuelle Videos von einem YouTube-Kanal ab.

Parameter:

• url (string, erforderlich) – YouTube-Kanal-URL, @handle oder Kanal-ID

• max_results (number, optional) – Anzahl der Videos, 1-50 (Standard: 25)

• order (string, optional) – "date", "viewCount" (Standard: "date")

get_trending_videos

Ruft aktuell trendende/populäre YouTube-Videos ab.

Parameter:

• region_code (string, optional) – ISO-3166-1-Alpha-2-Ländercode (Standard: "US")

• category_id (string, optional) – YouTube-Kategorie-ID (z. B. "10" für Musik, "20" für Gaming, "28" für Wissenschaft & Technik)

• max_results (number, optional) – Anzahl der Ergebnisse, 1-50 (Standard: 10)

search_within_channel

Durchsucht einen bestimmten YouTube-Kanal nach Videos.

Parameter:

• url (string, erforderlich) – YouTube-Kanal-URL, @handle oder Kanal-ID

• query (string, erforderlich) – Suchanfrage

• max_results (number, optional) – Anzahl der Ergebnisse, 1-50 (Standard: 10)

get_video_comments

Ruft Top-Level-Kommentare von einem YouTube-Video ab.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

• max_results (number, optional) – Anzahl der Kommentare, 1-100 (Standard: 20)

• order (string, optional) – "relevance", "time" (Standard: "relevance")

calculate_engagement

Berechnet Engagement-Kennzahlen für ein YouTube-Video.

Parameter:

• url (string, erforderlich) – YouTube-Video-URL oder Video-ID

Rückgabe: Aufrufanzahl, Like-Anzahl, Kommentar-Anzahl, Like-Rate, Kommentarrate und Gesamt-Engagement-Rate.

So funktioniert es

Dieser MCP-Server verbindet sich über den stdio-Transport mit Claude Code und stellt 15 Tools bereit:

Hinweis: 5 Tools funktionieren ohne API-Schlüssel (Transkripte, SponsorBlock, Heatmaps, URL-Parsing). Die übrigen 10 erfordern einen YouTube-Data-API-v3-Schlüssel.

Konfiguration

Umgebungsvariablen

YouTube-API-Kontingent

Die YouTube Data API v3 hat ein tägliches Kontingent von 10.000 Einheiten. Jedes Tool verbraucht unterschiedlich viele Einheiten:

Tipp: Suchoperationen sind am teuersten. Verwenden Sie get_channel_videos (1 Einheit) anstelle von search_within_channel (100 Einheiten), wenn Sie nur aktuelle Uploads benötigen.

Fehlerbehebung

API-Schlüssel korrigieren

Wenn Sie einen falschen API-Schlüssel eingegeben haben, entfernen Sie die Installation und installieren Sie neu:

claude mcp remove youtube

Installieren Sie dann mit dem Befehl aus Schritt 3.3 oben neu (verwenden Sie denselben Scope, mit dem Sie ursprünglich installiert haben).

MCP-Server wird nicht angezeigt

Prüfen Sie, ob der Server installiert ist:

claude mcp list

Falls er nicht aufgeführt ist, folgen Sie Schritt 3, um ihn zu installieren.

Server startet nicht

1. Prüfen Sie, ob Ihr API-Schlüssel in der Google Cloud Console gültig ist.

2. Prüfen Sie, ob die YouTube Data API aktiviert ist:

   • Gehen Sie zur API-Bibliothek

   • Dort sollte „Enabled“ stehen.

3. Prüfen Sie die Node.js-Version (erforderlich: 18+):

   node --version

4. Stellen Sie sicher, dass der Server erstellt wurde — falls dist/index.js fehlt, führen Sie npm install erneut aus.

Verbindungsfehler

1. Prüfen Sie, dass dist/index.js existiert — falls nicht, führen Sie npm install aus.

2. Überprüfen Sie, ob der Pfad in Ihrem claude mcp add-Befehl absolut ist.

3. Starten Sie Claude Code nach Konfigurationsänderungen neu.

Kontingent überschritten

Wenn Sie "quotaExceeded"-Fehler sehen:

• Warten Sie bis Mitternacht Pacific Time (das Kontingent wird täglich zurückgesetzt).

• Verwenden Sie einen anderen API-Schlüssel.

• Bevorzugen Sie kostengünstige Tools (get_video_metadata mit 1 Einheit) gegenüber Such-Tools (100 Einheiten).

Transkript nicht verfügbar

Bei einigen Videos sind Transkripte deaktiviert. Das Tool get_transcript gibt eine klare Fehlermeldung zurück. Versuchen Sie:

• Einen anderen Sprachcode (z. B. lang: "es")

• Automatisch erzeugte Untertitel sind möglicherweise verfügbar, auch wenn manuelle nicht vorhanden sind.

Timeout-Fehler

Erhöhen Sie die Umgebungsvariable YOUTUBE_TIMEOUT für langsame Verbindungen:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_KEY -e YOUTUBE_TIMEOUT=60000 -- node /path/to/dist/index.js

Aktuelle Konfiguration anzeigen

claude mcp list

Mitwirken

Pull Requests sind willkommen! Bitte halten Sie es einfach und anfängerfreundlich.

Lizenz

MIT

Für die Claude Code Community erstellt.