Quiz, recomendación y registro por etapas en lugar del "deja tu correo". Se lo pides a Claude Code o a Codex, y él lo instala y configura en tu sitio.
popguia es un proyecto open source para crear popups que conversan con el visitante: en vez de pedir el correo de entrada, hace dos o tres preguntas, enseña algo útil e indica el producto, curso o contenido adecuado. Sirve para quien tiene un sitio (HTML, Next.js, Astro, WordPress) y usa un agente de código como Claude Code, Codex o Cursor: el agente instala, escribe los recorridos y da seguimiento a los resultados. Es gratis, con licencia MIT, sin mensualidad y sin servidor nuestro. Hoy el repositorio tiene la investigación y el plan; el código todavía está por escribirse.
Alia demostró que los recorridos interactivos convierten más que el popup de descuento, pero funciona solo en Shopify y cobra por visitante. popguia lleva la misma técnica a cualquier sitio, gratis.
Una CLI (npx popguia init), un servidor MCP y una skill enseñan a tu agente a detectar el sitio, colocar el script y crear los recorridos.
Los recorridos, experimentos y pesos quedan en JSON dentro de tu repositorio. Se pueden revisar en git, deshacer y versionar como código.
Grupo de control, prueba A/B y luego un algoritmo (Thompson sampling) que envía más visitantes a la versión que funciona mejor.
Los textos de las variantes los escribe el agente del propio usuario: el MCP entrega las instrucciones y el formato, sin llamar a ninguna API de pago nuestra.
Meta de hasta 15 KB (gzip), <dialog> accesible, sin desplazar el layout (CLS 0) y sin modal al entrar desde el celular.
Tiempo, scroll, intención de salida, inactividad y clic, con límite de frecuencia y pausa después de cerrar.
Los eventos van al Umami, PostHog o GA4 que ya usas, o a un colector que tú mismo publicas en tu cuenta de Cloudflare.
Nada de esto tiene que estar listo hoy: es lo que el plan prevé para la primera versión.
Claude Code, Codex o Cursor, abierto en la carpeta de tu sitio.
# ejemplo claude
Para ejecutar la CLI y el servidor MCP con npx.
# verificar node -v
HTML, Next.js, Astro o Vite (WordPress en una fase posterior). La instalación rechaza una carpeta con cambios sin guardar.
# verificar git status
Atención: los comandos de abajo son el diseño del plan (docs/03 (en portugués)). Los paquetes todavía no se han publicado en npm. Por ahora, lo que se puede hacer es leer la investigación y el plan.
Mercado, proyectos open source, instalación por IA, arquitectura, algoritmos y cumplimiento normativo.
git clone https://github.com/inematds/popguia cd popguia && cat PLANO.md
Un solo prompt. El agente lee el setup.md, añade la skill y el MCP y sigue solo.
# en Claude Code, dentro de la carpeta de tu sitio "Lee https://inematds.github.io/popguia/setup.md e instala un quiz de 3 preguntas que recomiende el producto adecuado a cada visitante."
La CLI detecta el framework, muestra el diff antes y solo toca un archivo de layout y la carpeta popguia/.
npx popguia init --dry-run # muestra lo que va a cambiar npx popguia init # aplica
Plantillas listas: diagnóstico, quiz educativo, Learn & Earn, microcompromiso y newsletter en 2 etapas.
npx popguia add jornada --template diagnostico npx popguia validate # schema, accesibilidad, LGPD/GDPR npx popguia preview
Informe con grupo de control; el optimizador solo toca los pesos cuando hay datos suficientes.
npx popguia report --html > relatorio.html npx popguia optimize --experimento welcome-titulo npx popguia doctor https://seu-site.com
El plan valida popguia en sitios ficticios dentro del propio repositorio, publicados en GitHub Pages. Todavía se van a construir.
3 preguntas sobre objetivo y nivel e indicación de los 3 cursos más adecuados de un catálogo ficticio.
Learn & Earn: el visitante aprende sobre el producto, revela un cupón y deja el correo en dos etapas.
Newsletter en 2 etapas con disparador por scroll o por salida, límite de frecuencia y versión para celular.
Cada fase solo se cierra con pruebas que demuestran el resultado (criterios en PLANO.md (en portugués)). Hoy: investigación y plan concluidos.
