YouTube MCP Server

Ein gehosteter Model Context Protocol (MCP)-Server, der Claude, Cursor, Windsurf und jedem anderen MCP-Client vier schreibgeschützte YouTube-Tools bietet. Durchsuchen Sie YouTube, lesen Sie Video- und Kanaldaten und rufen Sie Transkripte ab – ohne Google Cloud-Projekt und ohne YouTube Data API-Schlüssel.

https://mcp.hasdata.com/api/mcp?apis=youtube

Inhalt

• Was Sie brauchen

• Schnellstart

• Beispiel-Prompts

• Tools

• Fehler und Fehlerpfade

• Preise, kostenloser Tarif und Limits

• Tool-Auswahl

• Wie es sich vergleicht

• FAQ

• HasData-Links

• Entwicklung

• Mitwirken

• Lizenz

Related MCP server: YouTube MCP Server

Was Sie brauchen

Ein MCP-Client, der streambares HTTP mit benutzerdefinierten Headern spricht. Ein HasData-API-Schlüssel aus dem Dashboard, kostenlos zu erstellen. Sonst nichts. Dies ist ein Remote-Server. Es gibt kein zu installierendes Paket, keinen zu startenden Container und kein Google-Konto im gesamten Ablauf.

Schnellstart

Die Server-URL ist für jeden Client gleich. Wir testen sie hands-on in Claude Code und Claude Desktop. Die anderen Blöcke folgen dem jeweils dokumentierten Format des Clients für einen Remote-Server.

Clients mit OAuth-Unterstützung können dieselbe URL als Connector hinzufügen und sich anmelden, ohne einen Schlüssel in eine Konfigurationsdatei einzutragen.

claude mcp add --transport http youtube "https://mcp.hasdata.com/api/mcp?apis=youtube" \
  --header "x-api-key: HASDATA_API_KEY"

Einstellungen, dann Connectors, dann Benutzerdefinierten Connector hinzufügen, dann https://mcp.hasdata.com/api/mcp?apis=youtube einfügen und anmelden.

Für den Konfigurationsdatei-Weg lädt Claude Desktop nur lokale (stdio) Server, daher wird ein Remote-Server über die mcp-remote-Brücke erreicht, die Node benötigt. Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.hasdata.com/api/mcp?apis=youtube",
        "--header",
        "x-api-key:HASDATA_API_KEY"
      ]
    }
  }
}

Der Wert von x-api-key: enthält kein Leerzeichen nach dem Doppelpunkt. Claude Desktop übergibt das Argument ohne Shell, und ein Leerzeichen würde den Header teilen.

~/.cursor/mcp.json für jedes Projekt oder .cursor/mcp.json für eines:

{
  "mcpServers": {
    "youtube": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf nennt das Feld serverUrl, nicht url:

{
  "mcpServers": {
    "youtube": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "youtube": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

.vscode/mcp.json im Arbeitsbereich:

{
  "servers": {
    "youtube": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codex/config.toml:

[mcp_servers.youtube]
url = "https://mcp.hasdata.com/api/mcp?apis=youtube"

[mcp_servers.youtube.headers]
"x-api-key" = "HASDATA_API_KEY"

~/.gemini/settings.json:

{
  "mcpServers": {
    "youtube": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=youtube",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Beispiel-Prompts

Prompts, kein Code. Fügen Sie einen ein und der Agent wählt selbst das Tool. Jeder ist mit den benötigten Aufrufen annotiert, da in MCP das Modell entscheidet, wie viele Aufrufe es macht, und jeder erfolgreiche Aufruf 10 Credits kostet.

Finde die zehn meistgesehenen Videos über das Model Context Protocol aus dem letzten Monat, hole dann das Transkript des Top-Videos und nenne mir die drei Behauptungen, die es über Tool-Aufrufe aufstellt.

Zwei Aufrufe, 20 Credits.

Nimm den Kanal @GoogleDevelopers. Liste die Tabs auf, die er veröffentlicht, fasse dann die letzten fünf Uploads zusammen und sage mir, welche Themen sich wiederholen.

Zwei Aufrufe, 20 Credits. Das Lesen eines Tabs, den Sie noch nicht gesehen haben, erfordert einen zweiten Aufruf, da die Tab-Liste in der ersten Antwort enthalten ist.

Nimm diese Video-ID, dQw4w9WgXcQ. Hole seine Statistiken und prüfe dann, welche seiner verwandten Videos vom selben Kanal stammen.

Ein Aufruf, 10 Credits. Verwandte Videos sind in derselben Antwort enthalten.

Suche auf YouTube nach „web scraping tutorial“, sortiert nach Upload-Datum, nur Videos unter vier Minuten, und gib mir die Kapiteltitel jedes Ergebnisses, das welche hat.

Ein Aufruf, 10 Credits.

Hole das deutsche Transkript dieses Videos, falls eines existiert, und sage mir, in welchen Sprachen es verfügbar ist.

Ein Aufruf, 10 Credits.

Die Suche verwendet YouTubes eigene Filter-Tokens, und ein Agent grenzt nach Dauer, Upload-Datum und Inhaltstyp ein, ohne Nachbearbeitung. Transkripte kommen mit der Liste der verfügbaren Sprachspuren, sodass der Agent ohne Raten eine auswählen kann.

Das Blättern kostet jedes Mal einen Aufruf. Ein Recherche-Prompt, der sucht, zweimal blättert und dann drei Transkripte abruft, sind sechs Aufrufe und 60 Credits. Die Testversion reicht bei engen Fragen weiter als bei offenen Crawls.

Tools

Vier Tools, alle schreibgeschützt. Die Beispiele unten sind aus echten Aufrufen gekürzt, und die Zahlen darin ändern sich, wenn YouTube aktualisiert. Lesen Sie sie als Formen. Jeder Tool-Name verlinkt auf seine Endpunkt-Referenz, die die vollständige Feldliste enthält.

Die Beispiele sind die Nutzlast, nicht die gesamte Antwort. Ein tools/call-Ergebnis enthält einen Textblock, und dieser Text ist selbst JSON mit url, status, text und json, wobei die gescrapten Daten unter json liegen. Bei einer rohen JSON-RPC-Antwort ist der Pfad result.content[0].text, geparst, dann .json. Ein Chat-Client entpackt das für Sie, und Code, der direkt mit dem Endpunkt spricht, tut das nicht.

YouTube-Suchergebnisse abrufen

hasdata_youtube_search_getYoutubeSearchResults

Durchsucht YouTube und gibt die gesamte Ergebnisseite zurück, aufgeteilt nach Ergebnistyp.

Eine Ergebnisseite ist aufgeteilt in videoResults, shortsResults, inlineShortsResults, playlistResults, channelResults und shelves, mit bezahlten Platzierungen in adsResults und sponsoredResults. Welche Blöcke erscheinen, hängt von der Abfrage ab, und ein Block ohne Meldung fehlt, ist nicht leer. Testen Sie den Schlüssel, bevor Sie iterieren. searchInformation enthält die Gesamtzahl, und pagination.nextPageToken ist das, was Sie als paginationToken zurückgeben. Anzeigen mischen sich nie in die organischen Arrays, obwohl es zwei davon gibt, die übersprungen werden müssen.

{
  "positionOnPage": 1,
  "videoId": "GuTcle5edjk",
  "title": "you need to learn MCP RIGHT NOW!! (Model Context Protocol)",
  "viewsOriginal": "1.6M views",
  "views": 1653824,
  "length": "38:40",
  "publishedDate": "11 months ago",
  "extensions": ["4K"],
  "chapters": [
    { "title": "Intro", "time": "0:00" },
    { "title": "Problem: LLMs Suck at Accessing Code", "time": "0:40" }
  ],
  "channel": { "name": "NetworkChuck", "verified": true }
}

Zwei Dinge dort verdienen eine Erwähnung. views ist eine geparste Ganzzahl neben der Anzeigezeichenfolge 1.6M views und benötigt keinen Suffix-Parser. Und chapters kommen in den Suchergebnissen zurück, nicht nur auf dem Video selbst, obwohl nur einige Videos sie enthalten.

Die Such-Endpunkt-Referenz listet jedes sp- und filters__-Token auf, das der Endpunkt akzeptiert.

YouTube-Videodaten abrufen

hasdata_youtube_video_getYoutubeVideo

Ein Video per ID.

Gibt title, thumbnail, channel, publishedDate, lengthSeconds, category, isFamilySafe und isUnlisted zurück, plus die Arrays relatedVideos, endScreenVideos, keywords, captions, music und socialLinks. description ist ein Objekt, das den vollständigen Text in content und ein links-Array enthält, wobei jeder Link und Hashtag startIndex, length, text und url trägt. Das Feld text enthält den Link, wie der Autor ihn geschrieben hat, und url enthält YouTubes Redirect-Wrapper, was wichtig ist, wenn Sie Sponsor- oder Affiliate-Ziele aus Beschreibungen extrahieren.

Lesen Sie das geparste Feld pro Tool namentlich, bevor Sie das Beispiel unten kopieren. Such- und Kanalergebnisse setzen die geparste Zahl in views und die Anzeigezeichenfolge in viewsOriginal. Diese Antwort kehrt es um, behält die Zeichenfolge in views und die Zahl in extractedViews, und dieselbe Umkehrung gilt für likes und subscribers. Wenn Sie es falsch machen, vergleicht item.views > 100000 hier eine Zeichenfolge, ohne jemals einen Fehler zu werfen.

{
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "views": "1,806,075,152 views",
  "extractedViews": 1806075152,
  "likes": "19M",
  "extractedLikes": 19344370,
  "publishedDate": "Oct 24, 2009",
  "lengthSeconds": 214,
  "category": "Music",
  "channel": { "name": "Rick Astley", "subscribers": "4.53M subscribers", "extractedSubscribers": 4530000 }
}

YouTube-Kanaldaten abrufen

hasdata_youtube_channel_getYoutubeChannel

Ein Kanal per ID oder Handle, jeweils ein Tab.

Gibt auf dem Standard-Tab channelInfo, featuredVideo und sections zurück. Andere Tabs haben ihre eigene Struktur. channelInfo enthält den Handle, das Avatar, das Banner, die Beschreibung, die Kanalschlüsselwörter und die rssUrl des Kanals – genug, um einen Kanal weiterzuverfolgen, ohne ihn abzufragen.

Das availableTabs-Array im Beispiel unten enthält Anzeigelabels, und das sind nicht die Werte, die tab akzeptiert. Home, Live, Courses und Search lassen sich auf gar keinen Parameterwert abbilden, und der Rest muss kleingeschrieben werden. Ein Agent, der die Liste liest und jeden Eintrag durchgeht, scheitert am ersten.

{
  "channelInfo": {
    "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "name": "Google for Developers",
    "handle": "@GoogleDevelopers",
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "isFamilySafe": true,
    "availableTabs": ["Home", "Videos", "Shorts", "Live", "Courses", "Playlists", "Posts", "Search"]
  }
}

YouTube-Videotranskript abrufen

hasdata_youtube_transcript_getYoutubeTranscript

Das zeitgestempelte Transkript eines Videos.

Prüfe selected in der Antwort, bevor du der Sprache vertraust. Wenn du nach einem languageCode fragst, den das Video nicht enthält, schlägt das weder fehl noch liefert es eine leere Antwort – es fällt stillschweigend auf den Standard-Track zurück. Jeder Eintrag in der Liste enthält languageName und languageCode, und eine Sprache kann doppelt vorkommen, einmal von Menschen erstellt und einmal mit type auf asr gesetzt.

{
  "transcript": [
    { "startMs": 320, "endMs": 18800, "snippet": "[Music]", "startTimeText": "0:00" },
    { "startMs": 18800, "endMs": 21800, "snippet": "We're no strangers to", "startTimeText": "0:18" }
  ],
  "availableTranscripts": [
    { "languageName": "English", "languageCode": "en" },
    { "languageName": "English", "languageCode": "en", "type": "asr", "selected": true },
    { "languageName": "German (Germany)", "languageCode": "de-DE" },
    { "languageName": "Japanese", "languageCode": "ja" }
  ]
}

Fehler und Fehlerpfade

Dein Client sieht bei einem Tool-Aufruf fast nie einen HTTP-Fehlercode. Die MCP-Ebene antwortet mit 200 und legt den Fehler in das Ergebnis, mit isError auf true und dem Grund als Text. Der Agent liest eine Meldung, wo man eine Statuszeile erwarten würde.

Ein falscher Schlüssel erscheint als Tool-Ausgabe, nicht als fehlgeschlagene Verbindung. tools/list akzeptiert jeden nicht-leeren Schlüssel und gibt alle vier Tools zurück, sodass der Client seinen Handshake abschließt und grün anzeigt. Der erste Tool-Aufruf kommt dann mit isError: true und dem Text HasData API error: 401 Unauthorized zurück. Achte auf diese Zeichenkette, denn nichts früher im Ablauf meldet das Problem.

Ein fehlender Schlüssel ist der einzige echte HTTP-Fehler. Die Autorisierung läuft vor jedem Tool, und die Verbindung selbst schlägt mit 401 fehl. CORS-Header sind vorhanden, und ein Browser-Client liest den Status und keinen undurchsichtigen Netzwerkfehler.

Ein Argument, das das Schema eines Tools verletzt, wird abgelehnt, bevor daraus ein Scrape wird. Der Server antwortet mit isError: true und dem Text MCP error -32602: Input validation error und nennt das fehlerhafte Feld. Es wird nichts abgerufen und nichts berechnet. Die Meldung nennt das Feld, aber nicht die akzeptierten Werte, daher sind die Parametertabellen oben die Referenz.

Ein Aufruf, der erfolgreich ist und nichts findet, ist der Fall, über den man stolpert. Er kommt als normales Ergebnis an, mit requestMetadata.status auf ok und der Daten-Schlüssel fehlt einfach. Nichts im Textkörper sagt, dass das Ergebnis leer war. Teste auf das Feld, das du brauchst, nicht auf einen Fehler.

Eine Kennung, die die Plattform ablehnt, gibt 400 zurück, mit requestMetadata.status auf error. Ein Kanal-Handle, das nicht existiert, ist der übliche Weg, das zu sehen.

Ergebnisse mit Daten enthalten auch eine requestMetadata.id, die im Support wertvoll zu zitieren ist.

Preise, kostenloses Kontingent und Limits

Jedes YouTube-Tool kostet 10 Credits pro erfolgreichem Aufruf. Die Antwortgröße ändert den Preis nicht. Eine volle Seite mit Suchergebnissen kostet dasselbe wie eine Seite mit einem Video.

Die kostenlose Testversion umfasst 1.000 Credits über 30 Tage ohne Karte, also 100 YouTube-Aufrufe. Danach erhält ein aktives Konto weiterhin täglich 100 Credits aufgestockt, sobald sein Guthaben unter 100 fällt, sodass ein Agent mit geringem Volumen dauerhaft im kostenlosen Kontingent läuft.

Bezahlte Pläne beginnen bei 49 $ pro Monat für 200.000 Credits, also 20.000 Aufrufe. Der Stückpreis sinkt mit dem Volumen, von 2,45 $ pro 1.000 Aufrufen im Einstiegsplan auf 0,99 $ bei Business, 0,83 $ bei Growth und 0,75 $ bei den größten High-Volume-Plänen.

Dein Plan bestimmt auch die Parallelität. Die kostenlose Testversion erlaubt 1 Anfrage gleichzeitig, Startup 15, Business 30, Growth 50, und die High-Volume-Pläne laufen von 200 bis 1.500. Behandle den Überlauf-Fall in allem Unbeaufsichtigten defensiv, denn ein Agent, der sich aufteilt, erreicht die Obergrenze vor dir.

Eine Anfrage, die mit Nicht-200 zurückkommt, wird nicht berechnet. Ein erfolgreicher Aufruf, der nichts findet, ist trotzdem ein Aufruf.

Tool-Auswahl

Der Abfrageparameter apis entscheidet, welche Tools dein Agent sieht. Weniger Tools bedeutet weniger Kontext für Tool-Definitionen und weniger Chancen, dass das Modell zum falschen greift.

?apis=youtube                    the four tools in this repo
?apis=youtube,google_serp        add Google search
?apis=youtube,tiktok,instagram   a social research bundle

Der Parameter akzeptiert Anbieternamen wie youtube und einzelne API-Namen wie google_maps_search. Falsch geschriebene Namen werden ignoriert. Wenn jeder Name falsch ist, schlägt die Anfrage mit 400 fehl, und der Textkörper listet sowohl das, was nicht erkannt wurde, als auch jeden gültigen Wert auf. Lasse den Parameter weg, und derselbe Endpunkt stellt alle 57 HasData-Tools bereit.

Vergleich

Gegenüber der offiziellen YouTube Data API v3:

Die letzten beiden Zeilen sind wichtig. Wenn das tägliche Kontingent dein Volumen abdeckt und du den Kanal besitzt, den du abfragst, ist die offizielle API die günstigere Antwort, und du solltest sie nehmen.

Die meisten anderen YouTube-MCP-Server machen nur Transkripte. Dieser sucht auch, liest Videos mit ihren Engagement-Zahlen und durchläuft Kanal-Tabs, sodass ein Agent eine ganze Recherche-Runde ohne zweiten Server erledigt.

Was dieser Server nicht tut. Keine Kommentare, keine Kanalverwaltung, keine Uploads, keine Analysen, keine privaten Daten. Er liest, was ein abgemeldeter Besucher sehen kann.

FAQ

Gibt es einen offiziellen YouTube-MCP-Server?

Google veröffentlicht keinen. YouTube hat keinen First-Party-MCP-Server. Jede Option wird von jemand anderem gebaut, entweder um die YouTube Data API v3 oder um die öffentlichen Seiten herum. Dieser wird von HasData gepflegt und liest öffentliche Seiten, weshalb er keine Google-Anmeldedaten benötigt.

Was ist ein YouTube-MCP-Server?

Ein Server, der YouTube-Daten als Tools bereitstellt, die ein KI-Client aufrufen kann. Der Client sendet einen Tool-Aufruf über das Model Context Protocol, der Server ruft die Daten ab und gibt strukturiertes JSON zurück, und das Modell arbeitet mit dem Ergebnis und sieht nie eine HTML-Seite. Dieser stellt vier Tools bereit und läuft remote. Der Client verbindet sich mit einer URL und startet keinen lokalen Prozess.

Brauche ich einen YouTube-API-Schlüssel oder ein Google-Cloud-Projekt?

Nein. Die einzige Anmeldedaten sind dein HasData-Schlüssel. Es gibt kein Google-Cloud-Projekt zu erstellen, kein Quotenformular auszufüllen und keinen OAuth-Zustimmungsbildschirm, weil die Tools öffentliche YouTube-Seiten lesen und nicht die YouTube Data API.

Muss ich etwas hosten oder ausführen?

Nein. Dies ist ein Remote-MCP-Server über streamable HTTP. Nichts zu installieren, kein Container warmzuhalten, kein Prozess neu zu starten.

Sind die Daten live oder zwischengespeichert?

Live. Jeder Aufruf ruft die Seite zum Zeitpunkt der Anfrage ab und trägt seine eigene requestMetadata.id. Zwei identische Aufrufe sind zwei getrennte Abrufe und keine Wiedergabe einer gespeicherten Kopie. Zähler wie Aufrufe und Likes folgen der Seite, also bewegen sie sich, wenn sich die Seite bewegt.

Was passiert, wenn YouTube sein Layout ändert?

Auf deiner Seite nichts. Wir verfolgen die Änderungen und halten das Antwortschema stabil, sodass Feldnamen und Typen bleiben. Ein Feld ohne Wert fehlt im Element, es ist nicht vorhanden und null. Lies optionale Felder mit einem Standardwert.

Kann ich das zusammen mit anderen HasData-APIs verwenden?

Ja. Der Parameter apis akzeptiert eine Liste, und ?apis=youtube,google_serp gibt deinem Agenten die vier YouTube-Tools plus Google-Suche. Lasse den Parameter weg und du bekommst alles.

Kann ich für jedes Video ein Transkript bekommen?

Nur wo das Video eines hat, und availableTranscripts sagt dir, was existiert, bevor du fragst.

Kann ich mich mit OAuth anmelden, statt einen Schlüssel einzufügen?

Ja, in Clients, die das unterstützen. Claude Desktop und Cursor können den Endpunkt als Connector hinzufügen und sich anmelden. Unbeaufsichtigte Agenten und Skripte verwenden den x-api-key-Header.

Compliance und personenbezogene Daten

HasData greift ausschließlich auf öffentlich verfügbare Daten zu. Die Nutzungsbedingungen einer Plattform können den automatisierten Zugriff einschränken, und Sie sind für Ihre eigene Compliance verantwortlich. Wenn die von Ihnen erfassten Daten personenbezogene Informationen enthalten, stellen Sie sicher, dass Sie eine rechtmäßige Grundlage dafür gemäß GDPR, CCPA oder den entsprechenden Regelungen in Ihrer Rechtsordnung haben.

HasData-Links

Entwicklung

Dieses Repository enthält Konfiguration und Dokumentation für einen Remote-Server. Es gibt keinen Build-Schritt und nichts zu containerisieren.

Die Tests in test/ prüfen den Tool-Vertrag, den Teil, der ohne einen Commit hier brechen kann. Sie prüfen, dass ?apis=youtube genau vier Tools zurückgibt, dass jedes Tool weiterhin seinen erforderlichen Parameter deklariert, dass sich kein Name geändert hat und dass der verwendete Schlüssel tatsächlich akzeptiert wird. Diese letzte Prüfung ruft ein Tool tatsächlich auf und kostet 10 Credits, was der Preis eines Canarys ist, der aus dem richtigen Grund fehlschlagen kann.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

Dieselbe Suite läuft in CI bei jedem Push und einmal pro Woche planmäßig, da sich die Upstream-Tool-Liste ändern kann, ohne dass jemand dieses Repository anfasst. Ein Fehlschlag bedeutet, dass sich die Tool-Liste verschoben hat, der Schlüssel nicht mehr funktioniert oder der Endpunkt nicht erreichbar war, und die Assertion-Meldung sagt, welcher Fall eingetreten ist.

Mitwirken

Korrekturen an den Tool-Tabellen und den Antwortbeispielen sind der nützlichste Beitrag, weil dies die Teile sind, die abweichen. Fügen Sie den von Ihnen durchgeführten Aufruf und die erhaltene Antwort hinzu. Pull Requests von Forks führen die Suite ohne Schlüssel aus, und die Live-Prüfungen werden übersprungen, anstatt rot zu werden.

Lizenz

MIT. Siehe LICENSE.