Communitygithub.com

ASoudy/AGS

Automatiza tareas de YouTube mediante Rube MCP (Composio): subir videos, administrar listas de reproducción, buscar contenido, obtener analíticas y gestionar comentarios. Siempre busca herramientas primero para obtener esquemas actualizados.

¿Qué es AGS?

Esta habilidad permite a un agente de IA automatizar completamente las operaciones de YouTube a través del conjunto de herramientas de YouTube de Composio, expuesto mediante el protocolo Rube MCP. Es ideal para desarrolladores y creadores de contenido que desean optimizar la gestión de canales de YouTube, como la subida de videos, actualización de metadatos, búsqueda de contenido, administración de listas de reproducción, obtención de estadísticas de canales y videos, y gestión de suscripciones y comentarios. Funciona en cualquier plataforma que admita MCP, como Claude Code, Cursor u otros clientes compatibles, simplemente agregando el endpoint de Rube MCP. El flujo de trabajo principal implica verificar primero la conexión activa de YouTube a través de la herramienta `RUBE_MANAGE_CONNECTIONS`, y siempre llamar a `RUBE_SEARCH_TOOLS` para obtener los esquemas de herramientas más recientes antes de ejecutar cualquier acción. La habilidad documenta secuencias de herramientas específicas para cada tarea, parámetros clave, y consejos para evitar errores comunes como la confusión de formatos de ID, límites de cuota de la API de YouTube y la necesidad de paginación para grandes conjuntos de datos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/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 las operaciones de YouTube a través del conjunto de herramientas 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 conjunto de herramientas youtube
  • Siempre llama a RUBE_SEARCH_TOOLS primero para obtener los esquemas de herramientas actuales

Configuración

Obtén Rube MCP: Agrega https://rube.app/mcp como un 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 conjunto de herramientas youtube
  3. Si la conexión no está ACTIVA, sigue el enlace de autenticación devuelto para completar el 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 administrar videos

Cuándo usarlo: El usuario quiere subir un video o actualizar los 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 sin procesar
  • El total de etiquetas no debe exceder los 500 caracteres, incluidos los separadores
  • Los corchetes angulares < > en las etiquetas se eliminan automáticamente
  • El límite de descripción es de 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, 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'; usa 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) frente a los endpoints de lista (1 unidad)
  • El límite práctico de detalles de videos en lote es de ~50 IDs por llamada; divide conjuntos más grandes

3. Administrar listas de reproducción

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

Secuencia de herramientas:

  1. YOUTUBE_LIST_USER_PLAYLISTS - Listar las 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 - Agregar 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 una 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 falte
  • items[].id no es el videoId; usa items[].snippet.resourceId.videoId
  • Crear nombres de listas de reproducción duplicados está permitido; verifica las listas existentes primero

4. Obtener analíticas de canales y videos

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

Secuencia de herramientas:

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Resolver un identificador a ID de canal [Requisito previo]
  2. YOUTUBE_GET_CHANNEL_STATISTICS - Obtener recuentos 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...'), identificador ('@handle') o 'me'
  • forHandle: Identificador del canal (ej., '@Google')
  • id: IDs de video separados por comas para detalles en lote
  • 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
  • Los detalles de videos en lote pueden devolver menos elementos de los solicitados para videos privados/eliminados
  • Los datos de respuesta pueden estar anidados bajo data o data_preview; analiza de forma defensiva
  • contentDetails.duration usa el formato ISO 8601 (ej., 'PT4M13S')

5. Administrar 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 desactivados en algunos videos
  • Cancelar la 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. 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' con 'UU' para obtener el ID de la lista de reproducción de subidas
3. Úsalo con LIST_PLAYLIST_ITEMS para enumerar todos los videos

Paginación

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

Detalles de videos en lote

  • Recopila IDs de video de búsquedas o listados de listas de reproducción
  • Divide en grupos de ~50 IDs
  • Llama a GET_VIDEO_DETAILS_BATCH por cada grupo
  • Combina los resultados de todos los grupos

Errores comunes 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
  • Prefiere endpoints de lista sobre búsqueda cuando sea posible
  • Supervisa 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 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; menores de 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; convierte antes de hacer operaciones matemáticas
  • La duración usa formato ISO 8601 (PT#H#M#S)
  • Las respuestas en lote pueden envolver los 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 en loteYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Listar listas de reproducciónYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Crear lista de reproducciónYOUTUBE_CREATE_PLAYLIST(consultar esquema)
Agregar a lista de reproducciónYOUTUBE_ADD_VIDEO_TO_PLAYLIST(consultar esquema)
Listar elementos de lista de reproducciónYOUTUBE_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 identificadorYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
SuscribirseYOUTUBE_SUBSCRIBE_CHANNELchannelId
Listar suscripcionesYOUTUBE_LIST_USER_SUBSCRIPTIONS(consultar esquema)
Listar comentariosYOUTUBE_LIST_COMMENT_THREADSvideoId
Actividades de canalYOUTUBE_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

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación, pruebas o revisión experta específica del entorno.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados