gasgo

Answer "where should I go right now for the best gas deal in Colombia?" — an engine over live, per-station Colombian fuel-price open data (SICOM GNCV via datos.gov.co Socrata, plus historical gasoline

SKILL.md

GitHub

gasgo — best gas deal near me (Colombia)

Engine that answers "where should I go right now for the best gas deal?" using live per-station Colombian fuel-price open data.

Invoke

bun run src/cli.ts where --city bogota --product gncv --radius 20 --top 5
bun run src/cli.ts where --lat 4.65 --lng -74.08 --product gncv
bun run src/cli.ts where --city medellin --product corriente --municipality medellin --json

Programmatic:

import { bestDeal } from "./src/engine.ts";
const res = await bestDeal({ at: { lat: 4.65, lng: -74.08 }, product: "GNCV" });
  • Products: gncv (live) · corriente · extra · diesel · biodiesel (historical)
  • Cities: bogota · medellin · cali · barranquilla · cucuta · bucaramanga · pereira
  • Set SODA_APP_TOKEN to lift the anonymous Socrata rate limit.

See README.md for the data-source table, ranking model, gotchas, and roadmap.

Tests

bun test   # geo, date-gotcha, ranking, product-classification, geo-resolution honesty (32/32)