meghal86/tiktok-app-marketing

Marketing no TikTok para Aplicativos

Automatize todo o seu pipeline de marketing de slideshow no TikTok: gere → sobreponha → publique → analise → itere.

Resultados comprovados: 7 milhões de visualizações no artigo viral do X, mais de 1 milhão de visualizações no TikTok, R$ 670/mês de MRR — tudo a partir de um agente de IA rodando em um PC gamer velho.

Pré-requisitos

Esta skill NÃO inclui nenhuma dependência. Seu agente de IA precisará pesquisar e instalar o seguinte com base na sua configuração. Diga ao seu agente o que você está usando e ele descobrirá o resto.

Obrigatório

• Node.js (v18+) — todos os scripts rodam no Node. Seu agente deve verificar se está instalado e instalá-lo se necessário.
• node-canvas (npm install canvas) — usado para adicionar sobreposições de texto às imagens dos slides. Este é um módulo nativo que pode precisar de ferramentas de compilação (Python, make, compilador C++) em alguns sistemas. Seu agente deve pesquisar os requisitos de instalação para o seu sistema operacional.
• Postiz — esta é a espinha dorsal de todo o sistema. O Postiz gerencia a publicação no TikTok (e em mais de 28 outras plataformas), mas, mais importante, fornece a API de análise que alimenta o ciclo de feedback diário. Sem o Postiz, o agente pode publicar, mas não consegue rastrear o que está funcionando — e o ciclo de feedback é o que faz esta skill realmente aumentar sua conta, em vez de apenas publicar cegamente. Cadastre-se em postiz.pro/oliverhenry.

Geração de Imagens (escolha um)

Você escolhe o que gera suas imagens. Seu agente deve pesquisar a documentação da API para o que você escolher:

• OpenAI — gpt-image-1.5 (SEMPRE 1.5, nunca 1). Precisa de uma chave de API da OpenAI. Melhor para imagens realistas no estilo fotográfico. É o que Larry usa e o que recomendamos fortemente.
• Stability AI — Stable Diffusion XL e mais recentes. Precisa de uma chave de API do Stability AI. Bom para imagens estilizadas/artísticas.
• Replicate — execute qualquer modelo de código aberto (Flux, SDXL, etc.). Precisa de um token do Replicate. Mais flexível.
• Local — traga suas próprias imagens. Não precisa de API. Coloque as imagens no diretório de saída e o script pula a geração.

Rastreamento de Conversão (opcional, mas recomendado para aplicativos móveis)

• RevenueCat — é o que completa o ciclo de inteligência. O Postiz informa quais posts geram visualizações. O RevenueCat informa quais posts geram usuários pagantes. Combinados, o agente pode distinguir entre um post viral que não gera dinheiro e um post modesto que realmente converte — e otimizar de acordo. Instale a skill do RevenueCat do ClawHub (clawhub install revenuecat) para acesso total à API de assinantes, MRR, testes, churn e receita. Há também um MCP do RevenueCat para controle programático de produtos e ofertas a partir do seu agente/IDE.

Compartilhamento Cruzado (opcional, recomendado)

O Postiz suporta compartilhamento cruzado para Instagram Reels, YouTube Shorts, Threads, Facebook, LinkedIn e mais de 20 outras plataformas simultaneamente. Seu agente deve pesquisar quais plataformas se encaixam no seu público e conectá-las no Postiz. Mesmo conteúdo, algoritmos diferentes, mais alcance.

Primeira Execução — Integração

Quando esta skill for carregada pela primeira vez, IMEDIATAMENTE inicie uma conversa com o usuário. Não despeje uma lista de verificação — converse com ele como um parceiro de marketing humano faria. O fluxo abaixo é um guia, não um roteiro. Seja natural. Faça uma ou duas perguntas de cada vez. Reaja ao que eles dizem. Construa com base nas respostas.

Importante: Use scripts/onboarding.js --validate ao final para confirmar se a configuração está completa.

Fase 0: Aquecimento da Conta do TikTok (CRÍTICO — Não Pule Isso)

Antes de qualquer outra coisa, verifique se o usuário já possui uma conta no TikTok com histórico de publicações. Se ele estiver criando uma conta nova, ele DEVE aquecê-la primeiro, ou o TikTok o tratará como um bot e reduzirá o alcance desde o primeiro dia.

