Communitygithub.com

benjaminasterA/antigravity-awesome-skills

Automatisiere YouTube-Aufgaben über Rube MCP (Composio): Videos hochladen, Playlists verwalten, Inhalte suchen, Analysen abrufen und Kommentare verwalten. Suche zuerst immer nach aktuellen Tool-Schemas.

Was ist antigravity-awesome-skills?

Diese Fähigkeit (Skill) ermöglicht die vollständige Automatisierung von YouTube-Operationen über das Composio YouTube-Toolkit, eingebettet in Rube MCP. Sie ist ideal für KI-Agenten, die Inhalte auf YouTube verwalten, hochladen oder analysieren möchten – alles über eine MCP-Schnittstelle. Der Skill deckt fünf Kernbereiche ab: Video-Upload und -Metadatenverwaltung, YouTube-Suche, Playlist-Management, Kanal- und Videoanalysen sowie die Verwaltung von Abonnements und Kommentaren. Vor jeder Nutzung muss der Agent `RUBE_SEARCH_TOOLS` aufrufen, um die aktuellen Tool-Schemas zu laden, und eine aktive YouTube-Verbindung über `RUBE_MANAGE_CONNECTIONS` sicherstellen. Die Fähigkeit enthält detaillierte Workflows, Parameterbeschreibungen und häufige Fallstricke (z.B. Quotennutzung, ID-Formate, ISO-8601-Dauerformate). Sie unterstützt die Plattformen Rube MCP und Composio und ist für Entwickler gedacht, die YouTube-Aufgaben programmatisch und effizient in ihre KI-gestützten Arbeitsabläufe integrieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/youtube-automation

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

YouTube-Automatisierung über Rube MCP

Automatisiere YouTube-Operationen über das Composio YouTube-Toolkit via Rube MCP.

Voraussetzungen

  • Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
  • Aktive YouTube-Verbindung über RUBE_MANAGE_CONNECTIONS mit Toolkit youtube
  • Rufe immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemas zu erhalten

Einrichtung

Rube MCP installieren: Füge https://rube.app/mcp als MCP-Server in deiner Client-Konfiguration hinzu. Keine API-Schlüssel erforderlich – nur den Endpunkt hinzufügen und es funktioniert.

  1. Überprüfe, ob Rube MCP verfügbar ist, indem du bestätigst, dass RUBE_SEARCH_TOOLS antwortet
  2. Rufe RUBE_MANAGE_CONNECTIONS mit Toolkit youtube auf
  3. Falls die Verbindung nicht AKTIV ist, folge dem zurückgegebenen Authentifizierungslink, um den Google OAuth abzuschließen
  4. Bestätige den Verbindungsstatus als AKTIV, bevor du Workflows ausführst

Kern-Workflows

1. Videos hochladen und verwalten

Wann verwenden: Der Benutzer möchte ein Video hochladen oder Metadaten eines Videos aktualisieren

Tool-Ablauf:

  1. YOUTUBE_UPLOAD_VIDEO - Ein neues Video hochladen [Erforderlich]
  2. YOUTUBE_UPDATE_VIDEO - Titel, Beschreibung, Tags, Privatsphäre aktualisieren [Optional]
  3. YOUTUBE_UPDATE_THUMBNAIL - Ein benutzerdefiniertes Thumbnail setzen [Optional]

Wichtige Parameter:

  • title: Videotitel (maximal 100 Zeichen)
  • description: Videobeschreibung (maximal 5000 Bytes)
  • tags: Array von Schlüsselwort-Tags
  • categoryId: 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; bevorzuge UPDATE_VIDEO für reine Metadatenänderungen
  • videoFilePath muss ein Objekt mit s3key sein, kein roher Dateipfad oder URL
  • Tags insgesamt dürfen 500 Zeichen inklusive Trennzeichen nicht überschreiten
  • Winkelklammern < > in Tags werden automatisch entfernt
  • Beschreibungslimit beträgt 5000 Bytes, nicht Zeichen (Multibyte-Zeichen zählen mehr)

2. YouTube-Inhalte durchsuchen

Wann verwenden: Der Benutzer möchte Videos, Kanäle oder Playlists finden

Tool-Ablauf:

  1. YOUTUBE_SEARCH_YOU_TUBE - Nach Inhalten suchen [Erforderlich]
  2. YOUTUBE_VIDEO_DETAILS - Vollständige Details für ein bestimmtes Video abrufen [Optional]
  3. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Details für mehrere 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 Quotenkosten (100 Einheiten) im Vergleich zu Listen-Endpunkten (1 Einheit)
  • BATCH-Videodetails haben einen praktischen Grenzwert von ~50 IDs pro Aufruf; größere Mengen aufteilen

3. Playlists verwalten

Wann verwenden: Der Benutzer möchte Playlists erstellen oder Playlist-Inhalte verwalten

Tool-Ablauf:

  1. YOUTUBE_LIST_USER_PLAYLISTS - Vorhandene Playlists des Benutzers auflisten [Optional]
  2. YOUTUBE_CREATE_PLAYLIST - Eine neue Playlist erstellen [Optional]
  3. YOUTUBE_ADD_VIDEO_TO_PLAYLIST - Ein Video zu einer Playlist hinzufügen [Optional]
  4. YOUTUBE_LIST_PLAYLIST_ITEMS - Videos in einer Playlist auflisten [Optional]

Wichtige Parameter:

  • playlistId: Playlist-ID ('PL...' für benutzerdefiniert, 'UU...' für Uploads)
  • part: Ressourcenteile, die enthalten sein sollen (z.B. 'snippet,contentDetails')
  • maxResults: Elemente pro Seite (1-50)
  • pageToken: Paginierungs-Token aus vorheriger Antwort

Fallstricke:

  • Kanal-IDs ('UC...') NICHT als Playlist-IDs übergeben; 'UC' in 'UU' umwandeln für Uploads
  • Große Playlists erfordern Paginierung über pageToken; folge nextPageToken bis es fehlt
  • items[].id ist nicht die videoId; verwende items[].snippet.resourceId.videoId
  • Doppelte Playlist-Namen sind erlaubt; überprüfe zuerst vorhandene Playlists

4. Kanal- und Videoanalysen abrufen

Wann verwenden: Der Benutzer möchte die Kanal-Performance oder Videometriken analysieren

Tool-Ablauf:

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Ein Handle in eine Kanal-ID auflösen [Voraussetzung]
  2. YOUTUBE_GET_CHANNEL_STATISTICS - Abonnenten-/Aufruf-/Videoanzahl des Kanals abrufen [Erforderlich]
  3. YOUTUBE_LIST_CHANNEL_VIDEOS - Alle Videos eines Kanals auflisten [Optional]
  4. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Pro-Video-Statistiken abrufen [Optional]
  5. 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: Komma-getrennte Video-IDs für Batch-Details
  • parts: Ressourcenteile, die enthalten sein sollen (z.B. 'snippet,statistics')

Fallstricke:

  • Kanalstatistiken sind Lebenszeit-Gesamtwerte, nicht pro Zeitraum
  • BATCH-Videodetails können bei privaten/gelöschten Videos weniger Elemente zurückgeben als angefordert
  • Antwortdaten können unter data oder data_preview verschachtelt sein; defensiv parsen
  • contentDetails.duration verwendet ISO 8601-Format (z.B. 'PT4M13S')

5. Abonnements und Kommentare verwalten

Wann verwenden: Der Benutzer möchte Kanäle abonnieren oder Videokommentare anzeigen

Tool-Ablauf:

  1. YOUTUBE_SUBSCRIBE_CHANNEL - Einen Kanal abonnieren [Optional]
  2. YOUTUBE_UNSUBSCRIBE_CHANNEL - Abonnement eines Kanals kündigen [Optional]
  3. YOUTUBE_LIST_USER_SUBSCRIPTIONS - Abonnements auflisten [Optional]
  4. YOUTUBE_LIST_COMMENT_THREADS - Kommentare zu einem Video auflisten [Optional]

Wichtige Parameter:

  • channelId: Kanal zum Abonnieren/Kündigen
  • videoId: Video-ID für Kommentar-Threads
  • maxResults: Ergebnisse pro Seite
  • pageToken: Paginierungs-Token

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 wird die Abonnement-ID benötigt, nicht die Kanal-ID

Häufige Muster

Kanal-ID-Auflösung

Handle zu Kanal-ID:

1. Rufe YOUTUBE_GET_CHANNEL_ID_BY_HANDLE mit '@handle' auf
2. Extrahiere channelId aus der Antwort
3. Verwende 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

  • maxResults setzen (maximal 50 pro Seite)
  • Antwort auf nextPageToken prüfen
  • Token als pageToken in der nächsten Anfrage übergeben
  • Fortsetzen, bis nextPageToken fehlt

Batch-Videodetails

  • Video-IDs aus Suchergebnissen oder Playlist-Auflistungen sammeln
  • In Gruppen von ~50 IDs aufteilen
  • GET_VIDEO_DETAILS_BATCH pro Gruppe aufrufen
  • Ergebnisse über alle Gruppen zusammenführen

Bekannte Fallstricke

Quotenverwaltung:

  • YouTube-API hat ein tägliches Quotenlimit (Standard 10.000 Einheiten)
  • Upload = 1600 Einheiten; Suche = 100 Einheiten; Liste = 1 Einheit
  • Bevorzuge Listen-Endpunkte gegenüber der Suche, wenn möglich
  • Quotennutzung überwachen, um tägliche Limits 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)
  • Kanal-IDs nicht mit Playlist-IDs verwechseln

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 Strings zurückgegeben, nicht als Ganzzahlen; vor Berechnungen umwandeln
  • Dauer verwendet ISO 8601-Format (PT#H#M#S)
  • Batch-Antworten können Daten unter verschiedenen Schlüsseln verpacken

Kurzreferenz

AufgabeTool-SlugWichtige Parameter
Video hochladenYOUTUBE_UPLOAD_VIDEOtitle, description, tags, categoryId, privacyStatus, videoFilePath
Video aktualisierenYOUTUBE_UPDATE_VIDEOvideo_id, title, description, tags
Thumbnail setzenYOUTUBE_UPDATE_THUMBNAILvideoId, thumbnailUrl
YouTube durchsuchenYOUTUBE_SEARCH_YOU_TUBEq, type, maxResults
VideodetailsYOUTUBE_VIDEO_DETAILSid, part
Batch-VideodetailsYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Playlists auflistenYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Playlist erstellenYOUTUBE_CREATE_PLAYLIST(Schema prüfen)
Zu Playlist hinzufügenYOUTUBE_ADD_VIDEO_TO_PLAYLIST(Schema prüfen)
Playlist-Elemente auflistenYOUTUBE_LIST_PLAYLIST_ITEMSplaylistId, maxResults
KanalstatistikenYOUTUBE_GET_CHANNEL_STATISTICSid/forHandle/mine
Kanalvideos auflistenYOUTUBE_LIST_CHANNEL_VIDEOSchannelId, maxResults
Kanal-ID per HandleYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
AbonnierenYOUTUBE_SUBSCRIBE_CHANNELchannelId
Abonnements auflistenYOUTUBE_LIST_USER_SUBSCRIPTIONS(Schema prüfen)
Kommentare auflistenYOUTUBE_LIST_COMMENT_THREADSvideoId
KanalaktivitätenYOUTUBE_GET_CHANNEL_ACTIVITIES(Schema prüfen)

Wann verwenden

Diese Fähigkeit (Skill) ist anwendbar, um den beschriebenen Workflow oder die beschriebenen Aktionen auszuführen.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills