Quiz, recomendação e cadastro em etapas no lugar do "deixe seu e-mail". Você pede ao Claude Code ou ao Codex, e ele instala e configura no seu site.
O popguia é um projeto open source para criar popups que conversam com o visitante: em vez de pedir o e-mail logo de cara, ele faz duas ou três perguntas, ensina algo útil e indica o produto, curso ou conteúdo certo. Serve para quem tem um site (HTML, Next.js, Astro, WordPress) e usa um agente de código como Claude Code, Codex ou Cursor: o agente instala, escreve as jornadas e acompanha os resultados. É grátis, com licença MIT, sem mensalidade e sem servidor nosso. Hoje o repositório tem a pesquisa e o plano; o código ainda vai ser escrito.
A Alia mostrou que jornadas interativas convertem mais que o popup de desconto, mas funciona só na Shopify e cobra por visitante. O popguia leva a mesma técnica para qualquer site, de graça.
Uma CLI (npx popguia init), um servidor MCP e uma skill ensinam o seu agente a detectar o site, colocar o script e criar as jornadas.
Jornadas, experimentos e pesos ficam em JSON dentro do seu repositório. Dá para revisar no git, desfazer e versionar como código.
Grupo de controle, teste A/B e depois um algoritmo (Thompson sampling) que manda mais visitantes para a versão que funciona melhor.
Os textos das variantes são escritos pelo agente do próprio usuário: o MCP entrega as instruções e o formato, sem chamar nenhuma API paga nossa.
Meta de até 15 KB (gzip), <dialog> acessível, sem deslocar o layout (CLS 0) e sem modal na entrada no celular.
Tempo, rolagem, intenção de saída, inatividade e clique, com limite de frequência e pausa depois de fechar.
Eventos vão para o Umami, PostHog ou GA4 que você já usa, ou para um coletor que você mesmo publica na sua conta Cloudflare.
Nada disso precisa estar pronto hoje: é o que o plano prevê para a primeira versão.
Claude Code, Codex ou Cursor, aberto na pasta do seu site.
# exemplo claude
Para rodar a CLI e o servidor MCP com npx.
# conferir node -v
HTML, Next.js, Astro ou Vite (WordPress numa fase seguinte). A instalação recusa pasta com alterações não salvas.
# conferir git status
Atenção: os comandos abaixo são o desenho do plano (docs/03). Os pacotes ainda não foram publicados no npm. Por enquanto, o que dá para fazer é ler a pesquisa e o plano.
Mercado, projetos open source, instalação pela IA, arquitetura, algoritmos e conformidade.
git clone https://github.com/inematds/popguia cd popguia && cat PLANO.md
Um prompt só. O agente lê o setup.md, adiciona a skill e o MCP e segue sozinho.
# no Claude Code, dentro da pasta do seu site "Leia https://inematds.github.io/popguia/setup.md e instale um quiz de 3 perguntas que recomende o produto certo para cada visitante."
A CLI detecta o framework, mostra o diff antes e só mexe em um arquivo de layout e na pasta popguia/.
npx popguia init --dry-run # mostra o que vai mudar npx popguia init # aplica
Modelos prontos: diagnóstico, quiz educativo, Learn & Earn, microcompromisso e newsletter em 2 etapas.
npx popguia add jornada --template diagnostico npx popguia validate # schema, acessibilidade, LGPD npx popguia preview
Relatório com grupo de controle; o otimizador só mexe nos pesos quando há dados suficientes.
npx popguia report --html > relatorio.html npx popguia optimize --experimento welcome-titulo npx popguia doctor https://seu-site.com
O plano valida o popguia em sites fictícios dentro do próprio repositório, publicados no GitHub Pages. Eles ainda serão construídos.
3 perguntas sobre objetivo e nível e indicação dos 3 cursos mais adequados de um catálogo fictício.
Learn & Earn: o visitante aprende sobre o produto, revela um cupom e deixa o e-mail em duas etapas.
Newsletter em 2 etapas com gatilho de rolagem ou de saída, limite de frequência e versão para celular.
Cada fase só fecha com testes que provam o resultado (critérios no PLANO.md). Hoje: pesquisa e plano concluídos.