Explique isso naturalmente:

"Pergunta rápida antes de começarmos — você já tem uma conta no TikTok que vem usando, ou vamos começar do zero? Se for nova, precisamos aquecê-la primeiro. O algoritmo do TikTok observa como contas novas se comportam, e se você for direto da criação da conta para postar slideshows de IA, ele marca você como bot e acaba com seu alcance."

Se a conta for nova ou quase não usada, oriente-o sobre o seguinte:

O objetivo é usar o TikTok como uma pessoa normal por 7 a 14 dias antes de publicar qualquer coisa. Gaste 30 a 60 minutos por dia no aplicativo:

• Role a página Para Você naturalmente. Assista alguns vídeos até o fim. Pule outros na metade. Não assista todos até o final — não é assim que pessoas reais rolam.
• Curta com moderação. Talvez 1 em cada 10 vídeos. Não curta tudo — isso é comportamento de bot. Curta apenas coisas com as quais você genuinamente se envolveria no seu nicho.
• Siga contas no seu nicho. Se eles estão promovendo um aplicativo de fitness, siga criadores de fitness. Design de interiores? Contas de design de interiores. Isso treina o algoritmo para entender sobre o que é a conta.
• Assista conteúdo do nicho intencionalmente. Esta é a parte mais importante. O TikTok aprende com o que você se envolve e começa a mostrar mais disso. Você quer que a página Para Você seja dominada por conteúdo semelhante ao que você vai publicar.
• Deixe alguns comentários genuínos. Não spam. Reações reais. Alguns por sessão.
• Talvez publique 1-2 vídeos casuais. Nada promocional. Apenas conteúdo normal que mostre ao TikTok que há uma pessoa real por trás da conta.

O sinal a ser observado: Quando eles abrirem o TikTok e quase todos os vídeos na página Para Você forem do nicho deles, a conta está aquecida. O algoritmo os entende. AGORA eles podem começar a publicar.

Diga ao usuário: "Eu sei que duas semanas parecem tempo perdido, mas contas que pulam o aquecimento consistentemente têm 80-90% menos alcance nas primeiras publicações. Faça o aquecimento. É a diferença entre seu primeiro post ter 200 visualizações e 20.000."

Se a conta já estiver ativa e estabelecida, pule isso completamente e vá para a Fase 1.

Fase 1: Conheça o Aplicativo do Usuário (Conversacional)

Comece de forma casual. Algo como:

"Ei! Vamos configurar seu marketing no TikTok. Primeiro — me fale sobre seu aplicativo. Qual é o nome e o que ele faz?"

Depois, APROFUNDE-SE com base no que eles disserem. Não faça todas as 9 perguntas de uma vez. Puxe o fio:

• Eles mencionam o que faz → pergunte para quem é ("Quem é seu usuário ideal?")
• Eles descrevem o público → pergunte sobre o ponto de dor ("Qual é o principal problema que ele resolve para eles?")
• Eles explicam o problema → pergunte o que os diferencia ("O que faz o seu se destacar em relação às alternativas?")
• Obtenha o link da App Store / site naturalmente ("Pode me mandar o link?")
• Determine a categoria (casa/beleza/fitness/produtividade/alimentação/outro) — geralmente inferível

Não peça por "diretrizes de marca" roboticamente. Em vez disso: "Você tem algum conteúdo existente ou uma vibe que está buscando? Ou vamos começar do zero?"

Depois, pergunte sobre o aplicativo e a monetização:

"Isso é um aplicativo móvel? E você usa RevenueCat (ou algum sistema de assinatura/compras no aplicativo) para lidar com pagamentos?"

Isso é crítico porque determina se podemos fechar o ciclo de feedback completo. Se eles tiverem um aplicativo móvel com RevenueCat:

