Communitygithub.com

benjaminasterA/antigravity-awesome-skills

Automatiza tareas de YouTube mediante Rube MCP (Composio): subir videos, gestionar listas de reproducción, buscar contenido, obtener análisis y manejar comentarios. Siempre busca las herramientas primero para obtener los esquemas actuales.

¿Qué es antigravity-awesome-skills?

Este skill permite a un agente de IA (como Claude Code, Cursor o Codex) automatizar completamente las operaciones de YouTube a través del toolkit de YouTube de Composio expuesto por Rube MCP. Proporciona flujos de trabajo listos para usar para subir y actualizar videos, buscar contenido, gestionar listas de reproducción, obtener estadísticas de canales y videos, y manejar suscripciones y comentarios. El skill enfatiza la importancia de llamar primero a `RUBE_SEARCH_TOOLS` para obtener los esquemas actuales de las herramientas, y gestionar la conexión de YouTube mediante `RUBE_MANAGE_CONNECTIONS` con el toolkit `youtube`. Incluye advertencias detalladas sobre límites de cuota de la API de YouTube, formatos de ID, parámetros de paginación y análisis de respuestas. Es útil para creadores de contenido, equipos de marketing o cualquier desarrollador que necesite interactuar con YouTube de forma programática sin escribir código manualmente.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/youtube-automation

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Automatización de YouTube mediante Rube MCP

Automatiza operaciones de YouTube a través del toolkit de YouTube de Composio mediante Rube MCP.

Prerrequisitos

  • Rube MCP debe estar conectado (RUBE_SEARCH_TOOLS disponible)
  • Conexión activa de YouTube a través de RUBE_MANAGE_CONNECTIONS con el toolkit youtube
  • Siempre llama a RUBE_SEARCH_TOOLS primero para obtener los esquemas actuales de las herramientas

Configuración

Obtén Rube MCP: Añade https://rube.app/mcp como servidor MCP en la configuración de tu cliente. No se necesitan claves API — solo agrega el endpoint y funciona.

  1. Verifica que Rube MCP esté disponible confirmando que RUBE_SEARCH_TOOLS responde
  2. Llama a RUBE_MANAGE_CONNECTIONS con el toolkit youtube
  3. Si la conexión no está ACTIVA, sigue el enlace de autenticación devuelto para completar OAuth de Google
  4. Confirma 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 usarlo: El usuario quiere subir un video o actualizar metadatos de un video

Secuencia de herramientas:

  1. YOUTUBE_UPLOAD_VIDEO - Subir un video nuevo [Requerido]
  2. YOUTUBE_UPDATE_VIDEO - Actualizar título, descripción, etiquetas, privacidad [Opcional]
  3. 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 de palabras clave
  • categoryId: 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; prefiere UPDATE_VIDEO para cambios solo de metadatos
  • videoFilePath debe ser un objeto con s3key, no una ruta de archivo o URL en crudo
  • El total de etiquetas no debe exceder 500 caracteres, incluidos separadores
  • Los ángulos <> 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 usarlo: El usuario quiere encontrar videos, canales o listas de reproducción

Secuencia de herramientas:

  1. YOUTUBE_SEARCH_YOU_TUBE - Buscar contenido [Requerido]
  2. YOUTUBE_VIDEO_DETAILS - Obtener detalles completos de un video específico [Opcional]
  3. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Obtener detalles de múltiples videos [Opcional]

