YouTube-Automation über Rube MCP
Selektive Leseregel
Beginnen Sie mit:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Laden Sie dann nur die vererbten Dokumente, Skripte, Assets oder Beispiele, die zur tatsächlichen Aufgabe des Benutzers passen.
Automatisieren Sie YouTube-Operationen über das Composio YouTube Toolkit via Rube MCP.
Voraussetzungen
- Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
- Aktive YouTube-Verbindung via
RUBE_MANAGE_CONNECTIONSmit Toolkityoutube - Rufen Sie immer zuerst
RUBE_SEARCH_TOOLSauf, um die aktuellen Tool-Schemas zu erhalten
Einrichtung
Rube MCP holen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Keine API-Schlüssel nötig – fügen Sie einfach den Endpunkt hinzu und es funktioniert.
- Überprüfen Sie, ob Rube MCP verfügbar ist, indem Sie bestätigen, dass
RUBE_SEARCH_TOOLSantwortet. - Rufen Sie
RUBE_MANAGE_CONNECTIONSmit Toolkityoutubeauf. - Wenn die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um Google OAuth abzuschließen.
- Bestätigen Sie, dass der Verbindungsstatus AKTIV anzeigt, bevor Sie Workflows ausführen.
Kern-Workflows
1. Videos hochladen und verwalten
Wann verwenden: Benutzer möchte ein Video hochladen oder Video-Metadaten aktualisieren
Tool-Reihenfolge:
YOUTUBE_UPLOAD_VIDEO- Ein neues Video hochladen [Erforderlich]YOUTUBE_UPDATE_VIDEO- Titel, Beschreibung, Tags, Privatsphäre aktualisieren [Optional]YOUTUBE_UPDATE_THUMBNAIL- Ein benutzerdefiniertes Thumbnail setzen [Optional]
Wichtige Parameter:
title: Video-Titel (maximal 100 Zeichen)description: Video-Beschreibung (maximal 5000 Bytes)tags: Array von Schlagwort-TagscategoryId: YouTube-Kategorie-ID (z.B. '22' für Menschen & Blogs)privacyStatus: 'public', 'private' oder 'unlisted'videoFilePath: Objekt mit{name, mimetype, s3key}für die Videodatei
Fallstricke:
- UPLOAD_VIDEO verbraucht hohes Kontingent; bevorzugen Sie UPDATE_VIDEO für reine Metadatenänderungen
- videoFilePath muss ein Objekt mit s3key sein, kein roher Dateipfad oder URL
- Die Gesamtzahl der Tags darf 500 Zeichen inklusive Trennzeichen nicht überschreiten
- Winkelklammern
< >in Tags werden automatisch entfernt - Das Beschreibungslimit beträgt 5000 Bytes, nicht Zeichen (Multibyte-Zeichen zählen mehr)
2. YouTube-Inhalte durchsuchen
Wann verwenden: Benutzer möchte Videos, Kanäle oder Playlists finden
Tool-Reihenfolge:
YOUTUBE_SEARCH_YOU_TUBE- Nach Inhalten suchen [Erforderlich]YOUTUBE_VIDEO_DETAILS- Volle Details zu einem bestimmten Video abrufen [Optional]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Details zu mehreren Videos abrufen [Optional]
Wichtige Parameter:
q: Suchanfrage (unterstützt exakte Phrasen, Ausschlüsse, Kanal-Handles)type: 'video', 'channel' oder 'playlist'maxResults: Ergebnisse pro Seite (1-50)pageToken: Für Paginierung
Fallstricke:
- Der Such-Endpunkt gibt nur den 'snippet'-Teil zurück; für Statistiken VIDEO_DETAILS verwenden
- Suchergebnisse sind auf insgesamt 500 Elemente begrenzt
- Suche hat höhere Kontingentkosten (100 Einheiten) im Vergleich zu Listen-Endpunkten (1 Einheit)
- BATCH-Videodetails haben eine praktische Grenze von ~50 IDs pro Aufruf; größere Sets aufteilen
3. Playlists verwalten
Wann verwenden: Benutzer möchte Playlists erstellen oder Playlist-Inhalte verwalten
Tool-Reihenfolge:
YOUTUBE_LIST_USER_PLAYLISTS- Vorhandene Playlists des Benutzers auflisten [Optional]YOUTUBE_CREATE_PLAYLIST- Eine neue Playlist erstellen [Optional]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- Ein Video zu einer Playlist hinzufügen [Optional]YOUTUBE_LIST_PLAYLIST_ITEMS- Videos in einer Playlist auflisten [Optional]
Wichtige Parameter:
playlistId: Playlist-ID ('PL...' für benutzererstellte, 'UU...' für Uploads)part: Ressourcenteile, die eingeschlossen werden sollen (z.B. 'snippet,contentDetails')maxResults: Elemente pro Seite (1-50)pageToken: Paginierungstoken aus vorheriger Antwort
Fallstricke:
- Geben Sie KEINE Kanal-IDs ('UC...') als Playlist-IDs weiter; konvertieren Sie 'UC' in 'UU' für Uploads
- Große Playlists erfordern Paginierung über pageToken; folgen Sie nextPageToken, bis es fehlt
- items[].id ist nicht die videoId; verwenden Sie items[].snippet.resourceId.videoId
- Das Erstellen doppelter Playlist-Namen ist erlaubt; überprüfen Sie zuerst vorhandene Playlists
4. Kanal- und Videoanalysen abrufen
Wann verwenden: Benutzer möchte die Kanal-Leistung oder Videometriken analysieren
Tool-Reihenfolge:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- Ein Handle in eine Kanal-ID auflösen [Voraussetzung]YOUTUBE_GET_CHANNEL_STATISTICS- Abonnenten-/Aufruf-/Video-Anzahl des Kanals abrufen [Erforderlich]YOUTUBE_LIST_CHANNEL_VIDEOS- Alle Videos eines Kanals auflisten [Optional]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Pro-Video-Statistiken abrufen [Optional]YOUTUBE_GET_CHANNEL_ACTIVITIES- Aktuelle Kanalaktivitäten abrufen [Optional]
Wichtige Parameter:
channelId: Kanal-ID ('UC...'), Handle ('@handle') oder 'me'forHandle: Kanal-Handle (z.B. '@Google')id: Kommagetrennte Video-IDs für Batch-Detailsparts: Ressourcenteile, die eingeschlossen werden sollen (z.B. 'snippet,statistics')
Fallstricke:
- Kanalstatistiken sind Lebenszeit-Gesamtzahlen, keine Zeitraum-bezogenen
- BATCH-Videodetails können für private/gelöschte Videos weniger Elemente zurückgeben als angefordert
- Antwortdaten können unter
dataoderdata_previewverschachtelt sein; defensiv parsen - contentDetails.duration verwendet ISO 8601-Format (z.B. 'PT4M13S')
5. Abonnements und Kommentare verwalten
Wann verwenden: Benutzer möchte Kanäle abonnieren oder Videokommentare anzeigen
Tool-Reihenfolge:
YOUTUBE_SUBSCRIBE_CHANNEL- Einen Kanal abonnieren [Optional]YOUTUBE_UNSUBSCRIBE_CHANNEL- Abonnement eines Kanals kündigen [Optional]YOUTUBE_LIST_USER_SUBSCRIPTIONS- Abonnements auflisten [Optional]YOUTUBE_LIST_COMMENT_THREADS- Kommentare zu einem Video auflisten [Optional]
Wichtige Parameter:
channelId: Kanal zum Abonnieren/KündigenvideoId: Video-ID für KommentarthreadsmaxResults: Ergebnisse pro SeitepageToken: Paginierungstoken
Fallstricke:
- Das Abonnieren eines bereits abonnierten Kanals kann einen Fehler zurückgeben
- Kommentar-Threads geben Top-Level-Kommentare mit bis zu 5 Antworten zurück
- Kommentare können bei manchen Videos deaktiviert sein
- Zum Kündigen eines Abonnements ist die Abonnement-ID erforderlich, nicht die Kanal-ID
Häufige Muster
Kanal-ID-Auflösung
Handle zu Kanal-ID:
1. Rufen Sie YOUTUBE_GET_CHANNEL_ID_BY_HANDLE mit '@handle' auf
2. Extrahiere channelId aus der Antwort
3. Verwende sie in nachfolgenden Kanaloperationen
Uploads-Playlist:
1. Kanal-ID abrufen (beginnt mit 'UC')
2. 'UC'-Präfix durch 'UU' ersetzen, um die Uploads-Playlist-ID zu erhalten
3. Mit LIST_PLAYLIST_ITEMS verwenden, um alle Videos aufzulisten
Paginierung
- Setzen Sie
maxResults(maximal 50 pro Seite) - Überprüfen Sie die Antwort auf
nextPageToken - Übergeben Sie das Token als
pageTokenin der nächsten Anfrage - Fahren Sie fort, bis
nextPageTokenfehlt
Batch-Videodetails
- Sammeln Sie Video-IDs aus Suchergebnissen oder Playlist-Auflistungen
- Teilen Sie diese in Gruppen von ~50 IDs auf
- Rufen Sie GET_VIDEO_DETAILS_BATCH pro Gruppe auf
- Führen Sie die Ergebnisse über alle Gruppen hinweg zusammen
Bekannte Fallstricke
Kontingentverwaltung:
- Die YouTube-API hat ein tägliches Kontingent-Limit (Standard 10.000 Einheiten)
- Upload = 1600 Einheiten; Suche = 100 Einheiten; Liste = 1 Einheit
- Bevorzugen Sie Listen-Endpunkte gegenüber der Suche, wenn möglich
- Überwachen Sie die Kontingentnutzung, um tägliche Grenzen nicht zu überschreiten
ID-Formate:
- Video-IDs: 11-stellige alphanumerische Zeichenfolgen
- Kanal-IDs: Beginnen mit 'UC', gefolgt von 22 Zeichen
- Playlist-IDs: Beginnen mit 'PL' (Benutzer) oder 'UU' (Uploads)
- Verwechseln Sie Kanal-IDs nicht mit Playlist-IDs
Thumbnails:
- Benutzerdefinierte Thumbnails erfordern eine Telefonverifizierung des Kanals
- Müssen JPG, PNG oder GIF sein; unter 2 MB
- Empfohlen: 1280x720 Auflösung (16:9-Seitenverhältnis)
Antwort-Parsing:
- Statistikwerte werden als Zeichenfolgen zurückgegeben, nicht als Ganzzahlen; vor mathematischen Operationen umwandeln
- Die Dauer verwendet das ISO 8601-Format (PT#H#M#S)
- Batch-Antworten können Daten unter verschiedenen Schlüsseln verpacken
Kurzreferenz
| Aufgabe | Tool-Slug | Wichtige Parameter |
|---|---|---|
| Video hochladen | YOUTUBE_UPLOAD_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| Video aktualisieren | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| Thumbnail setzen | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| YouTube durchsuchen | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| Videodetails | YOUTUBE_VIDEO_DETAILS | id, part |
| Batch-Videodetails | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| Playlists auflisten | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| Playlist erstellen | YOUTUBE_CREATE_PLAYLIST | (Schema prüfen) |
| Zu Playlist hinzufügen | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (Schema prüfen) |
| Playlist-Elemente auflisten | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| Kanalstatistiken | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| Kanalvideos auflisten | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| Kanal-ID per Handle | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| Abonnieren | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| Abonnements auflisten | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (Schema prüfen) |
| Kommentare auflisten | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| Kanalaktivitäten | YOUTUBE_GET_CHANNEL_ACTIVITIES | (Schema prüfen) |
Wann verwenden
Diese Skill ist anwendbar, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.
Einschränkungen
- Verwenden Sie diese Skill nur, wenn die Aufgabe klar mit dem oben beschriebenen Umfang übereinstimmt.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halten Sie an und fragen Sie nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.