openstreetmap

name	OpenStreetMap
description	Forward and reverse geocoding via Nominatim (no API key, ~1 req/sec).
requires	{"bins":[],"env":[]}

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.