Parámetros clave:

  • q: Consulta de búsqueda (admite frases exactas, exclusiones, handles 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'; usa VIDEO_DETAILS para estadísticas
  • Los resultados de búsqueda están limitados a 500 elementos en total
  • La búsqueda tiene un costo de cuota más alto (100 unidades) comparado con endpoints de lista (1 unidad)
  • El límite práctico de BATCH video details es ~50 IDs por llamada; divide conjuntos más grandes en fragmentos

3. Gestionar listas de reproducción

Cuándo usarlo: El usuario quiere crear listas de reproducción o gestionar su contenido

Secuencia de herramientas:

  1. YOUTUBE_LIST_USER_PLAYLISTS - Listar listas de reproducción existentes del usuario [Opcional]
  2. YOUTUBE_CREATE_PLAYLIST - Crear una nueva lista de reproducción [Opcional]
  3. YOUTUBE_ADD_VIDEO_TO_PLAYLIST - Añadir un video a una lista de reproducción [Opcional]
  4. 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 creadas por el 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 pases IDs de canal ('UC...') como IDs de lista de reproducción; convierte 'UC' a 'UU' para subidas
  • Las listas de reproducción grandes requieren paginación mediante pageToken; sigue nextPageToken hasta que esté ausente
  • items[].id no es el videoId; usa items[].snippet.resourceId.videoId
  • Crear nombres de lista de reproducción duplicados está permitido; verifica las listas existentes primero

4. Obtener análisis de canal y video

Cuándo usarlo: El usuario quiere analizar el rendimiento del canal o las métricas de video

Secuencia de herramientas:

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Resolver un handle a ID de canal [Prerrequisito]
  2. YOUTUBE_GET_CHANNEL_STATISTICS - Obtener conteos de suscriptores/vistas/videos del canal [Requerido]
  3. YOUTUBE_LIST_CHANNEL_VIDEOS - Listar todos los videos de un canal [Opcional]
  4. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Obtener estadísticas por video [Opcional]
  5. YOUTUBE_GET_CHANNEL_ACTIVITIES - Obtener actividades recientes del canal [Opcional]

Parámetros clave:

  • channelId: ID del canal ('UC...'), handle ('@handle') o 'me'
  • forHandle: Handle del canal (ej. '@Google')
  • id: IDs de video separados por comas para detalles por lotes
  • parts: 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 o eliminados
  • Los datos de respuesta pueden estar anidados bajo data o data_preview; analiza de forma defensiva
  • contentDetails.duration usa formato ISO 8601 (ej. 'PT4M13S')

5. Gestionar suscripciones y comentarios

Cuándo usarlo: El usuario quiere suscribirse a canales o ver comentarios de videos

Secuencia de herramientas:

  1. YOUTUBE_SUBSCRIBE_CHANNEL - Suscribirse a un canal [Opcional]
  2. YOUTUBE_UNSUBSCRIBE_CHANNEL - Cancelar suscripción a un canal [Opcional]
  3. YOUTUBE_LIST_USER_SUBSCRIPTIONS - Listar suscripciones [Opcional]
  4. YOUTUBE_LIST_COMMENT_THREADS - Listar comentarios en un video [Opcional]

Parámetros clave:

  • channelId: Canal al que suscribirse/cancelar suscripción
  • videoId: ID del video para hilos de comentarios
  • maxResults: Resultados por página
  • pageToken: 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

Handle a ID de canal:

1. Llama a YOUTUBE_GET_CHANNEL_ID_BY_HANDLE con '@handle'
2. Extrae channelId de la respuesta
3. Úsalo en operaciones posteriores del canal

Lista de reproducción de subidas:

1. Obtén el ID del canal (comienza con 'UC')
2. Reemplaza el prefijo 'UC' por 'UU' para obtener el ID de la lista de subidas
3. Úsalo con LIST_PLAYLIST_ITEMS para enumerar todos los videos

Paginación

  • Establece maxResults (máx. 50 por página)
  • Verifica en la respuesta nextPageToken
  • Pasa el token como pageToken en la siguiente solicitud
  • Continúa hasta que nextPageToken esté ausente

Detalles de video por lotes

  • Recopila IDs de video desde búsquedas o listas de reproducción
  • Divide en grupos de ~50 IDs
  • Llama a GET_VIDEO_DETAILS_BATCH por cada fragmento
  • Combina resultados entre fragmentos

Errores comunes conocidos

Gestión de cuota:

  • La API de YouTube tiene un límite diario de cuota (por defecto 10,000 unidades)
  • Subida = 1600 unidades; búsqueda = 100 unidades; lista = 1 unidad
  • Prefiere endpoints de lista sobre búsqueda cuando sea posible
  • Monitorea el uso de cuota para evitar alcanzar 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 confundas 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; menos de 2 MB
  • 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; convierte antes de hacer matemáticas
  • La duración usa formato ISO 8601 (PT#H#M#S)
  • Las respuestas por lotes pueden envolver datos bajo diferentes claves

Referencia rápida

TareaSlug de herramientaParámetros clave
Subir videoYOUTUBE_UPLOAD_VIDEOtitle, description, tags, categoryId, privacyStatus, videoFilePath
Actualizar videoYOUTUBE_UPDATE_VIDEOvideo_id, title, description, tags
Establecer miniaturaYOUTUBE_UPDATE_THUMBNAILvideoId, thumbnailUrl
Buscar en YouTubeYOUTUBE_SEARCH_YOU_TUBEq, type, maxResults
Detalles de videoYOUTUBE_VIDEO_DETAILSid, part
Detalles de video por loteYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Listar listas de reproducciónYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Crear lista de reproducciónYOUTUBE_CREATE_PLAYLIST(ver esquema)
Añadir a lista de reproducciónYOUTUBE_ADD_VIDEO_TO_PLAYLIST(ver esquema)
Listar elementos de listaYOUTUBE_LIST_PLAYLIST_ITEMSplaylistId, maxResults
Estadísticas de canalYOUTUBE_GET_CHANNEL_STATISTICSid/forHandle/mine
Listar videos de canalYOUTUBE_LIST_CHANNEL_VIDEOSchannelId, maxResults
ID de canal por handleYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
SuscribirseYOUTUBE_SUBSCRIBE_CHANNELchannelId
Listar suscripcionesYOUTUBE_LIST_USER_SUBSCRIPTIONS(ver esquema)
Listar comentariosYOUTUBE_LIST_COMMENT_THREADSvideoId
Actividades del canalYOUTUBE_GET_CHANNEL_ACTIVITIES(ver esquema)

Cuándo usarlo

Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados