Automatisation YouTube via Rube MCP
Automatisez les opérations YouTube à travers la boîte à outils YouTube de Composio via Rube MCP.
Prérequis
- Rube MCP doit être connecté (
RUBE_SEARCH_TOOLSdisponible) - Connexion YouTube active via
RUBE_MANAGE_CONNECTIONSavec la boîte à outilsyoutube - Appelez toujours
RUBE_SEARCH_TOOLSen 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.
- Vérifiez que Rube MCP est disponible en confirmant que
RUBE_SEARCH_TOOLSrépond - Appelez
RUBE_MANAGE_CONNECTIONSavec la boîte à outilsyoutube - Si la connexion n'est pas ACTIVE, suivez le lien d'authentification retourné pour terminer l'OAuth Google
- Confirmez que l'état de la connexion est ACTIVE avant d'exécuter des workflows
Workflows principaux
1. Télécharger et gérer des vidéos
Quand utiliser : L'utilisateur souhaite télécharger une vidéo ou mettre à jour les métadonnées d'une vidéo
Séquence d'outils :
YOUTUBE_UPLOAD_VIDEO- Télécharger une nouvelle vidéo [Requis]YOUTUBE_UPDATE_VIDEO- Mettre à jour le titre, la description, les tags, la confidentialité [Optionnel]YOUTUBE_UPDATE_THUMBNAIL- Définir une miniature personnalisée [Optionnel]
Paramètres clés :
title: Titre de la vidéo (max 100 caractères)description: Description de la vidéo (max 5000 octets)tags: Tableau de mots-cléscategoryId: ID de catégorie YouTube (ex. '22' pour Personnes et 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 ; préférez 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
- Le total 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 :
YOUTUBE_SEARCH_YOU_TUBE- Rechercher du contenu [Requis]YOUTUBE_VIDEO_DETAILS- Obtenir les détails complets d'une vidéo spécifique [Optionnel]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Obtenir les détails de plusieurs vidéos [Optionnel]
Paramètres clés :
q: Requête de recherche (supporte les expressions exactes, les exclusions, les pseudos de chaînes)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 batch est d'environ 50 ID par appel ; divisez 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 :
YOUTUBE_LIST_USER_PLAYLISTS- Lister les playlists existantes de l'utilisateur [Optionnel]YOUTUBE_CREATE_PLAYLIST- Créer une nouvelle playlist [Optionnel]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- Ajouter une vidéo à une playlist [Optionnel]YOUTUBE_LIST_PLAYLIST_ITEMS- Lister les vidéos d'une playlist [Optionnel]
Paramètres clés :
playlistId: ID de la playlist ('PL...' pour celles créées par l'utilisateur, 'UU...' pour les téléchargements)part: Parties de 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 téléchargements
- 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 :
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- Résoudre un pseudo en ID de chaîne [Prérequis]YOUTUBE_GET_CHANNEL_STATISTICS- Obtenir les comptes d'abonnés/vues/vidéos d'une chaîne [Requis]YOUTUBE_LIST_CHANNEL_VIDEOS- Lister toutes les vidéos d'une chaîne [Optionnel]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Obtenir les statistiques par vidéo [Optionnel]YOUTUBE_GET_CHANNEL_ACTIVITIES- Obtenir les activités récentes d'une chaîne [Optionnel]
Paramètres clés :
channelId: ID de la chaîne ('UC...'), pseudo ('@pseudo') ou 'me'forHandle: Pseudo de la chaîne (ex. '@Google')id: ID de vidéos séparés par des virgules pour les détails en batchparts: Parties de ressource à inclure (ex. 'snippet,statistics')
Pièges :
- Les statistiques de chaîne sont des totaux à vie, pas par période
- Les détails de vidéos en batch 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
dataoudata_preview; analysez défensivement - 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 voir les commentaires de vidéos
Séquence d'outils :
YOUTUBE_SUBSCRIBE_CHANNEL- S'abonner à une chaîne [Optionnel]YOUTUBE_UNSUBSCRIBE_CHANNEL- Se désabonner d'une chaîne [Optionnel]YOUTUBE_LIST_USER_SUBSCRIPTIONS- Lister les abonnements [Optionnel]YOUTUBE_LIST_COMMENT_THREADS- Lister les commentaires d'une vidéo [Optionnel]
Paramètres clés :
channelId: Chaîne à laquelle s'abonner/se désabonnervideoId: ID de la vidéo pour les fils de commentairesmaxResults: Résultats par pagepageToken: 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
- Le désabonnement nécessite l'ID d'abonnement, pas l'ID de la chaîne
Modèles courants
Résolution d'ID de chaîne
Pseudo en ID de chaîne :
1. Appelez YOUTUBE_GET_CHANNEL_ID_BY_HANDLE avec '@pseudo'
2. Extrayez channelId de la réponse
3. Utilisez-le dans les opérations ultérieures sur la chaîne
Playlist de téléchargements :
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 de téléchargements
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
pageTokendans la requête suivante - Continuez jusqu'à ce que
nextPageTokensoit absent
Détails de vidéos en batch
- Collectez les ID de vidéos à partir des recherches ou des listes de playlists
- Divisez 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)
- Téléchargement = 1600 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' (téléchargements)
- Ne confondez pas les ID de chaînes avec les ID de playlists
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 (rapport d'aspect 16:9)
Analyse des réponses :
- Les valeurs statistiques sont renvoyées sous forme de chaînes, pas d'entiers ; convertissez-les avant les calculs
- La durée utilise le format ISO 8601 (PT#H#M#S)
- Les réponses en batch peuvent encapsuler les données sous différentes clés
Référence rapide
| Tâche | Slug d'outil | Paramètres clés |
|---|---|---|
| Télécharger une vidéo | YOUTUBE_UPLOAD_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| Mettre à jour une vidéo | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| Définir une miniature | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| Rechercher sur YouTube | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| Détails d'une vidéo | YOUTUBE_VIDEO_DETAILS | id, part |
| Détails de vidéos en batch | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| Lister les playlists | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| Créer une playlist | YOUTUBE_CREATE_PLAYLIST | (vérifier le schéma) |
| Ajouter à une playlist | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (vérifier le schéma) |
| Lister les éléments d'une playlist | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| Statistiques de chaîne | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| Lister les vidéos d'une chaîne | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| ID de chaîne par pseudo | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| S'abonner | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| Lister les abonnements | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (vérifier le schéma) |
| Lister les commentaires | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| Activités de chaîne | YOUTUBE_GET_CHANNEL_ACTIVITIES | (vérifier le schéma) |