MCP-Tools-Referenz
Der Tube Search MCP-Server bietet 9 Tools zum Suchen, Lesen und Analysieren archivierter YouTube-Daten.
search_channel
Finde alle bekannten Videos eines YouTube-Kanals durch Durchsuchen von Webarchiven.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query | string | Ja | Kanal-URL, @Handle oder Channel-ID (z. B. UC...) |
Gibt ein Array von Video-Metadaten zurück, einschließlich Status (LIVE, DELETED, CHECKING).
search_videos
Volltextsuche über Titel und Beschreibungen archivierter Videos.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query | string | Ja | Suchanfrage (unterstützt natürliche Sprache) |
limit | number | Nein | Max. Ergebnisse (Standard: 20, Max.: 100) |
status | string | Nein | Nach Status filtern: live, deleted, all |
sort | string | Nein | relevance (Standard) oder date-desc |
hasSubtitles | boolean | Nein | Nur Videos mit Untertiteln |
hasSummary | boolean | Nein | Nur Videos mit KI-Zusammenfassungen |
get_video
Metadaten eines bestimmten Videos abrufen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
videoId | string | Ja | YouTube-Video-ID (11 Zeichen) |
Gibt zurück: title, description, channelId, channelTitle, duration, uploadDate, viewCount, status, thumbnailUrl, subtitleStatus, hasSummary.
get_subtitles
Vollständige Transkription eines Videos als lesbaren Text abrufen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
videoId | string | Ja | YouTube-Video-ID |
Gibt die Transkription ohne Zeitstempel zurück, formatiert als lesbare Absätze. Funktioniert für aktive und gelöschte Videos mit archivierten Untertiteln.
get_summary
KI-generierte Zusammenfassung eines Videos abrufen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
videoId | string | Ja | YouTube-Video-ID |
Gibt zurück: tldr, keyPoints (mit Zeitstempeln), detailedSummary, tags, language. Gibt einen Fehler zurück, wenn keine Zusammenfassung existiert — verwende generate_summary, um eine zu erstellen.
generate_summary
KI-Zusammenfassung für ein Video mit Untertiteln generieren.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
videoId | string | Ja | YouTube-Video-ID |
Startet die Generierung und wartet auf den Abschluss (bis zu 60 s). Gibt die Zusammenfassung zurück, wenn das Video bereits eine hat. Zählt gegen dein tägliches Limit für Zusammenfassungsgenerierungen.
browse_summaries
Vorhandene KI-Zusammenfassungen mit optionalen Filtern durchsuchen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tag | string | Nein | Nach Tag filtern (z. B. "music", "education") |
channelId | string | Nein | Nach Kanal filtern |
language | string | Nein | Nach Sprache filtern (z. B. "en", "de") |
page | number | Nein | Seitennummer (Standard: 1) |
limit | number | Nein | Ergebnisse pro Seite (Standard: 20) |
get_video_status_history
Statusänderungsverlauf eines Videos anzeigen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
videoId | string | Ja | YouTube-Video-ID |
Gibt ein Array von Statusübergängen zurück: [{ status, previousStatus, changedAt, source }], neueste zuerst.
get_usage
Aktuelle API-Nutzungszähler und verbleibende Limits prüfen.
Keine Parameter. Gibt aktuelle Zähler und Limits für Suchen, FTS-Abfragen, Untertitel-Downloads und Zusammenfassungsgenerierungen zurück.