Publicar no YouTube a partir do Codex

Hermoso é um servidor MCP de marketing: 922+ ferramentas em um endpoint único com OAuth, que permitem a um agente pesquisar os anúncios que já rodam em um mercado, gerar anúncios finalizados em imagem e vídeo, publicá-los e montar as campanhas pagas por trás deles. O Codex acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Codex consegue fazer de fato no YouTube, e o que o YouTube não deixa que ele faça.

Conectar o Hermoso ao Codex

1. Um comando, e nenhuma chave.

   codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

   O Codex lê o arquivo de marketplace no repositório público da Hermoso e instala as cinco skills dele (research, ad-from-brand, generate, product-photoshoot e marketing). As skills rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões e nada custa contexto até um comando rodar.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre uma entrada pelo navegador e guarda uma credencial, só com acesso do dono, em ~/.hermoso/config.json. Sem navegador nessa máquina, por exemplo em CI ou em um contêiner? Crie uma chave em MCP & CLI → Terminal e chaves de API e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real de gasto, então trate-a como uma senha.
3. Opcional: o servidor MCP também.

   codex mcp add hermoso -- npx -y hermoso mcp

   Isso grava o servidor em ~/.codex/config.toml e lê a mesma credencial guardada, então nenhuma chave vai no arquivo. Prefere o endpoint hospedado? codex mcp add hermoso --url https://app.hermoso.ai/mcp e depois codex mcp login hermoso para o login OAuth. As skills alcançam todas as ferramentas sem nenhum dos dois.
4. Peça algo ao Codex. “Puxe os anúncios mais duradouros dos meus três concorrentes mais próximos e refaça o melhor gancho em um vídeo 9:16”, ou “publique este render no canal”. O agente escolhe as ferramentas; você aprova o gasto.

O Codex guarda os servidores MCP em ~/.codex/config.toml, ou em .codex/config.toml de um projeto confiável, e esse arquivo é TOML, não JSON: um bloco mcpServers copiado não carrega, e uma entrada escrita à mão é [mcp_servers.hermoso] com command = "npx" e args = ["-y", "hermoso", "mcp"]. O mcp final é essencial: npx -y hermoso sem subcomando só mostra a ajuda e sai. O Codex lê marketplaces de plugin no mesmo layout .claude-plugin que o Claude Code usa, por isso um único repositório instala nos dois.

Depois conecte o próprio YouTube, uma vez, em Configurações → Conectores no Hermoso. Isso é uma tela de consentimento OAuth, então é a única etapa que precisa de navegador. Tudo depois disso é uma chamada de ferramenta.

As ferramentas do YouTube que o Codex recebe

• post_to_youtube: envia um vídeo finalizado com título, descrição de até 5.000 caracteres, até 30 tags e uma configuração de privacidade.
• schedule_post: coloca o envio na fila, e leva a descrição e as tags junto.
• set_youtube_thumbnail: coloca uma miniatura desenhada no envio. É a maior alavanca isolada no clique, e o YouTube de outra forma escolhe um quadro mais ou menos ao acaso.
• make_thumbnail: gera essa miniatura para começar.
• update_youtube_video / list_youtube_videos: editam os metadados de um envio, ou listam os seus próprios envios, incluindo os não listados e privados que uma busca pública não enxerga.
• youtube_video_insights / youtube_channel: visualizações, tempo de exibição, porcentagem média assistida e inscritos ganhos.
• list_youtube_comments / reply_to_youtube_comment: lê e responde comentários como o canal.

A unidade é mesmo um vídeo: o post_to_youtube recebe um videoUrl e não existe caminho para imagem. Duas travas menores que vale conhecer antes de um upload automatizado: um projeto do Google que não foi verificado tem o videos.insert travado em privado, independentemente do que você pedir, e miniaturas personalizadas exigem um canal com telefone verificado.

Limites do YouTube que vale conhecer antes de automatizar qualquer coisa

Experimente no Codex

Peça em linguagem comum. São frases simples, não uma DSL:

“Sem interação: para cada mp4 do diretório de entrada, escreva um título de menos de 100 caracteres e uma descrição de 5,000 caracteres, gere uma miniatura, envie como não listado e imprima em JSON.”

Isso percorre make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights. No modo interativo, o Codex mostra a chamada antes de rodá-la. No modo não interativo não há ninguém para perguntar, o que vale a pena considerar em qualquer etapa que publique ou gaste.

Codex no YouTube: a parte que pega

Envie sempre como não listado a partir de uma execução sem supervisão. O YouTube não tem rascunho no Studio, então o não listado é o estado de revisão, e um lote que vai direto para o público é um lote que você não consegue despublicar discretamente. Verifique também o canal antes: um projeto do Google não verificado tem uploads travados em privado, independentemente da privacidade que o job pedir, o que vai parecer um bug e não é um.

Em execuções sem supervisão, prefira a CLI hermoso com --json ao manifesto completo de ferramentas. Ela custa bem menos contexto e é mais fácil de validar.

Pesquise o YouTube antes de publicar

search_youtube pesquisa o índice público do YouTube. Essa é uma pergunta diferente de “o que eu já enviei”, e para essa serve list_youtube_videos. Para o vídeo de um concorrente, analyze_video devolve a narração, o texto na tela e a lista de beats com timestamps, que é exatamente o que você quer antes de refazer um gancho.

A metade paga

As ferramentas de Google Ads da Hermoso criam campanhas de pesquisa, display e Performance Max (a árvore inteira numa única operação atômica, relida do Google antes de o seu agente narrar o resultado), além de volumes do Planejador de Palavras-chave, ações de conversão, e sitelinks e callouts criados e anexados. Não existe criador de campanhas de vídeo no YouTube, e seria errado sugerir que existe; um recurso de vídeo do YouTube pode ser enviado e anexado, mas os tipos de campanha que a Hermoso cria são pesquisa, display e Performance Max.

O que o Codex não consegue fazer sozinho

Um agente com orçamento só é útil se o raio de impacto for limitado, então a cerca fica no servidor, e não em um prompt. Toda campanha, conjunto de anúncios, grupo de anúncios e anúncio é criado pausado, e as trocas de status que ativam dinheiro real se recusam a rodar sem uma flag de confirmação explícita. Cada render é cotado antes (hermoso_capabilities publica o custo exato em créditos de cada modelo antes de qualquer gasto). Os créditos são reservados antes da primeira chamada ao provedor e acertados pelo custo exato depois, então uma falha no envio devolve o valor em vez de deixar você cobrado por nada. As exclusões também exigem confirmação, e cada árvore de campanha é relida da plataforma de anúncios antes que o seu agente diga o que construiu.

Uma etapa deliberadamente não é feita sem interface: vincular uma conta é uma tela de consentimento OAuth, então você conecta o canal uma vez em um navegador. Tudo depois disso é uma chamada de ferramenta.

O resto da matriz

Pelo Codex, publique em: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Codex consegue publicar.

Publique no YouTube a partir de: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Anúncios pela linha de comando

Perguntas frequentes

O Codex consegue publicar no YouTube?

Sim, com o plugin do Codex da Hermoso. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. O Codex passa a ter mais de 922+ ferramentas, incluindo as que publicam no YouTube e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

Como conecto o YouTube ao Codex?

Duas etapas, uma vez cada. Rode codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, que instala as skills da Hermoso, e depois entre uma vez com npx -y hermoso auth login. O login abre o navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Para o servidor MCP também, rode codex mcp add hermoso -- npx -y hermoso mcp. Depois conecte o YouTube dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Depois disso o Codex publica no YouTube como uma chamada de ferramenta comum.

Qual é o limite de legenda do YouTube ao publicar a partir do Codex?

Um título do YouTube tem limite de 100 caracteres. A descrição é um campo separado de até 5.000 caracteres, com até 30 tags. O texto de um item agendado vira o título, então os dois precisam ser passados explicitamente. O Hermoso aplica o limite quando o post é criado ou colocado na fila, então o Codex é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Codex consegue agendar um post no YouTube para depois?

Sim. O schedule_post coloca o post na fila de uma agenda única compartilhada com todos os outros canais, com uma legenda por canal se o texto precisar ser diferente, e o list_scheduled e o cancel_scheduled leem e retiram o post. O YouTube é um dos onze canais que entram na fila.

O Codex consegue publicar no YouTube de forma privada ou como rascunho?

Sim: público, não listado ou privado. Não existe rascunho do Studio na API do YouTube, então o não listado é o estado de revisão, e é o que uma publicação imediata assume, para que um upload pronto para anúncio não fique público por acidente. O Hermoso recusa uma visibilidade que o YouTube não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

Quanto custa publicar no YouTube a partir do Codex?

Publicar no YouTube não custa créditos; o YouTube não cobra nada por chamada de API. Os créditos são gastos gerando o vídeo e a miniatura. Os planos custam $29, $69 e $149 por mês, por 1.200, 3.000 e 7.000 créditos, e todos os recursos estão em todos os planos, inclusive o Free. A única exceção é o SSO empresarial.