Communitygithub.com

benjaminasterA/antigravity-awesome-skills

Automatisez les tâches YouTube via Rube MCP (Composio) : upload de vidéos, gestion de playlists, recherche de contenu, analyses et modération des commentaires. Consultez toujours les schémas d'outils en premier.

Qu'est-ce que antigravity-awesome-skills ?

Cette compétence permet d'automatiser les opérations YouTube via le kit d'outils YouTube de Composio, accessible par l'intermédiaire de Rube MCP. Elle est conçue pour les développeurs et les utilisateurs avancés qui souhaitent gérer leurs chaînes YouTube de manière programmatique, en effectuant des actions telles que l'upload et la mise à jour de vidéos, la gestion des playlists, la recherche de contenu, l'obtention d'analyses détaillées, la gestion des abonnements et des commentaires. Le système repose sur une connexion active à YouTube via Rube MCP, et il est impératif d'appeler d'abord l'outil `RUBE_SEARCH_TOOLS` pour obtenir les schémas à jour des outils avant chaque utilisation. Les workflows sont structurés en séquences d'outils avec des paramètres clés et des mises en garde concernant les limites de quota, les formats d'ID et les pièges courants de l'API YouTube. Cette compétence est idéale pour automatiser la publication de contenu, analyser les performances des chaînes et gérer les interactions de la communauté de manière efficace.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Automatisation YouTube via Rube MCP

Automatisez les opérations YouTube via le kit d'outils YouTube de Composio et Rube MCP.

Prérequis

  • Rube MCP doit être connecté (RUBE_SEARCH_TOOLS disponible)
  • Connexion YouTube active via RUBE_MANAGE_CONNECTIONS avec le kit d'outils youtube
  • Appelez toujours RUBE_SEARCH_TOOLS en premier pour obtenir les schémas d'outils actuels

Configuration

Obtenir Rube MCP : Ajoutez https://rube.app/mcp comme serveur MCP dans votre configuration client. Aucune clé API nécessaire — ajoutez simplement le point de terminaison et cela fonctionne.

  1. Vérifiez que Rube MCP est disponible en confirmant que RUBE_SEARCH_TOOLS répond
  2. Appelez RUBE_MANAGE_CONNECTIONS avec le kit d'outils youtube
  3. Si la connexion n'est pas ACTIVE, suivez le lien d'authentification renvoyé pour terminer l'OAuth Google
  4. Confirmez que le statut de la connexion indique ACTIVE avant d'exécuter des workflows

Workflows principaux

1. Uploader et gérer les vidéos

Quand utiliser : L'utilisateur souhaite uploader une vidéo ou mettre à jour les métadonnées d'une vidéo

Séquence d'outils :

  1. YOUTUBE_UPLOAD_VIDEO - Uploader une nouvelle vidéo [Requis]
  2. YOUTUBE_UPDATE_VIDEO - Mettre à jour le titre, la description, les tags, la confidentialité [Optionnel]
  3. YOUTUBE_UPDATE_THUMBNAIL - Définir une miniature personnalisée [Optionnel]

Paramètres clés :

  • title : Titre de la vidéo (100 caractères max)
  • description : Description de la vidéo (5000 octets max)
  • tags : Tableau de mots-clés
  • categoryId : ID de catégorie YouTube (ex. '22' pour People & Blogs)
  • privacyStatus : 'public', 'private', ou 'unlisted'
  • videoFilePath : Objet avec {name, mimetype, s3key} pour le fichier vidéo

Pièges :

  • UPLOAD_VIDEO consomme beaucoup de quota ; privilégiez UPDATE_VIDEO pour les modifications de métadonnées uniquement
  • videoFilePath doit être un objet avec s3key, pas un chemin de fichier brut ou une URL
  • La somme des tags ne doit pas dépasser 500 caractères, séparateurs inclus
  • Les chevrons < > dans les tags sont automatiquement supprimés
  • La limite de description est de 5000 octets, pas de caractères (les caractères multi-octets comptent plus)

2. Rechercher du contenu YouTube

Quand utiliser : L'utilisateur souhaite trouver des vidéos, des chaînes ou des playlists

Séquence d'outils :

  1. YOUTUBE_SEARCH_YOU_TUBE - Rechercher du contenu [Requis]
  2. YOUTUBE_VIDEO_DETAILS - Obtenir les détails complets d'une vidéo spécifique [Optionnel]
  3. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Obtenir les détails de plusieurs vidéos [Optionnel]

Paramètres clés :

  • q : Requête de recherche (prend en charge les phrases exactes, les exclusions, les handles de chaîne)
  • type : 'video', 'channel', ou 'playlist'
  • maxResults : Résultats par page (1-50)
  • pageToken : Pour la pagination

Pièges :

  • Le point de terminaison de recherche ne renvoie que la partie 'snippet' ; utilisez VIDEO_DETAILS pour les statistiques
  • Les résultats de recherche sont limités à 500 éléments au total
  • La recherche a un coût de quota plus élevé (100 unités) par rapport aux points de terminaison de liste (1 unité)
  • La limite pratique pour les détails de vidéos en lot est d'environ 50 ID par appel ; découpez les ensembles plus grands

3. Gérer les playlists

Quand utiliser : L'utilisateur souhaite créer des playlists ou gérer le contenu des playlists

Séquence d'outils :

  1. YOUTUBE_LIST_USER_PLAYLISTS - Lister les playlists existantes de l'utilisateur [Optionnel]
  2. YOUTUBE_CREATE_PLAYLIST - Créer une nouvelle playlist [Optionnel]
  3. YOUTUBE_ADD_VIDEO_TO_PLAYLIST - Ajouter une vidéo à une playlist [Optionnel]
  4. YOUTUBE_LIST_PLAYLIST_ITEMS - Lister les vidéos dans une playlist [Optionnel]

