Communitygithub.com

BEKO2210/Firstbrain

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

¿Qué es Firstbrain?

Esta habilidad permite automatizar operaciones de YouTube a través del toolkit de YouTube de Composio expuesto por Rube MCP. Es útil para desarrolladores y agentes de IA que necesitan gestionar canales de YouTube de forma programática, evitando llamadas manuales a la API. Soporta los principales clientes que integren MCP, como Claude Code o Cursor, y requiere tener Rube MCP configurado como servidor MCP. El flujo de trabajo comienza siempre con una llamada a `RUBE_SEARCH_TOOLS` para descubrir los esquemas actuales de las herramientas y garantizar compatibilidad. Luego se establece una conexión activa con YouTube mediante `RUBE_MANAGE_CONNECTIONS`. La habilidad cubre cinco áreas principales: subida y gestión de videos, búsqueda de contenido, gestión de listas de reproducción, obtención de analíticas de canal y videos, y gestión de suscripciones y comentarios. Cada área tiene secuencias de herramientas recomendadas y parámetros clave documentados. La habilidad también incluye advertencias importantes sobre límites de cuota de la API de YouTube, formatos de ID, parsing de respuestas y manejo de paginación. En resumen, Firstbrain proporciona una capa de abstracción robusta y documentada para interactuar con YouTube de manera eficiente y evitando errores comunes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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.

Requisitos previos

  • Rube MCP debe estar conectado (disponible RUBE_SEARCH_TOOLS)
  • Conexión activa de YouTube mediante RUBE_MANAGE_CONNECTIONS con el toolkit youtube
  • Siempre llama primero a RUBE_SEARCH_TOOLS 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 añade 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 nuevo video [Obligatorio]
  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: Array 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
  • El total de etiquetas no debe superar los 500 caracteres, incluidos los separadores
  • Los caracteres <> 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 [Obligatorio]
  2. YOUTUBE_VIDEO_DETAILS - Obtener detalles completos de un video específico [Opcional]
  3. YOUTUBE_GET_VIDEO_DETAILS_BATCH - Obtener detalles de varios 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 están limitados a 500 elementos en total
  • La búsqueda tiene un costo de cuota más alto (100 unidades) frente a los endpoints de listado (1 unidad)
  • El límite práctico de BATCH video details es de ~50 IDs por llamada; divide conjuntos más grandes

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 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 - 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 grandes requieren paginación mediante pageToken; sigue nextPageToken hasta que esté ausente
  • El valor items[].id no es el videoId; usa items[].snippet.resourceId.videoId
  • Está permitido crear listas con nombres duplicados; verifica las listas existentes primero

4. Obtener analíticas de canal y video

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, visualizaciones y videos del canal [Obligatorio]
  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 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; parsea 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 o cancelar suscripción
  • videoId: ID del video para los 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 un máximo de 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. Llama a YOUTUBE_GET_CHANNEL_ID_BY_HANDLE con '@handle'
2. Extrae el 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áximo 50 por página)
  • Verifica en la respuesta si hay 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 de búsquedas o listados de listas de reproducción
  • Divídelos en grupos de ~50 IDs
  • Llama a GET_VIDEO_DETAILS_BATCH por cada grupo
  • Combina los resultados entre grupos

Errores conocidos

Gestión de cuota:

  • La API de YouTube tiene un límite de cuota diario (por defecto 10,000 unidades)
  • Subir = 1600 unidades; buscar = 100 unidades; listar = 1 unidad
  • Prefiere los endpoints de listado sobre la 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' seguidas de 22 caracteres
  • IDs de lista de reproducción: comienzan con 'PL' (usuario) o 'UU' (subidas)
  • No confundas los IDs de canal con los 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 como enteros; conviértelos antes de hacer operaciones matemáticas
  • La duración usa formato ISO 8601 (PT#H#M#S)
  • Las respuestas por lotes 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 por lotesYOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
Listar listas de reproducciónYOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
Crear lista de reproducciónYOUTUBE_CREATE_PLAYLIST(consultar esquema)
Añadir a lista de reproducciónYOUTUBE_ADD_VIDEO_TO_PLAYLIST(consultar 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 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 usarlo

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

Conexiones

  • Dominio: [[Diseño y Creatividad]]
  • Categoría: [[Producción de Video y Audio]]
  • Navegación: [[Resumen de Habilidades]], [[Inicio]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Skills relacionados