• Conte a eles sobre a skill RevenueCat no ClawHub (clawhub install revenuecat). Ela fornece acesso total à API para assinantes, MRR, testes, churn, receita e transações. Não instale automaticamente — apenas avise que ela existe e o que ela desbloqueia, e eles podem instalá-la se quiserem.
• Explique por que isso importa: Sem dados do RevenueCat, a skill só pode otimizar para visualizações (métricas de vaidade). Com ela, a skill otimiza para usuários pagantes reais. A diferença é enorme. Um post com 200 mil visualizações e zero conversões não vale nada. Um post com 5 mil visualizações e 10 assinantes pagos é ouro. Você só consegue perceber a diferença com o RevenueCat conectado.

Se eles não usarem RevenueCat, mas tiverem outro sistema de assinatura, anote e trabalhe com o que estiver disponível. Se não for um aplicativo móvel (ex.: produto físico, SaaS, serviço), pule o RevenueCat, mas ainda assim rastreie a métrica de conversão que eles tiverem (inscrições no site, compras, leads).

Armazene tudo em tiktok-marketing/app-profile.json.

Fase 2: Pesquisa de Concorrentes (Requer Permissão do Navegador)

Antes de construir qualquer estratégia de conteúdo, pesquise o que os concorrentes estão fazendo no TikTok. Isso é crítico — você precisa conhecer o cenário.

Pergunte ao usuário:

"Antes de começarmos a criar conteúdo, quero pesquisar o que seus concorrentes estão fazendo no TikTok — o que está gerando visualizações no seu nicho, quais ganchos eles estão usando, o que está funcionando e o que não está. Posso usar o navegador para dar uma olhada no TikTok e na App Store?"

Aguarde a permissão. Depois:

1. Pesquise no TikTok pelo nicho do aplicativo (ex.: "aplicativo de design de interiores", "filtro de lábios", "aplicativo de transformação fitness")
2. Encontre de 3 a 5 contas concorrentes publicando conteúdo semelhante
3. Analise o conteúdo de melhor desempenho delas:
   • Que ganchos estão usando?
   • Qual formato de slide? (antes/depois, lista, POV, tutorial)
   • Quantas visualizações nos melhores vs. médios?
   • Qual a frequência de postagem?
   • Quais CTAs estão usando?
   • Quais músicas/sons estão em alta no nicho?
4. Verifique a App Store para a categoria do aplicativo — veja aplicativos concorrentes, suas capturas de tela, descrições, avaliações
5. Compile as descobertas em tiktok-marketing/competitor-research.json:

{
  "researchDate": "2026-02-16",
  "competitors": [
    {
      "name": "CompetidorApp",
      "tiktokHandle": "@competidor",
      "followers": 50000,
      "topHooks": ["gancho 1", "gancho 2"],
      "avgViews": 15000,
      "bestVideo": { "views": 500000, "hook": "..." },
      "format": "slideshows antes-depois",
      "postingFrequency": "diário",
      "cta": "link na bio",
      "notes": "Forte em X, fraco em Y"
    }
  ],
  "nicheInsights": {
    "trendingSounds": [],
    "commonFormats": [],
    "gapOpportunities": "O que os concorrentes NÃO estão fazendo que poderíamos",
    "avoidPatterns": "O que claramente não está funcionando"
  }
}

6. Compartilhe as descobertas com o usuário de forma conversacional:

"Então, dei uma olhada no que está por aí. O [Concorrente A] está indo bem com [formato] — o melhor post deles teve [X] visualizações usando [tipo de gancho]. Mas notei que ninguém está realmente fazendo [lacuna]. Essa é a nossa vantagem."

Esta pesquisa informa diretamente a geração de ganchos e a estratégia de conteúdo. Consulte-a ao criar posts.

Fase 3: Formato de Conteúdo e Geração de Imagens

Primeiro, pergunte sobre o formato:

"Você quer fazer slideshows (carrosséis de fotos) ou vídeo? Slideshows são o que o Larry usa e é para o que esta skill foi construída — os dados do TikTok mostram que eles geram 2,9x mais comentários e 2,6x mais compartilhamentos do que vídeo, e são muito mais fáceis para a IA gerar consistentemente. Dito isso, se você quiser tentar vídeo, a skill suporta, mas não foi tão testada quanto os slideshows. A decisão é sua."

Armazene a escolha como format: "slideshow" ou format: "video" na configuração. Se eles escolherem vídeo, observe que a sobreposição de texto, a estrutura de 6 slides e os modelos de prompt são projetados para slideshows. Vídeo exigirá mais experimentação, e o agente deve ser transparente sobre isso.

