skills.rest
thecolab-ai
thecolab-aiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

petrolmate-nz-au

Retrieve AU and NZ fuel prices by location, fuel type, and brand.

24|6|Updated Apr 10, 2026
Search Tags:#cli#json output#location search#public api#geocoding#new zealand#fuel prices
One-click install
npx skills add https://github.com/thecolab-ai/.skills --skill petrolmate-nz-au
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: petrolmate-nz-au
Source: https://github.com/thecolab-ai/.skills/tree/main/skills/petrolmate-nz-au
Command: npx skills add https://github.com/thecolab-ai/.skills --skill petrolmate-nz-au

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Fuel price lookup near a specific location is time-consuming, and agents need a reliable way to turn “near me” requests into actionable station-level results with current prices and freshness.

Core Features & Use Cases

  • Location-based station search: Find stations near an address, built-in NZ/AU city name, coordinates, or approximate IP location.
  • Fuel-type filtering and ranking: Filter by common fuel types (e.g., ULP, PULP95, DIESEL, LPG) and sort by price (cheapest) or distance.
  • Machine-readable output: Return results as structured JSON suitable for downstream automation or dashboards.

Use case examples

  • Compare “cheapest 95 near St Heliers” by fuel type and show the freshest available pricing.
  • Ask for “diesel stations within 10km of Auckland CBD” and optionally filter by brand.
  • Provide an agent-friendly JSON list of nearby stations for an app or workflow.

Quick Start

Ask the agent for nearby ULP (91) fuel stations around St Heliers and return the cheapest options in JSON.

Frequently Asked Questions about petrolmate-nz-au

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the cheapest fuel prices near a specific location in New Zealand?▼

Find the cheapest fuel prices by specifying a location and fuel type to retrieve live station pricing data. You can search by address, city name, or coordinates, then sort the results by price to identify the lowest cost options nearby.

Can I get fuel station prices returned as JSON output for automation workflows?▼

Yes, fuel station prices can be returned as structured JSON output suitable for automation. This allows downstream applications and dashboards to consume the live location-based pricing data and station freshness metrics programmatically.

How do I check fuel price data freshness when comparing nearby stations?▼

Fuel price data freshness is indicated by an hours_old metric included with the station results. This timestamp helps you assess how current the reported prices are when comparing stations near your specified location.

Does fuel price lookup support filtering by specific brands and fuel types like diesel or LPG?▼

Yes, fuel price lookup supports filtering by specific brands and fuel types including ULP, PULP95, DIESEL, and LPG. This allows you to narrow down nearby station results based on your preferred fuel type and operator.

Can I search for fuel stations using IP-based geolocation or coordinates instead of an address?▼

Yes, you can search for fuel stations using IP-based geolocation or coordinates instead of an address. The location search supports named cities, geocoded addresses, and direct coordinates to find nearby stations.

What is the best way to compare 95 octane fuel prices across different stations?▼

The best way to compare 95 octane prices is to query nearby stations filtered by the PULP95 fuel type and sort by price. This returns a ranked list of stations with current pricing and data freshness for your location.

Related Skills

Explore More Data & Analytics Skills→
jholhewresjholhewres
3

location

Convert addresses to coordinates and retrieve IP geolocation data.

Community
Intermediate
nahisahonahisaho
3

scientific-human-protein-atlas

Query Human Protein Atlas REST endpoints and output structured JSON or CSV results.

Community
Intermediate
markwang2658markwang2658
31

maps

Geocode locations, find nearby places, and calculate routes using OpenStreetMap data.

Community
Advanced
thecolab-aithecolab-ai
24

gaspy-nz

Query the Gaspy NZ fuel price feed for national averages and cheapest stations.

Official
Basic