Publicar no TikTok a partir do Claude Code

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

Conectar o Hermoso ao Claude Code

1. Um comando, e sem chave.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Já está dentro de uma sessão? Digite /plugin marketplace add hermoso-ai/hermoso, depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso (research, ad-from-brand, generate, product-photoshoot e marketing) que rodam o comando hermoso pelo npx, então nenhuma lista de ferramentas é carregada nas suas sessões, e nada custa contexto até ser executado.
2. Entre uma vez.

   npx -y hermoso auth login

   Ele abre um login pelo navegador em loopback, do mesmo jeito que o gh faz, e guarda uma credencial de acesso exclusivo do dono em ~/.hermoso/config.json. O Claude Code roda isso por você na primeira vez que precisar da Hermoso. Sem navegador nessa máquina, por exemplo em CI, num servidor remoto ou num contêiner? Crie uma chave em MCP & CLI → Terminal & API keys e rode npx -y hermoso auth login --token hmk_…. Uma chave tem autoridade real para gastar, então trate-a como uma senha.
3. Opcional: o servidor MCP também. Se você quiser também as ferramentas da Hermoso na lista de ferramentas do próprio Claude Code, rode claude mcp add hermoso -- npx -y hermoso mcp depois de entrar. Ele lê a mesma credencial guardada, então nenhuma chave vai para o .claude.json. As skills alcançam todas as ferramentas sem ele.
4. Peça algo ao Claude Code. “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 plugin e o servidor MCP opcional acessam as mesmas ferramentas e a mesma conta. A diferença é o contexto: uma lista de ferramentas é carregada em cada sessão antes de você digitar qualquer coisa, enquanto as skills não custam nada até que um comando seja executado.

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 Claude Code 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 Claude Code

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

“Renderize três variações do gancho, publique publicamente a mais forte, envie as outras duas para os rascunhos do TikTok e imprima os IDs de publicação.”

Isso percorre search_tiktok → plan_ad → render_ad → post_to_tiktok. O Claude Code pede permissão antes de rodar uma ferramenta, e a transcrição fica bem ali no terminal, então uma etapa de publicação é uma linha que você pode ler antes de apertar y.

Claude Code no TikTok: a parte que pega

Defina a privacidade no comando, sempre. O TikTok não permite um padrão, então uma etapa que a deixa de fora é recusada antes de qualquer envio, que é a falha certa para uma execução sem supervisão. Uma publicação que ainda está sendo processada volta como pendente; consulte o tiktok_post_status com o ID da publicação em vez de tentar de novo, porque uma nova tentativa é uma segunda publicação.

O plugin não traz manifesto de ferramentas, o que importa mais em uma execução longa e sem supervisão: o agente chama o comando hermoso a cada etapa, e --json em qualquer comando lhe dá uma saída de máquina para 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 Claude Code 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 Claude Code, publique em: Facebook · Instagram · Threads · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou veja tudo para onde o Claude Code pode publicar.

Publique no TikTok a partir de: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing com Claude Code

Perguntas frequentes

O Claude Code consegue publicar no TikTok?

Sim, com o plugin do Claude Code da Hermoso. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial por conta própria, então não há chave para criar nem para colar. O Claude Code então tem 922+ ferramentas, incluindo as que publicam no TikTok, além das que pesquisam os anúncios que já estão rodando no seu mercado e renderizam o criativo em primeiro lugar.

Como conecto o TikTok ao Claude Code?

Duas etapas, uma vez cada. Um comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dentro de uma sessão, /plugin marketplace add hermoso-ai/hermoso e depois /plugin install hermoso@hermoso. Ele instala cinco skills da Hermoso que acionam a CLI hermoso, então nenhuma lista de ferramentas é carregada nas suas sessões. Entre uma vez com npx -y hermoso auth login, que abre o navegador e guarda a credencial por conta própria, então não há chave para criar nem para colar. Depois conecte o TikTok dentro da Hermoso em Configurações → Conectores, que é uma tela de consentimento OAuth no navegador. Daí em diante, o Claude Code publica no TikTok como uma chamada de ferramenta comum.

O Claude Code 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 Claude Code 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 Claude Code 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.

O Claude Code 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 Claude Code 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 Claude Code?

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.