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:
- Publique 1 carrossel por dia - Consistência vence viralidade
- Monitore tudo - Cada postagem gera dados
- Aprenda com os dados - Quais ganchos funcionam? Quais horários? Quais visuais?
- 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:
| Tipo | Objetivo | Estilo Visual |
|---|---|---|
| CHOQUE | Parar a rolagem com algo impossível/absurdo | Surreal, caótico, "espera o quê?" |
| CURIOSIDADE | Criar lacuna de informação | Misterioso, segredos sendo revelados |
| CONTRADIÇÃO | Mostrar combinação impossível | Relaxado + 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
- Gere 3 variantes com
generate-hooks.sh - Revise com visão, classifique cada uma de 1 a 5 em novidade
- Elimine tudo que parecer familiar
- Use o melhor gancho para o carrossel
- 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:
| Slide | Tipo | Conteúdo |
|---|---|---|
| 1 | GANCHO | Pergunta/problema que prende. Estabelece TODO o estilo visual. |
| 2 | Problema | Agrava a dor. "Você publica no TikTok... depois no Instagram..." |
| 3 | Agravação | Concorrência avançando. Urgência. |
| 4 | Solução | Apresente o produto com sua proposta de valor. |
| 5 | Funcionalidade | Benefício principal. |
| 6 | CTA | "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
- Documentação: https://docs.upload-post.com/api/upload-photo
Parâmetros enviados:
platform[]=tiktok+platform[]=instagramauto_add_music=true- Adiciona música automaticamente no TikToktiktok_title- Título curto (máx. 90 caracteres) + hashtagstitle- Legenda completa para o Instagramprivacy_level=PUBLIC_TO_EVERYONEmedia_type=IMAGE- Carrossel de fotos no Instagramasync_upload=true- Processamento em segundo planophotos[]- Os 6 slides JPG
⚠️ IMPORTANTE Instagram: Após a publicação, o usuário deve ir ao Instagram e adicionar música viral manualmente:
- Abra o Instagram → Perfil → A postagem
- Editar → Adicionar música
- 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:
-
Análises do perfil:
GET /api/analytics/{user}?platforms=tiktok→ Seguidores, curtidas, comentários, compartilhamentos, impressões
-
Impressões totais:
GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true→ Total de visualizações por dia
-
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ável | Descrição |
|---|---|
GEMINI_API_KEY | Chave da API Google para geração de imagens |
UPLOADPOST_TOKEN | Token do Upload-Post para publicação e análises |
UPLOADPOST_USER | Nome de usuário do Upload-Post (obrigatório) |
Exemplos de Gancho por Nicho
| Nicho | Exemplo 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?
| Viraloop | Outras habilidades | |
|---|---|---|
| Publicação | Direto no feed | Apenas rascunhos |
| Música | Música em tendência automática | Manual |
| Plataformas | TikTok + Instagram | Plataforma única |
| Pesquisa | Análise automática de URL | Descrição manual |
| Coerência de imagem | Referência imagem-para-imagem | Slides independentes |
| Geração de imagem | Gemini (nível gratuito) | Provedores pagos |
| Postagem | upload-post.com (gratuito, sem CC) | Pago ou auto-hospedado |
| Sobreposição de texto | Nativo de IA (Gemini renderiza) | Scripts externos |
| Prompts | Modelos estruturados | Forma livre |
| Configuração | 3 variáveis de ambiente | Configuraçã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_musicno 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)