Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

benzina-radar

benzina-radar es una herramienta CLI en Node.js que consulta datos abiertos del Ministerio italiano MIMIT para encontrar estaciones de combustible más baratas cerca o en ruta, soportando gasolina, diésel, gas y metano con salida JSON.

Ficha actualizada 27 sept 2026, 20:44 · upstream 27 sept 2026, 19:51 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es benzina-radar

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

benzina-radar es una herramienta de línea de comandos escrita en Node.js que procesa datos abiertos diarios del Ministerio de Empresas italiano (MIMIT) para identificar las estaciones de combustible más económicas. Funciona sin dependencias de tiempo de ejecución y mantiene un núcleo inferior a 1500 líneas de código, priorizando la simplicidad y el bajo consumo de recursos.

La aplicación permite consultar precios de gasolina, diésel, gas licuado (LPG) y metano, filtrando por radio geográfico o polilínea de ruta. Incluye lógica para descartar datos obsoletos (por defecto mayores a 73 horas) y ofrece salida en formato JSON, ideal para integración con otros sistemas o dashboards personalizados.

El proyecto opera bajo la licencia AGPL-3.0-only, permitiendo uso comercial mediante licencias específicas. Está diseñado para ser autohospitable sin necesidad de contenedores Docker ni orquestación compleja, requiriendo aproximadamente 1 GB de RAM y 10 GB de disco.

CASOS DE USO
  • Encontrar la estación más barata dentro de un radio específico desde una ubicación GPS.
  • Identificar estaciones a lo largo de un trayecto definido por polilínea (corredor).
  • Calcular ahorros potenciales comparando precios locales con el promedio.
  • Consultar precios históricos o actuales mediante salida JSON estructurada.
  • Procesar datos offline utilizando archivos CSV locales para anagrafas y precios.
PUNTOS DESTACADOS
  • Utiliza datos oficiales del MIMIT, garantizando transparencia en los precios reportados.
  • Arquitectura ligera sin dependencias de tiempo de ejecución (zero runtime dependencies).
  • Soporte multi-carburante (gasolina, diésel, gas, metano) y tipos de servicio.
  • Código núcleo compacto (<1500 LOC) facilitando auditoría y mantenimiento.
  • Salida JSON nativa para integración programática sencilla.
PRECAUCIONES
  • No incluye contenedores Docker ni archivos de orquestación (Dockerfile/Compose).
  • Los precios pueden cambiar durante el día; los datos son snapshots diarios a las 08:00.
  • Requiere Node.js >= 22.18, lo que limita entornos con versiones antiguas.
  • No soporta instalación con un clic (supportsOneClick: false).
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Cheapest self-service diesel within 5 km and how much you save on a full tank.
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Requiere Node.js versión 22.18 o superior. Se recomienda ejecutar en entorno Linux/macOS/Windows con al menos 1 GB de RAM y 10 GB de disco disponible. No es necesario usar Docker; se instala directamente vía npm/npx. Para uso offline, preparar archivos CSV locales para anagrafas y precios.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
06

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.