fuel-cli

Use fuel for UK fuel prices: nearby station search, station detail, ranked results with freshness tracking.

Setup

• npm install -g @shan8851/fuel-cli
• Register at https://www.fuel-finder.service.gov.uk for Fuel Finder OAuth credentials
• export FUEL_FINDER_CLIENT_ID=*** and export FUEL_FINDER_CLIENT_SECRET=*** or add to .env
• Warm cache reads work without credentials until the cache needs a refresh

Nearby Stations

• By postcode: fuel near "SE1 9SG" --fuel E10
• By coordinates: fuel near "51.501,-0.141" --fuel B7_STANDARD
• Custom radius: fuel near "SE1 9SG" --fuel E10 --radius 8mi
• Sort options: fuel near "SE1 9SG" --fuel E10 --sort price (best, price, distance, freshest)
• Limit results: fuel near "SE1 9SG" --fuel E10 --limit 5
• Force refresh: fuel near "SE1 9SG" --fuel E10 --refresh