Paramètres clés :

  • playlistId : ID de la playlist ('PL...' pour les playlists créées par l'utilisateur, 'UU...' pour les uploads)
  • part : Parties de la ressource à inclure (ex. 'snippet,contentDetails')
  • maxResults : Éléments par page (1-50)
  • pageToken : Jeton de pagination de la réponse précédente

Pièges :

  • NE PAS passer les ID de chaîne ('UC...') comme ID de playlist ; convertissez 'UC' en 'UU' pour les uploads
  • Les grandes playlists nécessitent une pagination via pageToken ; suivez nextPageToken jusqu'à son absence
  • items[].id n'est pas le videoId ; utilisez items[].snippet.resourceId.videoId
  • La création de noms de playlist en double est autorisée ; vérifiez d'abord les playlists existantes

4. Obtenir des analyses de chaîne et de vidéo

Quand utiliser : L'utilisateur souhaite analyser les performances d'une chaîne ou les métriques d'une vidéo

Séquence d'outils :

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Résoudre un handle en ID de chaîne [Prérequis]
  2. YOUTUBE_GET_CHANNEL_STATISTICS - Obtenir les comptes d'abonnés/vues/vidéos de la chaîne [Requis]
  3. YOUTUBE_LIST_CHANNEL_VIDEOS - Lister toutes les vidéos d'une chaîne [Optionnel]
  4. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Obtenir les statistiques par vidéo [Optionnel]
  5. YOUTUBE_GET_CHANNEL_ACTIVITIES - Obtenir les activités récentes de la chaîne [Optionnel]

Paramètres clés :

  • channelId : ID de chaîne ('UC...'), handle ('@handle'), ou 'me'
  • forHandle : Handle de chaîne (ex. '@Google')
  • id : ID de vidéos séparés par des virgules pour les détails en lot
  • parts : Parties de la ressource à inclure (ex. 'snippet,statistics')

Pièges :

  • Les statistiques de chaîne sont des totaux cumulés, pas par période
  • Les détails de vidéos en lot peuvent renvoyer moins d'éléments que demandé pour les vidéos privées/supprimées
  • Les données de réponse peuvent être imbriquées sous data ou data_preview ; analysez de manière défensive
  • contentDetails.duration utilise le format ISO 8601 (ex. 'PT4M13S')

5. Gérer les abonnements et les commentaires

Quand utiliser : L'utilisateur souhaite s'abonner à des chaînes ou consulter les commentaires des vidéos

Séquence d'outils :

  1. YOUTUBE_SUBSCRIBE_CHANNEL - S'abonner à une chaîne [Optionnel]
  2. YOUTUBE_UNSUBSCRIBE_CHANNEL - Se désabonner d'une chaîne [Optionnel]
  3. YOUTUBE_LIST_USER_SUBSCRIPTIONS - Lister les abonnements [Optionnel]
  4. YOUTUBE_LIST_COMMENT_THREADS - Lister les commentaires d'une vidéo [Optionnel]

Paramètres clés :

  • channelId : Chaîne à laquelle s'abonner/se désabonner
  • videoId : ID de la vidéo pour les fils de commentaires
  • maxResults : Résultats par page
  • pageToken : Jeton de pagination

Pièges :

  • S'abonner à une chaîne déjà abonnée peut renvoyer une erreur
  • Les fils de commentaires renvoient les commentaires de premier niveau avec jusqu'à 5 réponses chacun
  • Les commentaires peuvent être désactivés sur certaines vidéos
  • Se désabonner nécessite l'ID d'abonnement, pas l'ID de la chaîne

Modèles courants

Résolution d'ID de chaîne

Handle en ID de chaîne :

1. Appelez YOUTUBE_GET_CHANNEL_ID_BY_HANDLE avec '@handle'
2. Extrayez channelId de la réponse
3. Utilisez-le dans les opérations ultérieures sur la chaîne

Playlist d'uploads :

1. Obtenez l'ID de la chaîne (commence par 'UC')
2. Remplacez le préfixe 'UC' par 'UU' pour obtenir l'ID de la playlist d'uploads
3. Utilisez avec LIST_PLAYLIST_ITEMS pour énumérer toutes les vidéos

Pagination

  • Définissez maxResults (max 50 par page)
  • Vérifiez la réponse pour nextPageToken
  • Passez le jeton comme pageToken dans la requête suivante
  • Continuez jusqu'à ce que nextPageToken soit absent

Détails de vidéos en lot

  • Collectez les ID de vidéos à partir des résultats de recherche ou de listes de playlists
  • Découpez en groupes d'environ 50 ID
  • Appelez GET_VIDEO_DETAILS_BATCH par groupe
  • Fusionnez les résultats entre les groupes

Pièges connus

Gestion du quota :

  • L'API YouTube a une limite de quota quotidienne (10 000 unités par défaut)
  • Upload = 1 600 unités ; recherche = 100 unités ; liste = 1 unité
  • Préférez les points de terminaison de liste à la recherche lorsque c'est possible
  • Surveillez l'utilisation du quota pour éviter d'atteindre les limites quotidiennes

Formats d'ID :

  • ID de vidéos : chaînes alphanumériques de 11 caractères
  • ID de chaînes : commencent par 'UC' suivis de 22 caractères
  • ID de playlists : commencent par 'PL' (utilisateur) ou 'UU' (uploads)
  • Ne confondez pas les ID de chaîne avec les ID de playlist

Miniatures :

  • Les miniatures personnalisées nécessitent une vérification téléphonique de la chaîne
  • Doivent être JPG, PNG ou GIF ; moins de 2 Mo
  • Recommandé : résolution 1280x720 (format 16:9)

Analyse des réponses :

  • Les valeurs des statistiques sont renvoyées sous forme de chaînes, pas d'entiers ; convertissez avant les opérations mathématiques
  • La durée utilise le format ISO 8601 (PT#H#M#S)
  • Les réponses par lot peuvent encapsuler les données sous différentes clés

Référence rapide

TâcheSlug d'outilParamètres clés
Uploader une vidéoYOUTUBE_UPLOAD_VIDEOtitle, description, tags, categoryId, privacyStatus, videoFilePath
Mettre à jour une vidéoYOUTUBE_UPDATE_VIDEOvideo_id, title, description, tags
Définir une miniatureYOUTUBE_UPDATE_THUMBNAILvideoId, thumbnailUrl
Rechercher sur YouTubeYOUTUBE_SEARCH_YOU_TUBEq, type, maxResults
Détails d'une vidéoYOUTUBE_VIDEO_DETAILSid, part
Détails de vidéos en lotYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Lister les playlistsYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Créer une playlistYOUTUBE_CREATE_PLAYLIST(vérifier le schéma)
Ajouter à une playlistYOUTUBE_ADD_VIDEO_TO_PLAYLIST(vérifier le schéma)
Lister les éléments d'une playlistYOUTUBE_LIST_PLAYLIST_ITEMSplaylistId, maxResults
Statistiques de chaîneYOUTUBE_GET_CHANNEL_STATISTICSid/forHandle/mine
Lister les vidéos d'une chaîneYOUTUBE_LIST_CHANNEL_VIDEOSchannelId, maxResults
ID de chaîne par handleYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
S'abonnerYOUTUBE_SUBSCRIBE_CHANNELchannelId
Lister les abonnementsYOUTUBE_LIST_USER_SUBSCRIPTIONS(vérifier le schéma)
Lister les commentairesYOUTUBE_LIST_COMMENT_THREADSvideoId
Activités de chaîneYOUTUBE_GET_CHANNEL_ACTIVITIES(vérifier le schéma)

Quand utiliser

Cette compétence est applicable pour exécuter le workflow ou les actions décrits dans l'aperçu.

Individual skills in this repo

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

Skills associés