YouTube Studio MCP

Qué hace.
Las capacidades principales del sistema.

• 1

  Bandeja de pendientes

  Una tool nueva devuelve los comentarios más recientes de todo el canal que todavía no contesté, con una sola consulta paginada y sin recorrer video por video.

• 2

  Responder desde la conversación

  Se piden los pendientes, se elige uno y se responde con youtube_reply_to_comment; la respuesta queda registrada y el comentario sale de la lista siguiente.

• 3

  Qué cuenta como respondido

  Un comentario publicado de otra persona está pendiente si el canal no le respondió. Los likes, los corazones y las respuestas de otros espectadores no cuentan.

• 4

  Caché de respondidos

  SQLite con vencimiento de 12 horas que sólo guarda los hilos que ya respondí; los pendientes nunca se guardan.

• 5

  Cuota acotada

  Cada consulta tiene un tope de llamadas, 50 por defecto, y declara cuántas hizo. Traer 15 pendientes suele costar entre 2 y 5 unidades.

• 6

  Descripciones de uso

  Reescribí las descripciones de las cinco tools de comentarios: cuándo usar cada una y que el modelo confirme el texto antes de publicar o borrar.

• 7

  Docker sin navegador

  En modo headless el servidor nunca abre el login de Google: si el token venció, explica cómo reautorizar desde el host con un comando nuevo y toma el token sin reiniciar.

• 8

  Cuota real y secretos cifrados

  Una tool lee el uso de cuota desde Cloud Monitoring en lugar de estimarlo. Las credenciales se versionan cifradas con age y el token se guarda con permisos 0600.

Herramientas.
45 herramientas sobre tres APIs de YouTube. Las marcadas en rojo las agregué o las mejoré yo; el resto viene del proyecto original, agrupado por familia.

• Comentarios sin responder

  nueva
  youtube_list_unanswered_comments

  Los más recientes de todo el canal que todavía no contesté: 15 por defecto, hasta 200, con un tope de llamadas por consulta. Informa cuántas hizo y si el resultado quedó parcial.

• Cuota de Google

  nueva
  youtube_quota_status

  Uso y límite de cuota del proyecto según Cloud Monitoring, con la fecha de cada muestra. Si no hay datos lo dice, en vez de informar cero.

• Responder

  mejorada
  youtube_reply_to_comment

  Responde un comentario como el canal. Le sumé el registro en la caché, para que deje de figurar como pendiente, y una descripción que pide confirmar el texto.

• Borrar comentario

  mejorada
  youtube_delete_comment

  Siempre con confirmación. Si borro una respuesta mía, el comentario original vuelve a figurar como pendiente.

• Comentarios de un video

  mejorada
  youtube_list_comments

  Comentarios de un solo video. La descripción nueva le indica al modelo que los pendientes del canal se buscan con la otra tool.

• Comentario nuevo

  mejorada
  youtube_post_comment

  Publica un comentario en un video. La descripción nueva aclara que para contestarle a alguien hay que responder, no comentar.

• Autenticación

  mejorada
  youtube_auth · youtube_auth_status

  En Docker no abre el navegador: si el token venció, explica cómo reautorizar desde el host. El estado separa la actividad local de la cuota de Google.

• Analíticas

  mejorada

  13 herramientas de rendimiento, audiencia, retención e ingresos. En nueve les sumé engaged views como un dato aparte de las vistas.

• Canal y videos

  original

  Datos del canal, lista de videos y detalle de cada uno.

• Búsqueda y SEO

  original

  Búsqueda, sugerencias de autocompletado, tendencias y categorías.

• Transcripciones

  original

  Transcripción de un video y pistas de subtítulos propias.

• Publicación

  original

  Subir, editar y borrar videos, y cambiar la miniatura.

• Playlists

  original

  Listar, crear, editar y borrar playlists, y sumar o sacar videos.

• Reportes masivos

  original

  Programar y descargar reportes CSV de la API de reportes.

Decisiones técnicas.
Qué se eligió y qué implica.

1. 01

   Una consulta para todo el canal

   commentThreads.list con allThreadsRelatedToChannelId, del más nuevo al más viejo y con las respuestas que YouTube incluye en cada hilo. Como la API no filtra por "sin responder", la clasificación se hace en el MCP.

   → No hay que recorrer video por video ni usar la búsqueda, que es cara. Los hilos con más respuestas de las incluidas necesitan una llamada extra.

2. 02

   Cachear sólo lo respondido

   La caché guarda la prueba de que respondí un hilo, nunca un pendiente. Antes de ocultar un hilo por la caché, verifica en lotes de 50 que la respuesta siga existiendo.

   → Una respuesta hecha desde YouTube Studio aparece en la consulta siguiente, y una respuesta borrada vuelve a mostrar el comentario. Verificar cuesta alguna llamada más.

3. 03

   Un tope de llamadas por consulta

   max_api_calls corta el escaneo, y la respuesta lo declara con stop_reason y scan_limited.

   → Una consulta nunca dispara el consumo. Si corta, el resultado es parcial y lo dice, sin saltar un hilo reciente para devolver otros más viejos.

4. 04

   Una tool nueva en vez de cambiar la existente

   youtube_list_comments sigue igual, para un solo video; los pendientes del canal van en una herramienta aparte.

   → No cambia nada de lo que ya funcionaba. El modelo tiene que elegir entre dos tools, y las descripciones lo guían.

5. 05

   La cuota la informa Google

   Saqué los costos fijos y el límite estimado de 10.000 unidades que bloqueaba llamadas en el servidor; el uso real se lee desde Cloud Monitoring.

   → El servidor no frena pedidos por una estimación. Los datos de Monitoring llegan con demora y requieren un permiso más.

6. 06

   Nunca abrir el navegador en Docker

   En modo headless el login de Google no arranca: el error explica cómo reautorizar desde el host con youtube-studio-mcp-auth, y el servidor toma el token nuevo sin reiniciar.

   → El contenedor no queda esperando un login imposible. Reautorizar es un paso manual.

7. 07

   Que falle la caché, no la tool

   Si la caché no se puede leer o escribir, la consulta sigue contra la API y lo avisa en warnings.

   → Una respuesta o un borrado que salieron bien en YouTube nunca se informan como fallidos por un error de la caché.