Publicar no TikTok 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 TikTok, e o que o TikTok 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 TikTok, 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 TikTok que o Gemini CLI recebe

• post_to_tiktok: publica um vídeo finalizado, ou um post de fotos de até 35 imagens, ao vivo no perfil com a privacidade que você escolher, ou nos rascunhos do TikTok para terminar no app. Também carrega as configurações de interação (comentários, dueto, stitch), o quadro de capa e a declaração de conteúdo de marca.
• schedule_post: coloca na fila para depois, na agenda compartilhada, com a privacidade fixada quando você enfileira.
• tiktok_account / tiktok_creator_info: a bio da conta, a verificação, as contagens de seguidores e de vídeos, e os níveis de privacidade que a própria conta permite.
• tiktok_post_status: acompanha um post que o TikTok ainda está processando, para que um upload lento seja verificado em vez de postado duas vezes.
• list_tiktok_videos / tiktok_account_insights: posts recentes com visualizações, curtidas, comentários e compartilhamentos, e as análises próprias da conta, com dados demográficos de seguidores em uma conta Business com 100 ou mais seguidores.
• list_tiktok_comments / reply_to_tiktok_comment / moderate_tiktok_comment: lê os comentários dos seus posts, responde como a conta, e curte, oculta ou exclui, depois que a autorização da conta do TikTok está conectada.
• search_tiktok: busca por palavra-chave em todo o TikTok público, que é a metade de pesquisa.

Mais dois fatos operacionais. Posts de foto no TikTok são puxados de uma URL, e não enviados, então o host que serve as imagens precisa ser verificado no portal de desenvolvedores do TikTok antes que posts de foto possam sair. E um rascunho não tem quadro de capa: em uma publicação direta, o Hermoso define o melhor quadro do vídeo como capa, enquanto para um rascunho você escolhe a capa no app do TikTok.

Limites do TikTok 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:

“Renderize duas variações de gancho de 15 segundos para o nosso produto, publique a primeira publicamente e envie a segunda para os meus rascunhos do TikTok.”

Isso percorre search_tiktok → plan_ad → render_ad → post_to_tiktok. 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 TikTok: a parte que pega

O Gemini CLI pede confirmação antes de rodar um comando de shell, então um post no TikTok aparece como uma linha hermoso que você pode ler antes, inclusive a privacidade. Em uma publicação direta, o Hermoso define o melhor quadro do vídeo como capa; um rascunho não recebe capa, e você escolhe uma no app do TikTok.

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 TikTok antes de publicar

O Hermoso não tem busca na biblioteca de anúncios do TikTok do tipo que roda na Meta, então a pesquisa no TikTok é orgânica: o search_tiktok encontra o que está funcionando por palavra-chave, e o analyze_video desmonta um clipe em gancho, momentos e texto na tela para que o padrão possa ser reaproveitado, e não adivinhado.

A metade paga

O TikTok Ads é uma das doze plataformas pagas em que o Hermoso monta e lê campanhas, incluindo campanhas Smart+ e Spark Ads que promovem um post orgânico, e é uma conexão separada da orgânica. As campanhas rodam na Marketing API do TikTok e a publicação roda na aprovação de conteúdo do TikTok, então o Hermoso informa cada uma separadamente, sem deixar que uma insinue a outra. Só uma troca de status com confirmação arma dinheiro real.

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 · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo o que o Gemini CLI pode publicar.

Publique no TikTok 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 TikTok?

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 TikTok, e também as que pesquisam os anúncios que já rodam no seu mercado e renderizam o criativo do zero.

Como conecto o TikTok 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 TikTok dentro do Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. A partir daí, o Gemini CLI publica no TikTok como uma chamada de ferramenta comum.

Qual é o limite de legenda do TikTok ao publicar a partir do Gemini CLI?

A legenda de um vídeo no TikTok pode ter até 2.200 caracteres, e a de uma publicação de foto, até 4.000. A Hermoso aplica o limite quando a publicação é criada ou colocada na fila, então o Gemini CLI é avisado na hora, em vez de falhar depois, quando ninguém está acompanhando.

O Gemini CLI consegue pesquisar o TikTok antes de publicar?

Sim, de forma orgânica: a Hermoso não tem pesquisa na biblioteca de anúncios do TikTok. O search_tiktok encontra o que está funcionando por palavra-chave, e o analyze_video divide um clipe em seu gancho, beats e texto na tela.

O Gemini CLI consegue publicar no TikTok de forma privada ou como rascunho?

Sim. Uma publicação no TikTok pode ir para todos, para seguidores, para amigos ou só para você, ou ir para os seus rascunhos. O TikTok quer que o criador escolha a privacidade de cada publicação, entre os níveis que a conta permite, então a Hermoso pergunta em vez de escolher por você. A Hermoso recusa uma visibilidade que o TikTok não consegue cumprir no momento em que você pede, em vez de publicar discretamente algo mais fraco.

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

Sim. O TikTok Ads é uma das doze plataformas pagas que a Hermoso gerencia, e se conecta separadamente da publicação orgânica no TikTok. Cada uma das duas partes roda com a sua própria aprovação do TikTok, e a Hermoso informa cada uma separadamente, em vez de inferir uma pela outra.