Publicar no YouTube a partir do Gemini CLI

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 Gemini CLI acessa tudo isso por uma única conexão. Esta página cobre uma fatia disso: o que o Gemini CLI consegue fazer de fato no YouTube, e o que o YouTube não deixa que ele faça.

Conectar o Hermoso ao Gemini CLI

1. Instale a extensão.

   gemini extensions install https://github.com/hermoso-ai/hermoso

   Ela instala a versão mais recente do repositório público do Hermoso: cinco skills (research, ad-from-brand, generate, product-photoshoot e marketing) mais um arquivo de contexto GEMINI.md. As skills executam o comando hermoso pelo npx, então nada é adicionado à lista de ferramentas do Gemini CLI, e nada custa contexto até que um comando rode. gemini extensions list mostra-as em Agent skills.
2. Faça login uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador e guarda uma credencial de acesso restrito ao dono em ~/.hermoso/config.json. O Gemini CLI pode executá-lo por você na primeira vez que precisar do Hermoso. Sem navegador nessa máquina? Crie uma chave em MCP & CLI → Terminal & chaves de API e execute npx -y hermoso auth login --token hmk_….
3. Opcional: também o servidor MCP.

   gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp

   O Gemini CLI encontra o servidor de autorização do Hermoso quando a primeira conexão responde 401 e se registra sozinho, então nenhuma chave vai em settings.json; /mcp auth hermoso dentro de uma sessão executa o login. As skills alcançam todas as ferramentas sem isso.
4. Peça algo ao Gemini CLI. “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.

Rodamos a instalação acima em 2026-09-23 contra o Gemini CLI 0.60.0, em um diretório home limpo: ela puxou a versão atual de hermoso-ai/hermoso, e gemini extensions list mostrou as cinco skills e o arquivo de contexto. A extensão não traz servidor MCP próprio, e isso é intencional: uma lista de ferramentas é carregada em cada sessão, e as skills não custam nada até rodarem. O Hermoso não é afiliado nem endossado pelo Google.

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 Gemini CLI 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 Gemini CLI

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

“Envie ./renders/demo.mp4 ao YouTube como não listado, com título de até 100 caracteres, a descrição em ./docs/demo.md, dez tags e uma thumbnail gerada.”

Isso percorre make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights. O Gemini CLI pede confirmação antes de rodar um comando de shell, e as skills atuam pelo comando hermoso, então uma publicação aparece como uma linha que você pode ler antes de dizer sim. Para ferramentas MCP, ele oferece permitir uma vez, sempre para aquela ferramenta ou sempre para o servidor.

Gemini CLI no YouTube: a parte que pega

Passe a descrição em um campo próprio. O texto de um item agendado vira o título de 100 caracteres, e a descrição de 5.000 caracteres, que carrega os links, fica vazia a menos que você peça. Envie como não listado, já que a API não tem rascunho no Studio, e depois torne-o público com update_youtube_video quando tiver assistido. Thumbnails personalizadas exigem um canal com telefone verificado.

Dois detalhes do Gemini CLI decidem o quão seguro isso é. gemini mcp add grava em .gemini/settings.json do projeto, a não ser que você passe --scope user, o que é útil quando um repositório deve sempre rodar contra uma mesma marca. E nunca adicione o Hermoso com --trust: ele pula todas as confirmações do servidor, inclusive as que aparecem antes de uma publicação. Ferramentas MCP chegam com o nome mcp_hermoso_ mais o nome da ferramenta, e --exclude-tools mantém qualquer uma delas fora por completo.

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 Gemini CLI 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

A partir do Gemini CLI, publique em: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Gemini CLI pode publicar.

Publique no YouTube a partir de: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Perguntas frequentes

O Gemini CLI consegue publicar no YouTube?

Sim, com a extensão do Gemini CLI do Hermoso. Execute gemini extensions install https://github.com/hermoso-ai/hermoso, que adiciona cinco skills do Hermoso que acionam o comando hermoso, e depois faça login uma vez com npx -y hermoso auth login. O login abre um navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Se você também quiser as ferramentas do Hermoso na própria lista do Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp adiciona o servidor hospedado, que faz login com OAuth. O Gemini CLI passa a ter 922+ ferramentas, incluindo as que publicam no YouTube, e também as que pesquisam os anúncios que já rodam no seu mercado e renderizam o criativo do zero.

Como conecto o YouTube ao Gemini CLI?

Duas etapas, uma vez cada. Execute gemini extensions install https://github.com/hermoso-ai/hermoso, que adiciona cinco skills do Hermoso que acionam o comando hermoso, e depois faça login uma vez com npx -y hermoso auth login. O login abre um navegador e guarda a credencial sozinho, então não há chave para criar nem para colar. Se você também quiser as ferramentas do Hermoso na própria lista do Gemini CLI, gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp adiciona o servidor hospedado, que faz login com OAuth. Depois conecte o YouTube dentro do Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. A partir daí, o Gemini CLI publica no YouTube como uma chamada de ferramenta comum.

O Gemini CLI consegue publicar um carrossel no YouTube?

Não, e a recusa diz o motivo em vez de dizer “não suportado”: a unidade do YouTube é o vídeo, não um conjunto de imagens fixas. A Hermoso pode montar os slides em um vídeo e publicar esse. O Gemini CLI chama a mesma ferramenta de publicação de qualquer forma, e um canal que não comporta carrossel é recusado com o motivo real indicado.

O Gemini CLI consegue rodar anúncios no YouTube, além de publicar?

A Hermoso monta campanhas de pesquisa, display e Performance Max no Google Ads, com volumes do Planejador de Palavras-chave e ações de conversão. Não existe criador de campanhas de vídeo no YouTube, e não damos a entender que exista.

O Gemini CLI precisa da minha senha do YouTube?

Não. Você conecta o YouTube ao Hermoso uma vez, por uma tela de consentimento OAuth em um navegador, e o Gemini CLI então acessa como uma chamada de ferramenta. Vincular uma conta é a única etapa que não é feita sem interface; nada depois dela precisa de senha, e nenhuma credencial é entregue ao modelo.

O Gemini CLI consegue pesquisar o YouTube antes de publicar?

Sim. O search_youtube pesquisa o índice público do YouTube, o list_youtube_videos lê os seus próprios envios, inclusive os não listados, e o analyze_video devolve a narração, o texto na tela e a lista de beats com timestamps de um vídeo de concorrente.