Automatisation YouTube via Rube MCP
Automatisez les opérations YouTube grâce au toolkit YouTube de Composio via Rube MCP.
Prérequis
- Rube MCP doit être connecté (
RUBE_SEARCH_TOOLSdisponible) - Connexion YouTube active via
RUBE_MANAGE_CONNECTIONSavec le toolkityoutube - 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 la configuration de votre 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 le toolkityoutube - Si la connexion n'est pas ACTIVE, suivez le lien d'authentification renvoyé pour terminer l'OAuth Google
- Confirmez que le statut de la connexion indique ACTIVE avant d'exécuter des workflows
Workflows principaux
1. Télécharger et gérer des vidéos
Quand l'utiliser : L'utilisateur souhaite télécharger une vidéo ou mettre à jour ses métadonnées
Séquence d'outils :
YOUTUBE_UPLOAD_VIDEO- Télécharger une nouvelle vidéo [Obligatoire]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 (100 caractères max)description: Description de la vidéo (5000 octets max)tags: Tableau de mots-cléscategoryId: ID de catégorie YouTube (ex. '22' pour People & Blogs)privacyStatus: 'public', 'private' ou 'unlisted'videoFilePath: Objet{name, mimetype, s3key}pour le fichier vidéo
Pièges :
- UPLOAD_VIDEO consomme un quota élevé ; préférez UPDATE_VIDEO pour les changements de métadonnées uniquement
- videoFilePath doit être un objet avec s3key, pas un chemin de fichier brut ou une URL
- Les tags ne doivent 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 l'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 [Obligatoire]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 (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 IDs par appel ; divisez les ensembles plus grands
3. Gérer les playlists
Quand l'utiliser : L'utilisateur souhaite créer des playlists ou gérer leur contenu
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 les playlists créées, '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 d'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 l'utiliser : L'utilisateur souhaite analyser les performances d'une chaîne ou les métriques vidéo
Séquence d'outils :
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- Résoudre un handle en ID de chaîne [Prérequis]YOUTUBE_GET_CHANNEL_STATISTICS- Obtenir le nombre d'abonnés, de vues et de vidéos de la chaîne [Obligatoire]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...'), handle ('@handle') ou 'me'forHandle: Handle de la chaîne (ex. '@Google')id: IDs de vidéos séparés par des virgules pour les détails en lotparts: Parties de 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
dataoudata_preview; analysez défensivement - contentDetails.duration utilise le format ISO 8601 (ex. 'PT4M13S')
5. Gérer les abonnements et les commentaires
Quand l'utiliser : L'utilisateur souhaite s'abonner à des chaînes ou voir les commentaires d'une vidéo
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
- Se désabonner nécessite l'ID d'abonnement, pas l'ID de la chaîne
Motifs courants
Résolution d'ID de chaîne
Handle vers 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 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(50 max par page) - Vérifiez la présence de
nextPageTokendans la réponse - Passez le jeton comme
pageTokendans la requête suivante - Continuez jusqu'à ce que
nextPageTokensoit absent
Détails de vidéos en lot
- Collectez les IDs de vidéos à partir de la recherche ou des listes de playlists
- Divisez en groupes d'environ 50 IDs
- 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 :
- IDs de vidéos : chaînes alphanumériques de 11 caractères
- IDs de chaînes : commencent par 'UC' suivis de 22 caractères
- IDs de playlists : commencent par 'PL' (utilisateur) ou 'UU' (téléchargements)
- Ne confondez pas les IDs de chaîne avec les IDs de playlist
Miniatures :
- Les miniatures personnalisées nécessitent une vérification téléphonique de la chaîne
- Doit être JPG, PNG ou GIF ; moins de 2 Mo
- Recommandé : résolution 1280x720 (rapport d'aspect 16:9)
Analyse des réponses :
- Les valeurs des statistiques sont renvoyées sous forme de chaînes, pas d'entiers ; convertissez avant de faire des calculs
- 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âche | Slug de l'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 lot | 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 handle | 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) |