OpenStreetMap

Forward and reverse geocoding via Nominatim (no API key, ~1 req/sec).

SKILL.md

GitHub

OpenStreetMap

Use this skill for geocoding (place → coordinates) and reverse geocoding (coordinates → address). Backed by the openstreetmap extension which calls Nominatim. No API key needed.

Use when

  • "Find coordinates for this address"
  • "What address is at lat 40.42, lon -3.70?"
  • "Look up a place but avoid Google APIs"
  • Need a free, no-key alternative to goplaces / Google Places

Do not use when

  • Need rich POI data (reviews, photos, opening hours) → use goplaces
  • Need driving directions or routing
  • High-frequency batch geocoding (Nominatim caps at ~1 req/sec)

Tools

status

No arguments. Returns provider/endpoint/rate-limit info.

search (forward geocoding)

  • query (string, required) — place query (e.g., "Museo del Prado, Madrid")
  • limit (integer, optional, 1–20, default 5)
  • country_codes (string, optional) — comma-separated ISO codes (e.g., "es,pt")

Returns results: [{display_name, lat, lon, class, type, importance, boundingbox}].

reverse (reverse geocoding)

  • lat (number, required, -90..90)
  • lon (number, required, -180..180)
  • zoom (integer, optional, 0..18, default 18)

Returns {display_name, resolved:{lat,lon}, address:{road,city,state,country,country_code,postcode,...}}.

Execution guidance

  • Tool calls are throttled to ~1 req/sec per Nominatim usage policy. Do not loop fast.
  • Prefer country_codes to disambiguate common place names ("Springfield", "Cambridge").
  • Report display_name so the user can verify the right place was matched.
  • If search returns -32001 not found, try a broader query or include the country.
  • For routing/driving directions, OSM is not the right tool here.