Publica en YouTube desde Claude Code

Subida, título, descripción, etiquetas y miniatura son una sola cadena desde la terminal, y no listado es el estado de revisión porque la API de YouTube no tiene borrador de Studio.

Hermoso es un servidor MCP de marketing: 922+ herramientas a través de un único endpoint con OAuth que permiten a un agente investigar los anuncios que ya se publican en un mercado, generar anuncios terminados de imagen y vídeo, publicarlos y construir las campañas de pago que hay detrás. Claude Code llega a todo ello a través de una sola conexión. Esta página cubre una parte: lo que Claude Code puede hacer de verdad en YouTube, y lo que YouTube no le permite hacer.

Conecta Hermoso a Claude Code

  1. Un comando, y ninguna clave.
    claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso
    ¿Ya estás dentro de una sesión? Escribe /plugin marketplace add hermoso-ai/hermoso, y luego /plugin install hermoso@hermoso. Instala cinco habilidades de Hermoso (research, ad-from-brand, generate, product-photoshoot y marketing) que ejecutan el comando hermoso a través de npx, así que no se carga ninguna lista de herramientas en tus sesiones, y nada cuesta contexto hasta que se ejecuta.
  2. Inicia sesión una vez.
    npx -y hermoso auth login
    Abre un inicio de sesión en el navegador a través de loopback, como lo hace gh, y guarda una credencial de uso exclusivo del propietario en ~/.hermoso/config.json. Claude Code lo ejecuta por ti la primera vez que necesita Hermoso. ¿Sin navegador en esa máquina, por ejemplo en CI, un equipo remoto o un contenedor? Crea una clave en MCP & CLI → Terminal & API keys y ejecuta npx -y hermoso auth login --token hmk_…. Una clave lleva autoridad de gasto real, así que trátala como una contraseña.
  3. Opcional: el servidor MCP también. Si además quieres las herramientas de Hermoso en la lista de herramientas de Claude Code, ejecuta claude mcp add hermoso -- npx -y hermoso mcp después de iniciar sesión. Lee la misma credencial guardada, así que ninguna clave va a .claude.json. Las habilidades llegan a todas las herramientas sin él.
  4. Pídele algo a Claude Code. «Saca los anuncios de más larga duración de mis tres competidores más cercanos y remezcla el mejor gancho en un vídeo 9:16», o «publica este render en el canal». El agente elige las herramientas; tú apruebas el gasto.

El plugin y el servidor MCP opcional llegan a las mismas herramientas y a la misma cuenta. La diferencia está en el contexto: una lista de herramientas se carga en cada sesión antes de que escribas nada, mientras que las habilidades no cuestan nada hasta que se ejecuta un comando.

Luego conecta YouTube tú mismo, una vez, en Ajustes → Conectores de Hermoso. Es una pantalla de consentimiento OAuth, así que es el único paso que necesita un navegador. Todo lo que viene después es una llamada a una herramienta.

Las herramientas de YouTube que obtiene Claude Code

  • post_to_youtube: sube un vídeo terminado con título, una descripción de hasta 5.000 caracteres, hasta 30 etiquetas y un ajuste de privacidad.
  • schedule_post: encola la subida, y lleva la descripción y las etiquetas con ella.
  • set_youtube_thumbnail: pone una miniatura diseñada en la subida. Es la palanca más grande para el clic, y si no la pones YouTube elige un fotograma más o menos al azar.
  • make_thumbnail: genera esa miniatura desde cero.
  • update_youtube_video / list_youtube_videos: edita los metadatos de una subida, o lista tus propias subidas, incluidas las no listadas y privadas que una búsqueda pública no ve.
  • youtube_video_insights / youtube_channel: visualizaciones, tiempo de visionado, porcentaje medio visto y suscriptores ganados.
  • list_youtube_comments / reply_to_youtube_comment: lee y responde comentarios como el canal.