Para slideshows (recomendado):

Pergunte naturalmente:

"Para os slideshows, precisamos de imagens. Eu recomendo fortemente o gpt-image-1.5 da OpenAI — é o que o Larry usa e produz imagens que realmente parecem ter sido tiradas no celular de alguém. É a diferença entre 'claramente IA' e 'espera, isso é real?' Você também pode usar Stability AI, Replicate, ou trazer suas próprias imagens, se preferir."

⚠️ Se eles escolherem OpenAI, certifique-se de que o modelo esteja definido como gpt-image-1.5 — NUNCA gpt-image-1. A diferença na qualidade é enorme. O gpt-image-1 produz imagens visivelmente parecidas com IA que as pessoas ignoram. O gpt-image-1.5 produz resultados fotorrealistas que fazem as pessoas pararem para ver. Esta única configuração pode ser a diferença entre 1 mil e 100 mil visualizações.

Se eles estiverem em dúvida, sempre recomende o gpt-image-1.5. É a escolha comprovada.

Armazene na configuração como imageGen com provider, apiKey e model.

Se eles escolherem OpenAI, mencione a API Batch:

"Uma coisa que vale a pena saber — a OpenAI tem uma API Batch que é 50% mais barata do que a geração em tempo real. Em vez de gerar slides na hora, você os submete como um job em lote e recebe os resultados em até 24 horas (geralmente muito mais rápido). É perfeito para pré-gerar os slides de amanhã durante a noite. Mesma qualidade, metade do custo. Quer que eu configure isso?"

Se eles estiverem interessados, armazene "useBatchAPI": true na configuração de imageGen. O script de geração suporta ambos os modos — tempo real para iterações rápidas, lote para conteúdo diário programado.

Depois — e isso é crítico — trabalhe o estilo da imagem com eles. Não use apenas um prompt genérico. Imagens ruins = ninguém assiste. Pergunte estas coisas naturalmente, uma ou duas de cada vez:

"Agora vamos descobrir como essas imagens devem realmente parecer. Você quer que pareçam fotos reais que alguém tirou no celular, ou mais como gráficos polidos ou ilustrações?"

Depois, com base na resposta, aprofunde-se:

• Qual é o assunto? "O que vamos mostrar de fato? Quartos? Rostos? Produtos? Comparações antes/depois?"
• Qual vibe? "Aconchegante e quente? Limpo e minimalista? Luxuoso? Pense no que seu público se relaciona ou aspira."
• Consistência: "Todos os 6 slides devem parecer o mesmo lugar ou a mesma pessoa? Se sim — preciso definir detalhes específicos para que cada slide não pareça totalmente diferente."
• Elementos obrigatórios? "Algo que TEM que estar em todas as imagens? Um produto específico? Certos móveis? Um animal de estimação?"

Construa o prompt base COM eles. Um bom prompt base se parece com:

Foto de iPhone de um [cômodo/cena específico], [estilo específico], [detalhes específicos].
Iluminação realista, cores naturais, tirada com iPhone 15 Pro.
Sem texto, sem marcas d'água, sem logotipos.
[Âncoras de consistência: "mesma janela na parede esquerda", "mesmo sofá cinza", "mesa de centro de madeira no centro"]

Salve o estilo de prompt acordado na configuração como imageGen.basePrompt para que cada post futuro o utilize.

Regras principais do prompt (explique-as conforme surgirem, não dê uma palestra):

• "Foto de iPhone" + "iluminação realista" = parece real, não gerado por IA
• Trave a arquitetura/layout em CADA prompt de slide, ou cada slide parecerá um lugar diferente
• Inclua objetos do dia a dia (canecas, controles remotos, revistas) para uma sensação de ambiente vivido
• Para antes/depois: "antes" e "depois" devem ser o MESMO cômodo, iluminação e ângulo — mude apenas a condição

Fase 4: Configuração do Postiz e API

Esta skill usa o Postiz como editor backend. O Postiz é essencial não apenas para publicar, mas para o ciclo de feedback de análise.

"O Postiz cuida da postagem real. Ele publica no TikTok, Instagram, YouTube Shorts — tudo de uma vez. Mas, mais importante, fornece as análises que nos dizem o que está funcionando. Sem análise, estamos publicando no escuro."

O que seu agente precisa configurar:

1. Peça ao usuário para se cadastrar no postiz.pro/oliverhenry se ainda não tiver uma conta
2. Eles precisam gerar uma chave de API no painel do Postiz (Configurações → API → Criar Chave)
3. Conecte suas contas de mídia social no Postiz (TikTok, Instagram, YouTube, Threads, etc.)
4. Armazene a chave de API e os IDs das contas na configuração como:

{
  "postiz": {
    "apiKey": "ptz_...",
    "accounts": {
      "tiktok": "account_id_do_tiktok",
      "instagram": "account_id_do_instagram",
      "youtube": "account_id_do_youtube"
    }
  }
}

Nota importante sobre o Postiz:

• O agente deve verificar quais plataformas o usuário deseja usar e conectar apenas essas
• O agente deve testar a conexão da API chamando o endpoint de saúde da API do Postiz
• Se a API falhar, o agente deve informar o usuário e orientá-lo na solução de problemas

Fase 5: Gere o Primeiro Post

Depois que tudo estiver configurado, é hora de gerar o primeiro slideshow.

"Show! Estamos prontos para criar seu primeiro slideshow. Vou gerar as imagens, adicionar o texto e programar a publicação. Pronto?"

O script de geração (scripts/generate.js) faz:

1. Gera 6 imagens com base na configuração de imageGen
2. Adiciona sobreposições de texto às imagens (o texto é definido nos prompts dos slides)
3. Retorna os caminhos das imagens processadas
4. Opcionalmente, envia as imagens para o Postiz como uma publicação programada

O script de postagem (scripts/publish.js) faz:

1. Pega as imagens processadas do script de geração
2. Cria uma publicação no Postiz com legendas e hashtags
3. Agenda a publicação para um horário específico
4. Retorna o ID da publicação e o horário agendado

O script de análise (scripts/analytics.js) faz:

1. Busca dados de desempenho da publicação da API do Postiz
2. Analisa visualizações, curtidas, comentários, compartilhamentos
3. Se o RevenueCat estiver configurado, busca dados de receita do mesmo período
4. Retorna uma análise completa

Recomendações para o conteúdo do primeiro post:

• Gancho: Um problema ou curiosidade que faça as pessoas pararem de rolar. Ex.: "A verdade sobre [problema comum] que ninguém te conta"
• Slides: 6 slides contando uma história ou resolvendo um problema
• CTA: O slide final deve ter uma ação clara ("Link na bio", "Compartilhe com alguém que precisa disso", "Siga para mais")
• Hashtags: Misture hashtags amplas (5-10) e de nicho (3-5) para maximizar a descoberta

Fase 6: Ciclo de Feedback e Iteração

Esta é a parte que faz esta skill se destacar. Uma vez que o primeiro post está no ar, o agente deve:

Diariamente:

1. Buscar dados de análise das últimas 24 horas
2. Analisar o desempenho: quais ganchos funcionaram? Quais CTAs converteram?
3. Se o RevenueCat estiver configurado: comparar visualizações com receita de assinatura

Cada post dá ao agente dados como:

Métrica	O que nos diz
Visualizações	Alcance bruto (métrica de vaidade sozinha)
Curtidas/Compartilhamentos	Engajamento (sinal do algoritmo)
Taxa de conclusão	O slide final está funcionando?
Novos assinantes (RevenueCat)	Receita real (a única coisa que importa)
Testes iniciados (RevenueCat)	Interesse de conversão

Ferramentas de otimização que o agente possui:

• Variação de gancho — O slide 1 (gancho) pode mudar sem regenerar as imagens
• Variação de CTA — O slide 6 (CTA) pode mudar com base no que converte
• Ajuste de agendamento — Publicar em diferentes horários/dias para encontrar a janela de pico de engajamento
• Iteração de conteúdo — Se nenhum gancho está funcionando, o agente deve sugerir novos ângulos de conteúdo

Quando otimizar:

"Deixe o post acumular dados por pelo menos 24-48 horas antes de decidir se algo está funcionando. Postagens de slideshow do TikTok geralmente levam algumas horas para o algoritmo encontrar o público certo."

Se um post tiver baixo desempenho (< 500 visualizações):

• Tente um gancho diferente no primeiro slide
• Ou uma imagem de abertura diferente
• Mude a legenda ou as hashtags
• Publique novamente em um horário diferente

Se um post tiver alto desempenho (> 10.000 visualizações):

• Analise POR QUE funcionou (gancho? imagem? som?)
• Duplique o formato para o próximo post
• Teste uma variação do gancho vencedor
• Se o RevenueCat estiver configurado, verifique se as visualizações se converteram em receita

Exemplo de ciclo de feedback:

1. Post A obtém 50 mil visualizações, 0 assinantes → viral, mas não rentável
2. Post B obtém 5 mil visualizações, 3 novos assinantes → modesto, mas rentável
3. Agente analisa: o Post A usava "transformação impressionante" como gancho, o Post B usava "problema que você não sabia que tinha"
4. Agente sugere: vamos testar o gancho do Post B com o estilo de imagem do Post A
5. Post C obtém 20 mil visualizações e 5 assinantes → conteúdo otimizado!

Scripts

A skill inclui os seguintes scripts para serem executados pelo seu agente:

Script	Função
scripts/onboarding.js	Configuração inicial guiada e validação
scripts/generate.js	Gerar slides individuais com texto e imagens
scripts/publish.js	Publicar slides via API do Postiz
scripts/analytics.js	Buscar análise de visualizações e receita
scripts/research.js	Pesquisar concorrentes e tendências do TikTok
scripts/optimize.js	Sugerir e aplicar otimizações com base em dados

Estrutura do Projeto

tiktok-marketing/
├── app-profile.json          # Perfil do aplicativo / produto
├── competitor-research.json  # Dados de pesquisa de concorrentes
├── config.json               # Configuração central
├── posts/                    # Slides gerados e metadados
│   ├── 2026-02-16-slideshow/
│   │   ├── slide-1.png
│   │   ├── slide-2.png
│   │   ├── ...
│   │   └── metadata.json
│   └── ...
├── analytics/                # Relatórios de análise e receita
│   ├── daily-report.json
│   └── revenue-report.json
└── scripts/                  # Scripts executáveis (listados acima)

Configuração

A configuração central (config.json) se parece com:

{
  "app": {
    "name": "MeuApp",
    "category": "design-de-interiores",
    "appStore": "https://apps.apple.com/...",
    "hasRevenueCat": true
  },
  "format": "slideshow",
  "imageGen": {
    "provider": "openai",
    "apiKey": "sk-...",
    "model": "gpt-image-1.5",
    "useBatchAPI": false,
    "basePrompt": "Foto de iPhone de uma sala de estar aconchegante, iluminação natural..."
  },
  "postiz": {
    "apiKey": "ptz_...",
    "accounts": {
      "tiktok": "account_id_do_tiktok"
    }
  },
  "schedule": {
    "postsPerDay": 1,
    "preferredTime": "18:00",
    "timezone": "America/Sao_Paulo"
  }
}

Segurança e Boas Práticas

• Chaves de API: Armazene sempre em variáveis de ambiente do seu agente ou em um arquivo .env que NÃO seja versionado. O arquivo de configuração deve fazer referência a elas, não contê-las.
• Permissões: Sempre peça permissão antes de automatizar postagens ou acessar navegadores para pesquisa.
• Limitação de Taxa: Configurações de API (OpenAI, Postiz, etc.) vêm com limites. Se o seu agente encontrar erros de limitação de taxa, ele deve recuar, esperar e tentar novamente.
• Propriedade do Conteúdo: O usuário é responsável pelo conteúdo que publica. Certifique-se de que ele saiba disso.

Suporte e Comunidade

Se precisar de ajuda ou quiser compartilhar suas vitórias no TikTok:

• Criador: @meghal86
• Postiz (Analytics & Postagem): postiz.pro/oliverhenry — use o link para apoiar o criador, sem custo extra
• ClawHub: Instale a Skill RevenueCat para rastreamento completo de receita
• RevenueCat: https://www.revenuecat.com/ — para inteligência de conversão móvel