Automatisation YouTube via Rube MCP
Automatisez les opérations YouTube via le kit d'outils YouTube de Composio à travers 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 d'accès 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 compléter 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 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 (maximum 100 caractères)description: Description de la vidéo (maximum 5000 octets)tags: Tableau de tags par mots-cléscategoryId: 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 ; 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 crochets angulaires
< >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 (prend en charge les phrases exactes, les exclusions, les handles de chaînes)type: 'video', 'channel' ou 'playlist'maxResults: Résultats par page (1-50)pageToken: Pour la pagination
Pièges :
- Le point d'accès de recherche ne renvoie que la partie 'snippet' ; utilisez VIDEO_DETAILS pour les statistiques
- Les résultats de recherche sont plafonnés à 500 éléments au total
- La recherche a un coût de quota plus élevé (100 unités) par rapport aux points d'accès de liste (1 unité)
- La limite pratique pour les détails vidéo en lot est d'environ 50 IDs par appel ; segmentez 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 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 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'IDs de chaîne ('UC...') comme IDs 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 handle en ID de chaîne [Prérequis]YOUTUBE_GET_CHANNEL_STATISTICS- Obtenir les comptes d'abonnés/vues/vidéos de la 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 de la chaîne [Optionnel]
Paramètres clés :
channelId: ID de chaîne ('UC...'), handle ('@handle') ou 'me'forHandle: Handle de la chaîne (ex. '@Google')id: IDs de vidéo 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 vidéo 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 utiliser : L'utilisateur souhaite s'abonner à des chaînes ou voir les commentaires des 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 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
Modèles courants
Résolution d'ID de chaîne
Handle vers ID de chaîne :
1. Appeler YOUTUBE_GET_CHANNEL_ID_BY_HANDLE avec '@handle'
2. Extraire channelId de la réponse
3. Utiliser dans les opérations suivantes de la chaîne
Playlist de téléchargements :
1. Obtenir l'ID de la chaîne (commence par 'UC')
2. Remplacer le préfixe 'UC' par 'UU' pour obtenir l'ID de la playlist de téléchargements
3. Utiliser avec LIST_PLAYLIST_ITEMS pour énumérer toutes les vidéos
Pagination
- Définir
maxResults(maximum 50 par page) - Vérifier la présence de
nextPageTokendans la réponse - Passer le jeton comme
pageTokendans la requête suivante - Continuer jusqu'à ce que
nextPageTokensoit absent
Détails vidéo en lot
- Collecter les IDs de vidéo à partir de la recherche ou des listes de playlists
- Segmenter en groupes d'environ 50 IDs
- Appeler GET_VIDEO_DETAILS_BATCH par segment
- Fusionner les résultats entre les segments
Pièges connus
Gestion des quotas :
- L'API YouTube a une limite de quota quotidienne (par défaut 10 000 unités)
- Upload = 1600 unités ; search = 100 unités ; list = 1 unité
- Préférez les points d'accès 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éo : chaînes alphanumériques de 11 caractères
- IDs de chaîne : commencent par 'UC' suivis de 22 caractères
- IDs de playlist : 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
- Doivent être au format JPG, PNG ou GIF ; moins de 2 Mo
- Recommandé : résolution 1280x720 (ratio 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 en lot peuvent encapsuler les données sous différentes clés
Référence rapide
| Tâche | Nom 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 de la vidéo | YOUTUBE_VIDEO_DETAILS | id, part |
| Détails vidéo 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 la 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 la chaîne | YOUTUBE_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 la vue d'ensemble.
Limitations
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation spécifique à l'environnement, des tests ou une revue experte.
- Arrêtez-vous et demandez des clarifications si les entrées, les autorisations, les limites de sécurité ou les critères de succès requis sont manquants.