navvi
Compilador de scrapers web que transforma tareas de navegación en scripts reutilizables con persistencia. Utiliza modelos para seleccionar controles y genera artefactos ejecutables sin llamadas al modelo en replays saludables. Incluye anti-detección y gestión de credenciales.
Ficha actualizada 22 sept 2026, 14:44 · upstream 22 sept 2026, 14:09 · release v3.21.0
Qué es navvi
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Navvi es una herramienta open source que actúa como compilador de scrapers web, permitiendo convertir tareas de navegación manual en scripts reutilizables y robustos. A diferencia de los agentes tradicionales que redescubren el flujo cada vez, Navvi genera un artefacto con selectores, huellas digitales y trazas de navegación que pueden ejecutarse repetidamente sin incurrir en costes de modelo. El sistema separa la toma de decisiones estructurales (decider) de la interacción libre (writer), permitiendo una optimización eficiente donde el scraper compilado reutiliza la interpretación del prompt original.
La arquitectura soporta múltiples backends como Claude Code, Codex o Jev a través de Vercel AI Gateway, gestionando tanto la elección de candidatos en la página web como la escritura de texto libre. Incluye un navegador con anti-detección por defecto (Camoufox) y permite la extracción de datos estructurados con tipado explícito (moneda, booleanos, URLs). El sistema también ofrece mecanismos de reparación automática ante cambios en el DOM, aunque algunos ajustes pueden requerir recompilación o intervención manual.
Para el despliegue local se requiere Node.js 22+ y Playwright para gestionar los navegadores Chromium o Camoufox. La persistencia de datos reside en directorios locales bajo storage/, que deben mantenerse privados. Las llamadas al modelo solo ocurren durante la compilación inicial o cuando se fuerza una recompilación, mientras que las ejecuciones posteriores son puramente deterministas y rápidas.
- Scraping recurrente de ofertas de empleo sin costes repetidos por llamada a LLM
- Extracción de datos de e-commerce con tipado automático (precios, stock)
- Mantenimiento de scrapers ante cambios en el DOM mediante reparación automática
- Automatización de flujos complejos que requieren interacción libre y selección estructurada
- Integración con Apify para escalar la recolección de datos web
- Reutilización del scraper compilado con cero llamadas al modelo en replays saludables
- Soporte nativo para anti-detección mediante Camoufox y gestión de huellas digitales
- Extracción de datos con tipado explícito (money, boolean, url) sin intervención del modelo
- Separación de roles decider/writer para optimizar costes y latencia en diferentes backends
- Mecanismos de reparación automática cuando los selectores o el DOM cambian
- Dependencia de claves API externas (Anthropic, TypeSafe) o CLI locales firmadas
- No incluye soporte nativo para contenedores Docker ni archivos Dockerfile
- La escritura de selectores por parte del modelo está prohibida; solo elige entre candidatos
- Requiere Node.js 22+ y Playwright instalado previamente para los navegadores
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.
Instalar globalmente con npm install -g navvi@3.0.0 o desde fuente compilando con npm run build. Configurar variables de entorno como NAVVI_BROWSER (chromium o omitir para Camoufox) y claves API (AI_GATEWAY_API_KEY, ANTHROPIC_API_KEY). Mantener el directorio storage/ privado y evitar exponer credenciales. Asegurar que Playwright tenga los navegadores instalados antes de ejecutar tareas críticas.
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.