MCP-Tools-Referenz
Der Tube Search MCP-Server bietet 10 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. Für Videos, die über unsere Yandex.Video-Provenienzpipeline angereichert wurden, enthält die Antwort zusätzlich ein verschachteltes yandex-Objekt mit den Schlüsseln internal_id, attribution, preview_url und scanned_at — siehe Unterabschnitt „Yandex-Anreicherungsprovenienz" unten.
Yandex-Anreicherungsprovenienz
Wenn get_video ein verschachteltes yandex-Objekt zurückgibt, nimmt das Feld yandex.attribution einen von drei Vertrauensstufen-Werten an. Verwende die folgende Tabelle, um zu entscheiden, ob ein Fakt über dieses Video direkt zitiert werden kann oder eine zweite Quelle herangezogen werden sollte.
Stufe (Wert von yandex.attribution) | Empfohlene Aktion | Begründung |
|---|---|---|
db_match | Direkt zitieren | Die YouTube-ID war bereits in unserer Datenbank diesem Kanal zugeordnet; Yandex lieferte ergänzende Metadaten (title, duration, upload_date) per NULL-Füllung. Höchste Sicherheit. |
yt_dlp_confirmed | Direkt zitieren | Die YouTube-ID wurde erstmals über Yandex entdeckt; yt-dlp bestätigte die Kanalzuordnung unabhängig gegen die Live-Metadaten von YouTube. Bestätigung aus zwei unabhängigen Quellen. |
name_unique_anchor_passed | Erst bestätigen | Die YouTube-ID wurde erstmals über Yandex entdeckt; yt-dlp schlug fehl oder lief in einen Timeout; die Zuordnung stützt sich auf Heuristiken zur Namens-Eindeutigkeit und Ankerverifikation (mindestens 2 von K Titel-Übereinstimmungen bei LIVE-Videos). Schwächeres Signal — vor dem Zitieren mit einer zweiten Quelle bestätigen. |
Wenn yandex.preview_url ungleich null ist, verweist es auf einen kurzen (~5 s) animierten MP4-Vorschauclip, der vom Yandex-Snapshot gespiegelt wurde — nützlich für eine visuelle Bestätigung, wie das gelöschte Video aussah, aber nicht gleichwertig mit dem ursprünglichen vollständigen Inhalt. Wenn preview_url gleich null ist, bleiben die Metadatenfelder (title, duration, uploadDate) und attribution gültig; lediglich die Vorschau-Spiegelung war nicht erfolgreich.
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.
generate_stenogram
Erzeuge ein privates Stenogramm (wortgetreuer Dialog mit Sprechermarkierung) aus dem Transkript eines Videos. Erfordert L3+ (Tarif MCP + API). Das Ergebnis liegt in deinem Benutzerbereich und ist nur für dich sichtbar.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
videoId | string | Ja | YouTube-Video-ID (11 Zeichen) |
language | enum | Nein | auto (Standard), en, ru, es, de, pt |
Gibt zurück: { stenogram, metadata: { llmModel, tokensUsed, promptVersion, generatedAt, language, generationTimeMs } }. Erfordert ein vorhandenes Transkript (archivierte oder KI-generierte Untertitel). Sendet notifications/progress, wenn ein Progress-Token übergeben wird. Wird gegen apiStenogramsPerDay verbucht (Zähler geteilt mit der REST-Route).
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.