La unidad es de verdad un vídeo: post_to_youtube acepta un videoUrl y no hay ninguna ruta de imagen. Dos barreras menores que conviene conocer antes de una subida automatizada: un proyecto de Google sin verificar tiene videos.insert bloqueado en privado sin importar lo que pidas, y las miniaturas personalizadas necesitan un canal verificado por teléfono.

Límites de YouTube que conviene conocer antes de automatizar nada

TextoUn título de YouTube tiene un límite de 100 caracteres, y el texto de un elemento programado se convierte en el título. La descripción es un campo aparte de hasta 5.000 caracteres, con hasta 30 etiquetas. Se aplica al crear o encolar la publicación, así que una publicación demasiado larga se rechaza mientras sigues ahí para corregirla, en lugar de cortarse en silencio por el camino.
VisibilidadPública, no listada o privada. No hay borrador de Studio: «La API de YouTube puede subir como pública, no listada o privada, pero no puede crear un borrador de Studio», así que lo no listado es lo más parecido a un estado de revisión, y es lo que una publicación inmediata usa por defecto para que una subida lista para anuncios no sea pública por accidente.
CarruselRechazado, por nombre. «La unidad de YouTube es un vídeo, no un conjunto de fotos fijas. Convierte las diapositivas en un vídeo (Hermoso puede unirlas) y publica eso en su lugar, o quita YouTube de esta publicación.» Hermoso no inventó ese límite para evitar trabajo; es simplemente lo que es YouTube. El rechazo llega al encolar, con la vía a seguir adjunta, en lugar de publicar en silencio una primera diapositiva.
Qué cuentaNinguno. YouTube publica en el canal conectado.

Pruébalo en Claude Code

Pídelo con lenguaje normal. Son frases sencillas, no un DSL:

“Para cada archivo de ./films, escribe un título de menos de 100 caracteres y una descripción completa, genera una miniatura, sube como no listado, y escribe un CSV con los ids y las URLs de los videos.”

Eso ejecuta make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights. Claude Code pide permiso antes de ejecutar una herramienta, y la transcripción queda ahí mismo en la terminal, así que un paso de publicación es una línea que puedes leer antes de pulsar «y».

Claude Code en YouTube: la parte que muerde

Las subidas por lotes es donde aparece la trampa de los metadatos: el texto se convierte en el título, que tiene un límite de 100 caracteres, mientras que la descripción es un campo aparte de 5,000 caracteres con hasta 30 etiquetas. Pasa ambos de forma explícita. Y comprueba el estado del canal antes del lote: un proyecto de Google sin verificar tiene las subidas bloqueadas como privadas, y las miniaturas personalizadas necesitan un canal verificado por teléfono.

El plugin no lleva ningún manifiesto de herramientas, lo que importa sobre todo en una ejecución larga y desatendida: el agente llama al comando hermoso en cada paso, y --json en cualquier comando le da una salida de máquina que puede comprobar.

Investiga YouTube antes de publicar

search_youtube busca en el índice público de YouTube. Es una pregunta distinta de «qué he subido», y para eso está list_youtube_videos. Para el video de un competidor, analyze_video devuelve la voz en off, el texto en pantalla y la lista de momentos con marcas de tiempo, que es justo lo que necesitas antes de rehacer un hook.

La mitad de pago

Las herramientas de Google Ads de Hermoso crean campañas de búsqueda, display y Performance Max (todo el árbol en una sola operación atómica, leído de vuelta desde Google antes de que tu agente lo narre), además de volúmenes del Planificador de palabras clave, acciones de conversión, y enlaces de sitio y textos destacados creados y asociados. No hay un creador de campañas de video de YouTube, y sería incorrecto dar a entender que lo hay; un recurso de video de YouTube se puede subir y asociar, pero los tipos de campaña que crea Hermoso son búsqueda, display y Performance Max.

Lo que Claude Code no puede hacer por sí solo

