Automatización de YouTube a través de Rube MCP
Regla de Lectura Selectiva
Comience con:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Luego cargue solo los documentos, scripts, activos o ejemplos heredados que coincidan con la tarea real del usuario.
Automatice las operaciones de YouTube a través del toolkit de YouTube de Composio mediante Rube MCP.
Prerrequisitos
- Rube MCP debe estar conectado (
RUBE_SEARCH_TOOLSdisponible) - Conexión activa de YouTube a través de
RUBE_MANAGE_CONNECTIONScon el toolkityoutube - Siempre llame primero a
RUBE_SEARCH_TOOLSpara obtener los esquemas de herramientas actuales
Configuración
Obtener Rube MCP: Agregue https://rube.app/mcp como un servidor MCP en la configuración de su cliente. No se necesitan claves API — solo agregue el endpoint y funciona.
- Verifique que Rube MCP esté disponible confirmando que
RUBE_SEARCH_TOOLSresponda - Llame a
RUBE_MANAGE_CONNECTIONScon el toolkityoutube - Si la conexión no está ACTIVA, siga el enlace de autenticación devuelto para completar la OAuth de Google
- Confirme que el estado de la conexión muestre ACTIVO antes de ejecutar cualquier flujo de trabajo
Flujos de Trabajo Principales
1. Subir y Gestionar Videos
Cuándo usar: El usuario desea subir un video o actualizar los metadatos del video
Secuencia de herramientas:
YOUTUBE_UPLOAD_VIDEO- Subir un video nuevo [Requerido]YOUTUBE_UPDATE_VIDEO- Actualizar título, descripción, etiquetas, privacidad [Opcional]YOUTUBE_UPDATE_THUMBNAIL- Establecer una miniatura personalizada [Opcional]
Parámetros clave:
title: Título del video (máximo 100 caracteres)description: Descripción del video (máximo 5000 bytes)tags: Arreglo de etiquetas clavecategoryId: ID de categoría de YouTube (ej., '22' para Personas y Blogs)privacyStatus: 'public', 'private' o 'unlisted'videoFilePath: Objeto con{name, mimetype, s3key}para el archivo de video
Errores comunes:
- UPLOAD_VIDEO consume mucha cuota; prefiera UPDATE_VIDEO para cambios solo de metadatos
- videoFilePath debe ser un objeto con s3key, no una ruta de archivo o URL
- Las etiquetas no deben exceder 500 caracteres en total, incluidos los separadores
- Los corchetes angulares
< >en las etiquetas se eliminan automáticamente - El límite de descripción es 5000 bytes, no caracteres (los caracteres multibyte cuentan más)
2. Buscar Contenido de YouTube
Cuándo usar: El usuario desea encontrar videos, canales o listas de reproducción
Secuencia de herramientas:
YOUTUBE_SEARCH_YOU_TUBE- Buscar contenido [Requerido]YOUTUBE_VIDEO_DETAILS- Obtener detalles completos de un video específico [Opcional]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Obtener detalles de múltiples videos [Opcional]
Parámetros clave:
q: Consulta de búsqueda (admite frases exactas, exclusiones, identificadores de canal)type: 'video', 'channel' o 'playlist'maxResults: Resultados por página (1-50)pageToken: Para paginación
Errores comunes:
- El endpoint de búsqueda solo devuelve la parte 'snippet'; use VIDEO_DETAILS para estadísticas
- Los resultados de búsqueda tienen un límite de 500 elementos en total
- La búsqueda tiene un costo de cuota más alto (100 unidades) en comparación con los endpoints de lista (1 unidad)
- El límite práctico de BATCH video details es de ~50 IDs por llamada; divida conjuntos más grandes
3. Gestionar Listas de Reproducción
Cuándo usar: El usuario desea crear listas de reproducción o gestionar su contenido
Secuencia de herramientas:
YOUTUBE_LIST_USER_PLAYLISTS- Listar listas de reproducción existentes del usuario [Opcional]YOUTUBE_CREATE_PLAYLIST- Crear una nueva lista de reproducción [Opcional]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- Agregar un video a una lista de reproducción [Opcional]YOUTUBE_LIST_PLAYLIST_ITEMS- Listar videos en una lista de reproducción [Opcional]
Parámetros clave:
playlistId: ID de la lista de reproducción ('PL...' para creada por usuario, 'UU...' para subidas)part: Partes del recurso a incluir (ej., 'snippet,contentDetails')maxResults: Elementos por página (1-50)pageToken: Token de paginación de la respuesta anterior
Errores comunes:
- NO pase ID de canal ('UC...') como ID de lista de reproducción; convierta 'UC' a 'UU' para subidas
- Las listas de reproducción grandes requieren paginación mediante pageToken; siga nextPageToken hasta que esté ausente
- items[].id no es el videoId; use items[].snippet.resourceId.videoId
- Crear nombres duplicados de listas de reproducción está permitido; verifique las listas existentes primero
4. Obtener Análisis de Canal y Video
Cuándo usar: El usuario desea analizar el rendimiento del canal o métricas de video
Secuencia de herramientas:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- Resolver un identificador a ID de canal [Prerrequisito]YOUTUBE_GET_CHANNEL_STATISTICS- Obtener conteos de suscriptores/vistas/videos del canal [Requerido]YOUTUBE_LIST_CHANNEL_VIDEOS- Listar todos los videos de un canal [Opcional]YOUTUBE_GET_VIDEO_DETAILS_BATCH- Obtener estadísticas por video [Opcional]YOUTUBE_GET_CHANNEL_ACTIVITIES- Obtener actividades recientes del canal [Opcional]
Parámetros clave:
channelId: ID del canal ('UC...'), identificador ('@handle') o 'me'forHandle: Identificador del canal (ej., '@Google')id: ID de video separados por comas para detalles por loteparts: Partes del recurso a incluir (ej., 'snippet,statistics')
Errores comunes:
- Las estadísticas del canal son totales de por vida, no por período
- BATCH video details puede devolver menos elementos de los solicitados para videos privados/eliminados
- Los datos de respuesta pueden estar anidados bajo
dataodata_preview; analice de manera defensiva - contentDetails.duration usa el formato ISO 8601 (ej., 'PT4M13S')
5. Gestionar Suscripciones y Comentarios
Cuándo usar: El usuario desea suscribirse a canales o ver comentarios de videos
Secuencia de herramientas:
YOUTUBE_SUBSCRIBE_CHANNEL- Suscribirse a un canal [Opcional]YOUTUBE_UNSUBSCRIBE_CHANNEL- Cancelar suscripción a un canal [Opcional]YOUTUBE_LIST_USER_SUBSCRIPTIONS- Listar suscripciones [Opcional]YOUTUBE_LIST_COMMENT_THREADS- Listar comentarios en un video [Opcional]
Parámetros clave:
channelId: Canal para suscribir/cancelar suscripciónvideoId: ID del video para hilos de comentariosmaxResults: Resultados por páginapageToken: Token de paginación
Errores comunes:
- Suscribirse a un canal ya suscrito puede devolver un error
- Los hilos de comentarios devuelven comentarios de nivel superior con hasta 5 respuestas cada uno
- Los comentarios pueden estar deshabilitados en algunos videos
- Cancelar suscripción requiere el ID de suscripción, no el ID del canal
Patrones Comunes
Resolución de ID de Canal
Identificador a ID de Canal:
1. Llame a YOUTUBE_GET_CHANNEL_ID_BY_HANDLE con '@handle'
2. Extraiga channelId de la respuesta
3. Use en operaciones posteriores del canal
Lista de Reproducción de Subidas:
1. Obtenga el ID del canal (comienza con 'UC')
2. Reemplace el prefijo 'UC' con 'UU' para obtener el ID de la lista de reproducción de subidas
3. Use con LIST_PLAYLIST_ITEMS para enumerar todos los videos
Paginación
- Establezca
maxResults(máx. 50 por página) - Verifique la respuesta en busca de
nextPageToken - Pase el token como
pageTokenen la siguiente solicitud - Continúe hasta que
nextPageTokenesté ausente
Detalles de Video por Lote
- Recolecte IDs de video de búsquedas o listados de listas de reproducción
- Divida en grupos de ~50 IDs
- Llame a GET_VIDEO_DETAILS_BATCH por grupo
- Combine resultados entre grupos
Errores Conocidos
Gestión de Cuota:
- La API de YouTube tiene un límite de cuota diario (predeterminado 10,000 unidades)
- Subida = 1600 unidades; búsqueda = 100 unidades; lista = 1 unidad
- Prefiera endpoints de lista sobre búsqueda cuando sea posible
- Monitoree el uso de cuota para evitar alcanzar los límites diarios
Formatos de ID:
- IDs de video: cadenas alfanuméricas de 11 caracteres
- IDs de canal: comienzan con 'UC' seguido de 22 caracteres
- IDs de lista de reproducción: comienzan con 'PL' (usuario) o 'UU' (subidas)
- No confunda IDs de canal con IDs de lista de reproducción
Miniaturas:
- Las miniaturas personalizadas requieren verificación telefónica del canal
- Deben ser JPG, PNG o GIF; menores a 2MB
- Recomendado: resolución 1280x720 (relación de aspecto 16:9)
Análisis de Respuestas:
- Los valores de estadísticas se devuelven como cadenas, no enteros; convierta antes de operaciones matemáticas
- La duración usa el formato ISO 8601 (PT#H#M#S)
- Las respuestas por lote pueden envolver datos bajo diferentes claves
Referencia Rápida
| Tarea | Slug de Herramienta | Parámetros Clave |
|---|---|---|
| Subir video | YOUTUBE_UPLOAD_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| Actualizar video | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| Establecer miniatura | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| Buscar en YouTube | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| Detalles de video | YOUTUBE_VIDEO_DETAILS | id, part |
| Detalles de video por lote | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| Listar listas de reproducción | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| Crear lista de reproducción | YOUTUBE_CREATE_PLAYLIST | (consultar esquema) |
| Agregar a lista de reproducción | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (consultar esquema) |
| Listar elementos de lista | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| Estadísticas de canal | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| Listar videos de canal | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| ID de canal por identificador | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| Suscribirse | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| Listar suscripciones | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (consultar esquema) |
| Listar comentarios | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| Actividades de canal | YOUTUBE_GET_CHANNEL_ACTIVITIES | (consultar esquema) |
Cuándo Usar
Esta habilidad es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.
Limitaciones
- Use esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trate la salida como un sustituto de la validación específica del entorno, pruebas o revisión de expertos.
- Deténgase y solicite aclaración si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.