Automatisation YouTube via Rube MCP
Règle de lecture sélective
Commencez par :
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Chargez ensuite uniquement les documents, scripts, ressources ou exemples hérités qui correspondent à la tâche réelle de l'utilisateur.
Automatisez les opérations YouTube via le kit d'outils YouTube de Composio via Rube MCP.
Prérequis
- Rube MCP doit être connecté (
RUBE_SEARCH_TOOLSdisponible) - Connexion YouTube active via
RUBE_MANAGE_CONNECTIONSavec le kit d'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 le kit d'outilsyoutube - Si la connexion n'est pas ACTIVE, suivez le lien d'authentification renvoyé pour terminer l'OAuth Google
- Confirmez que l'état 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 les métadonnées d'une vidéo
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 vignette 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 & Blogs)privacyStatus: 'public', 'private' ou 'unlisted'videoFilePath: Objet avec{name, mimetype, s3key}pour le fichier vidéo
Pièges :
- UPLOAD_VIDEO consomme un quota élevé ; 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 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 (supporte les phrases exactes, exclusions, identifiants 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 list (1 unité)
- La limite pratique pour les détails par lot est d'environ 50 ID par appel ; divisez les ensembles plus grands en lots
3. Gérer les playlists
Quand l'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 dans une playlist [Optionnel]
Paramètres clés :
playlistId: ID de la playlist ('PL...' pour créée par l'utilisateur, 'UU...' pour les téléchargements)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 téléchargements
- Les grandes playlists nécessitent une pagination via pageToken ; suivez nextPageToken jusqu'à ce qu'il soit absent
- 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 identifiant en ID de chaîne [Prérequis]YOUTUBE_GET_CHANNEL_STATISTICS- Obtenir les nombres d'abonnés/vues/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 de la chaîne [Optionnel]
Paramètres clés :
channelId: ID de la chaîne ('UC...'), identifiant ('@handle') ou 'me'forHandle: Identifiant de la chaîne (ex. '@Google')id: IDs de vidéos séparés par des virgules pour les détails par lotparts: Parties de la ressource à inclure (ex. 'snippet,statistics')
Pièges :
- Les statistiques de chaîne sont des totaux sur la durée de vie, pas par période
- Les détails par lot peuvent renvoyer moins d'éléments que demandés pour les vidéos privées/supprimées
- Les données de réponse peuvent être imbriquées sous
dataoudata_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 l'utiliser : L'utilisateur souhaite s'abonner à des chaînes ou voir les commentaires 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 sur 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
Schémas courants
Résolution d'ID de chaîne
Identifiant 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-le 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 par lot de vidéos
- Collectez les ID de vidéos à partir des résultats de recherche 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 des quotas :
- L'API YouTube a une limite de quota quotidienne (par défaut 10 000 unités)
- Téléchargement = 1600 unités ; recherche = 100 unités ; liste = 1 unité
- Préférez les points de terminaison de liste à la recherche quand 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îne avec les ID de playlist
Vignettes :
- Les vignettes 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 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 vignette | 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 par lot de vidéos | 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 identifiant | 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) |
Quand l'utiliser
Cette compétence est applicable pour exécuter le workflow ou les actions décrits dans l'aperçu.
Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
- Ne considérez pas le résultat comme un substitut à une validation, un test ou un examen d'expert spécifique à l'environnement.
- Arrêtez-vous et demandez des éclaircissements si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.