Communitygithub.com

Upload-Post/viraloop

Habilidade de agente de IA OpenClaw para crescimento automatizado de carrosséis no TikTok e Instagram. Analisa qualquer URL de site para extrair marca, concorrentes e proposta de valor, gerando slides virais com publicação automática e música em tendência via API upload-post. Loop de feedback analítico integrado.

O que é viraloop?

Esta skill transforma o agente OpenClaw em um mecanismo de crescimento para mídias sociais, focando em criar e publicar carrosséis diários no TikTok e Instagram. A partir de uma URL de site, ela extrai automaticamente a identidade visual da marca, informações de concorrentes e mensagens-chave. Em seguida, gera seis slides visualmente coerentes usando o modelo de imagem do Gemini, com textos grandes e estilos de gancho testados (choque, curiosidade, contradição) para maximizar o engajamento. A publicação é feita diretamente no feed do usuário via API upload-post.com, com música em tendência adicionada automaticamente no TikTok. Um loop de aprendizado contínuo acompanha métricas de desempenho (visualizações, curtidas) e armazena insights em um arquivo `learnings.json`, permitindo que o agente refine sua estratégia a cada postagem.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add Upload-Post/viraloop

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que viraloop faz?

Analise qualquer site e gere um carrossel de 6 slides para TikTok/Instagram com coerência visual. Publique diretamente no seu feed (sem rascunhos) com música em tendência automática. Ambas as APIs (Gemini + upload-post.com) têm planos gratuitos — sem necessidade de cartão de crédito para começar.

Filosofia: Loop de Iteração Diário

A chave para o crescimento é consistência + aprendizado:

  1. Publique 1 carrossel por dia - Consistência vence viralidade
  2. Monitore tudo - Cada postagem gera dados
  3. Aprenda com os dados - Quais ganchos funcionam? Quais horários? Quais visuais?
  4. Itere e melhore - Cada carrossel é melhor que o anterior
Dia 1: Postar → Analisar → Aprender
Dia 2: Postar (melhorado) → Analisar → Aprender  
Dia 3: Postar (melhor) → Analisar → Aprender
...
Dia 30: Você tem 30 pontos de dados e uma estratégia refinada

A habilidade mantém um learnings.json que acumula insights em todas as postagens:

  • Melhores ganchos de desempenho
  • Horários ideais de postagem
  • Estilos visuais que funcionam
  • CTAs que convertem

Esta não é uma ferramenta de um único uso. É um motor de crescimento.

Início Rápido

# 1. Pesquisa completa do negócio
node {baseDir}/scripts/analyze-web.js https://seu-site.com

# 2. Gere 3 variantes de gancho (CHOQUE, CURIOSIDADE, CONTRADIÇÃO)
GEMINI_API_KEY="sua-chave" bash {baseDir}/scripts/generate-hooks.sh

# 3. Revise os ganchos com visão, escolha o melhor

# 4. Gere slides usando o tipo de gancho selecionado
GEMINI_API_KEY="sua-chave" bash {baseDir}/scripts/generate-slides.sh [shock|curiosity|contradiction]

# 5. Revise os slides (o agente verifica texto e qualidade)
# O agente usa visão para verificar cada slide

# 6. Publique no TikTok + Instagram
UPLOADPOST_TOKEN="seu-token" bash {baseDir}/scripts/publish-carousel.sh

# 7. Verifique as análises (após 24-48h)
UPLOADPOST_TOKEN="seu-token" bash {baseDir}/scripts/check-analytics.sh 7

# 8. Aprenda com os dados para os próximos carrosséis
node {baseDir}/scripts/learn-from-analytics.js

Categorias de Gancho (Sistema de Novidade Visual)

A chave para quebrar o teto de 1000 visualizações é a novidade visual no primeiro slide. Geramos 3 tipos de gancho:

TipoObjetivoEstilo Visual
CHOQUEParar a rolagem com algo impossível/absurdoSurreal, caótico, "espera o quê?"
CURIOSIDADECriar lacuna de informaçãoMisterioso, segredos sendo revelados
CONTRADIÇÃOMostrar combinação impossívelRelaxado + intenso, "como isso é possível?"

Filtro Anti-Estoque

Todos os ganchos incluem instruções anti-estoque para evitar:

  • Estética genérica de fotos de banco de imagens
  • Clichê da garota bonita surpresa
  • Poses típicas de influenciadores
  • Cenários superutilizados de laptop-café
  • Cenas corporativas de aperto de mão

Fluxo de Teste de Gancho

  1. Gere 3 variantes com generate-hooks.sh
  2. Revise com visão, classifique cada uma de 1 a 5 em novidade
  3. Elimine tudo que parecer familiar
  4. Use o melhor gancho para o carrossel
  5. Acompanhe qual TIPO de gancho tem melhor desempenho ao longo do tempo

Modelo de Imagem

Usa gemini-3.1-flash-image-preview para gerar slides.

  • Script local: {baseDir}/scripts/generate_image.py
  • Suporta imagem-para-imagem para coerência visual entre slides

Passo 1: Pesquisa Completa (analyze-web.js)

Realiza investigação COMPLETA do negócio:

1. Análise da Marca

  • Nome da marca (do domínio ou título)
  • Logo (URL ou SVG)
  • Cores CSS (fundo, primária, links, títulos)
  • Tipografia (fonte do corpo, fonte dos títulos)
  • Favicon

2. Análise de Conteúdo

  • Manchete e slogan
  • Todos os títulos (estrutura da página)
  • Funcionalidades/benefícios (título + descrição)
  • Preços/planos
  • Depoimentos
  • Estatísticas/métricas
  • CTAs
  • Meta tags (título, descrição, og:image)

3. Páginas Internas

  • Navega pelas páginas de preços, funcionalidades, sobre, depoimentos
  • Extrai conteúdo adicional de cada página

4. Detecção de Concorrentes

  • Procura por menções conhecidas de concorrentes no conteúdo
  • Lista de 20+ concorrentes SaaS conhecidos (Buffer, Hootsuite, Later, etc.)
  • Detecta seções "vs", "alternativa", "compare"
  • Nenhuma pesquisa externa necessária - tudo a partir do próprio site

5. Narrativa

  • Detecta o tipo de negócio (SaaS, ecommerce, app)
  • Detecta o nicho (ferramentas-de-midia-social, ferramentas-para-desenvolvedores, etc.)
  • Gera ganchos com base nos pontos de dor do cliente
  • Define pontos de dor a partir das funcionalidades
  • Cria narrativa de transformação (antes → depois)

6. Contexto Visual

  • Cores da marca em formato CSS
  • Descrição das cores para prompts
  • Tipografia para slides
  • Temas de imagem baseados no nicho
  • Guia de estilo para coerência

Saída: /tmp/carousel/analysis.json

Passo 2: Gerar Slides (generate-slides.sh)

Gera 6 slides com coerência visual usando imagem-para-imagem:

SlideTipoConteúdo
1GANCHOPergunta/problema que prende. Estabelece TODO o estilo visual.
2ProblemaAgrava a dor. "Você publica no TikTok... depois no Instagram..."
3AgravaçãoConcorrência avançando. Urgência.
4SoluçãoApresente o produto com sua proposta de valor.
5FuncionalidadeBenefício principal.
6CTA"Link na bio 👆" + chamada para ação.

Coerência Visual

  • O slide 1 gera o estilo base (cores, tipografia, clima)
  • Os slides 2-6 usam imagem-para-imagem com o slide 1 como referência
  • Mantém a mesma paleta de cores, fontes e estética

Prompts por Slide

Cada slide tem:

  • Texto: A mensagem principal
  • Cena: Descrição visual detalhada do fundo
  • Estilo: Baseado na análise da marca

Saída:

  • /tmp/carousel/slide-{1-6}.jpg
  • /tmp/carousel/caption.txt

Passo 3: Revisão com Visão

Após gerar, o agente DEVE revisar cada slide:

  • ✓ O texto é legível e correto
  • ✓ As palavras não estão cortadas
  • ✓ Ortografia correta
  • ✓ Coerência visual entre os slides
  • ✓ Qualidade de imagem aceitável

Se houver erros, regere o slide específico.

Formato da Imagem

  • Resolução: 768x1376 (proporção vertical 9:16)
  • Formato: JPG (TikTok NÃO aceita PNG)
  • Texto: Grande, negrito, com sombra para legibilidade
  • Fundo: Cena relevante para o negócio, não apenas cores sólidas

Passo 4: Publicar no TikTok + Instagram (publish-carousel.sh)

Publique o carrossel no TikTok e Instagram usando a API Upload-Post.

UPLOADPOST_TOKEN="seu-token" bash {baseDir}/scripts/publish-carousel.sh

Endpoint: POST /api/upload_photos

Parâmetros enviados:

  • platform[]=tiktok + platform[]=instagram
  • auto_add_music=true - Adiciona música automaticamente no TikTok
  • tiktok_title - Título curto (máx. 90 caracteres) + hashtags
  • title - Legenda completa para o Instagram
  • privacy_level=PUBLIC_TO_EVERYONE
  • media_type=IMAGE - Carrossel de fotos no Instagram
  • async_upload=true - Processamento em segundo plano
  • photos[] - Os 6 slides JPG

⚠️ IMPORTANTE Instagram: Após a publicação, o usuário deve ir ao Instagram e adicionar música viral manualmente:

  1. Abra o Instagram → Perfil → A postagem
  2. Editar → Adicionar música
  3. Pesquise uma música em tendência/viral

Saída: Salva request_id em post-info.json para rastreamento.

Passo 5: Analisar Desempenho (check-analytics.sh)

Obtém análises do TikTok e Instagram para ver o que funciona.

UPLOADPOST_TOKEN="seu-token" bash {baseDir}/scripts/check-analytics.sh 7

Endpoints usados:

  1. Análises do perfil:

    GET /api/analytics/{user}?platforms=tiktok
    

    → Seguidores, curtidas, comentários, compartilhamentos, impressões

  2. Impressões totais:

    GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true
    

    → Total de visualizações por dia

  3. Análises por postagem:

    GET /api/uploadposts/post-analytics/{request_id}
    

    → Visualizações, curtidas, comentários para o carrossel específico (TikTok + Instagram)

Documentação: https://docs.upload-post.com/api/get-analytics

Passo 6: Aprender e Melhorar (learn-from-analytics.js)

Analisa os dados e salva aprendizados para futuros carrosséis.

node {baseDir}/scripts/learn-from-analytics.js

Gera:

  • learnings.json - Base de conhecimento acumulada
  • Melhores ganchos (os que geram mais visualizações)
  • Horários ideais de postagem
  • Recomendações para o próximo carrossel

Fluxo Completo

# 1. Pesquise o negócio
node {baseDir}/scripts/analyze-web.js https://meu-produto.com

# 2. Gere slides
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh

# 3. Revise com visão (o agente verifica o texto)
# O agente verifica cada imagem do slide

# 4. Publique
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="meuuser" bash {baseDir}/scripts/publish-carousel.sh

# 5. (Após algumas horas/dias) Analise
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="meuuser" bash {baseDir}/scripts/check-analytics.sh 7

# 6. Aprenda para os próximos carrosséis
node {baseDir}/scripts/learn-from-analytics.js

Arquivos

{baseDir}/
├── SKILL.md                      # Esta documentação
└── scripts/
    ├── analyze-web.js            # Pesquisa completa do negócio
    ├── generate-slides.sh        # Gera 6 slides com coerência
    ├── generate_image.py         # Imagem Gemini 3.1 flash
    ├── review-slides.js          # Prepara slides para revisão
    ├── publish-carousel.sh       # Publica via API Upload-Post
    ├── check-analytics.sh        # Obtém análises (TikTok + Instagram)
    ├── learn-from-analytics.js   # Aprende com os dados
    └── search-competitors.js     # Pesquisa externa opcional

Variáveis de Ambiente

VariávelDescrição
GEMINI_API_KEYChave da API Google para geração de imagens
UPLOADPOST_TOKENToken do Upload-Post para publicação e análises
UPLOADPOST_USERNome de usuário do Upload-Post (obrigatório)

Exemplos de Gancho por Nicho

NichoExemplo de Gancho
Ferramentas de Mídia Social"Ainda postando em mídias sociais UM POR UM? 😩"
SaaS Geral"Ainda fazendo isso MANUALMENTE?"
E-commerce"O produto que o TikTok não vai parar de recomendar"
Aplicativo"O app que eu gostaria de ter descoberto antes"
Ferramentas para Devs"A API que vai mudar seu código"

Por que Viraloop?

ViraloopOutras habilidades
PublicaçãoDireto no feedApenas rascunhos
MúsicaMúsica em tendência automáticaManual
PlataformasTikTok + InstagramPlataforma única
PesquisaAnálise automática de URLDescrição manual
Coerência de imagemReferência imagem-para-imagemSlides independentes
Geração de imagemGemini (nível gratuito)Provedores pagos
Postagemupload-post.com (gratuito, sem CC)Pago ou auto-hospedado
Sobreposição de textoNativo de IA (Gemini renderiza)Scripts externos
PromptsModelos estruturadosForma livre
Configuração3 variáveis de ambienteConfiguração complexa multi-ferramenta

Notas

  • A análise extrai concorrentes do próprio conteúdo do site (20+ SaaS conhecidos)
  • Imagem-para-imagem mantém a coerência, mas leva ~20s por slide
  • A legenda gerada inclui hashtags relevantes ao nicho
  • Sempre revise o texto do slide - às vezes ele é cortado
  • auto_add_music no TikTok melhora o engajamento
  • Verifique as análises após 24-48h para obter dados significativos
  • Os aprendizados se acumulam e melhoram a cada carrossel publicado
  • Título do TikTok tem no máximo 90 caracteres (truncado automaticamente com hashtags)

Habilidades Relacionadas