Un agente con presupuesto solo es útil si el radio de impacto está acotado, así que la valla está en el servidor y no en un prompt. Cada campaña de anuncios, conjunto de anuncios, grupo de anuncios y anuncio se crea en pausa, y los cambios de estado que activan dinero real se niegan a ejecutarse sin una marca de confirmación explícita. Cada render se cotiza primero (hermoso_capabilities publica el coste exacto en créditos de cada modelo antes de que se gaste nada). Los créditos se reservan antes de la primera llamada al proveedor y se liquidan al coste exacto después, así que un envío fallido se reembolsa en lugar de dejarte cobrado por nada. Los borrados también requieren confirmación, y cada estructura de campaña se lee de nuevo desde la plataforma publicitaria antes de que tu agente te diga qué ha construido.

Un paso no es deliberadamente sin cabeza: vincular una cuenta es una pantalla de consentimiento OAuth, así que conectas el canal una vez en un navegador. Todo lo que viene después es una llamada a una herramienta.

El resto de la matriz

Desde Claude Code, publica en: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram. O mira todo lo que Claude Code puede publicar.

Publica en YouTube desde: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

Preguntas frecuentes

¿Puede Claude Code publicar en YouTube?

Sí, con el plugin de Claude Code de Hermoso. Un comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, o dentro de una sesión /plugin marketplace add hermoso-ai/hermoso y luego /plugin install hermoso@hermoso. Instala cinco habilidades de Hermoso que manejan la CLI de hermoso, así que no se carga ninguna lista de herramientas en tus sesiones. Inicia sesión una vez con npx -y hermoso auth login, que abre un navegador y guarda la credencial, así que no hay ninguna clave que crear ni que pegar. Claude Code tiene entonces más de 922 herramientas, incluidas las que publican en YouTube, además de las que investigan los anuncios que ya se emiten en tu mercado y generan el creativo desde cero.

¿Cómo conecto YouTube a Claude Code?

Dos pasos, una vez cada uno. Un comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, o dentro de una sesión /plugin marketplace add hermoso-ai/hermoso y luego /plugin install hermoso@hermoso. Instala cinco habilidades de Hermoso que manejan la CLI de hermoso, así que no se carga ninguna lista de herramientas en tus sesiones. Inicia sesión una vez con npx -y hermoso auth login, que abre un navegador y guarda la credencial, así que no hay ninguna clave que crear ni que pegar. Después conecta YouTube dentro de Hermoso en Ajustes → Conectores, que es una pantalla de consentimiento OAuth en el navegador. A partir de ahí, Claude Code publica en YouTube como una llamada de herramienta normal.

¿Puede Claude Code publicar en privado o como borrador en YouTube?

Sí: pública, no listada o privada. No hay borrador de Studio en la API de YouTube, así que lo no listado es el estado de revisión, y una publicación inmediata lo usa por defecto. Hermoso rechaza una visibilidad que YouTube no puede respetar en el momento en que la pides, en lugar de publicar en silencio algo más débil.

¿Cuánto cuesta publicar en YouTube desde Claude Code?

Publicar en YouTube no cuesta créditos; YouTube no cobra nada por llamada a la API. Los créditos se gastan en generar el vídeo y la miniatura. Los planes cuestan $29, $69 y $149 al mes por 1.200, 3.000 y 7.000 créditos, y todas las funciones están en todos los planes, incluido el gratuito. La única excepción es el SSO empresarial.

¿Cuál es el límite de texto de YouTube al publicar desde Claude Code?

Un título de YouTube tiene un límite de 100 caracteres. La descripción es un campo aparte de hasta 5.000 caracteres, con hasta 30 etiquetas. El texto de un elemento programado se convierte en el título, así que ambos deben pasarse explícitamente. Hermoso lo aplica al crear o encolar la publicación, así que Claude Code se entera de inmediato en lugar de fallar más tarde, cuando nadie está mirando.

¿Puede Claude Code programar una publicación de YouTube para más tarde?

Sí. schedule_post la encola en un calendario compartido con todos los demás canales, con un texto por canal si el copy debe ser distinto, y list_scheduled y cancel_scheduled la leen y la retiran. YouTube es uno de los once canales que se encolan.

Empieza gratis con 30 créditos al registrarte y consigue 250+ más. Todas las funciones están en todos los planes.

Empieza gratis →   Ver precios