yawa
yawa es una plataforma de análisis web autocontenido que no requiere dashboards ni banners de cookies. Utiliza el Protocolo de Contexto de Modelo (MCP) para consultar datos de tráfico en lenguaje natural, sin necesidad de banners GDPR o consentimiento.
Ficha actualizada 23 sept 2026, 16:39 · upstream 23 sept 2026, 16:24 · release app/v0.0.9
Qué es yawa
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
yawa es un sistema de análisis web autocontenido que permite monitorear el comportamiento de usuarios sin necesidad de interfaces gráficas complejas. En lugar de dashboards tradicionales, se basa en una API y un MCP server para consultar datos mediante preguntas naturales. El sistema recopila visitas de página, eventos personalizados y métricas de rendimiento del navegador (Core Web Vitals) a través de un script ligero. No requiere banners de cookies ni consentimiento explícito. Su arquitectura incluye un contenedor Docker que aloja el servidor API y el MCP server, conectando con una base de datos DuckDB para persistencia de datos.
- Monitoreo del tráfico web sin necesidad de dashboards complejos
- Consultas analíticas mediante lenguaje natural (preguntas en español)
- Análisis de páginas más visitadas y sus métricas de engagement
- Identificación de referrers, navegadores y dispositivos de origen
- Seguimiento de eventos personalizados con metadatos opcionales
- Monitoreo del rendimiento web (Core Web Vitals) por página o globalmente
- No requiere dashboards ni interfaces gráficas complejas, solo una API y un MCP server
- Permite consultas en lenguaje natural con Claude Code, Codex o cualquier cliente MCP compatible
- Soporta múltiples sitios web mediante tokens de acceso separados por hostname
- Proporciona métricas detalladas como tráfico diario, top páginas, referrers y distribución por dispositivos
- Incluye seguimiento de eventos personalizados con metadatos opcionales (nombre, valor, etc.)
- No incluye herramientas avanzadas como mapas de calor o análisis de journeys de usuario
- Soporte para MCP en Claude web requiere OAuth y no tokens Bearer aún está disponible
- El tracking del tráfico se realiza mediante un script ligero que puede generar IDs de sesión aleatorios si el secret no se configura
- La persistencia de datos depende de una base de DuckDB local, lo que limita la escalabilidad a nivel de servidor
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar y ejecutar yawa: crea un archivo docker-compose.yml con un servicio 'app' que expone el puerto 3000 (API) y 9999 (CLI). Configura una variable de entorno YAWA_SESSION_SECRET para mejorar la precisión del conteo de visitantes. Ejecuta `docker compose up -d`. Para obtener tokens de acceso, ejecuta `docker exec -it <container> ./cli token create --name mytoken` y copia el token. Registra tu dominio en el servidor con `docker exec -it <container> ./cli site create --hostname tu-dominio.com`. Conecta tus clientes MCP (Claude Code, Codex, Mistral Vibe) mediante la URL del endpoint MCP y un token Bearer. Para instalar el tracker en sitios existentes, añade una etiqueta `<script>` al head de tu página o usa npm con `yawa-tracker`, habilitando opcionalmente Web Vitals.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.