Publicar no TikTok 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 TikTok, e o que o TikTok 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 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 Codex 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 Codex

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

“Sem interação: renderize três variações de gancho, publique a primeira para todos, envie as outras duas como rascunhos no TikTok e imprima os ids de publicação em JSON.”

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

Este é o par em que as regras do TikTok mais importam. A privacidade tem que ser declarada, nunca presumida, então coloque-a no prompt ou o job é recusado antes do upload. E um upload lento volta como pendente, e não como concluído: faça a execução consultar tiktok_post_status com o id de publicação, porque postar de novo enquanto o TikTok ainda processa publicaria o vídeo duas vezes.

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

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

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 TikTok e as que pesquisam os anúncios que já estão rodando no seu mercado e criam o criativo do zero.

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

O Codex precisa da minha senha do TikTok?

Não. Você conecta o TikTok ao Hermoso uma vez, por uma tela de consentimento OAuth em um navegador, e o Codex 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.

Quanto custa publicar no TikTok a partir do Codex?

Publicar no TikTok não custa créditos; o TikTok não cobra nada por chamada de API. Os créditos são gastos no render. 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.

O Codex consegue publicar um carrossel no TikTok?

Sim. Um post de fotos no TikTok aceita até 35 imagens, na ordem em que você as passar, e a ordem é o slideshow. Vídeo não pode ser misturado. O Codex chama a mesma ferramenta de publicação em qualquer caso, e um canal que não consegue carregar um carrossel é recusado com o motivo real anexado.

O Codex consegue agendar um post no TikTok 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 TikTok é um dos onze canais que entram na fila.