find-nearby

Find nearby restaurants, cafes, and amenities using OpenStreetMap geocoding and Overpass queries.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill find-nearby-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-nearby
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/leisure/find-nearby
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill find-nearby-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Locating nearby places like restaurants, pharmacies, or cafes usually requires a maps app or a paid API key. This Skill answers "what's near me" queries directly from coordinates, addresses, cities, zip codes, or Telegram location pins using free OpenStreetMap data. ## Core Features & Use Cases - Flexible Location Input: Accepts raw latitude/longitude coordinates or automatically geocodes addresses, cities, zip codes, and landmarks via Nominatim. - Multi-Type Place Search: Queries Overpass for one or more amenity types (restaurant, cafe, bar, pharmacy, hospital, ATM, etc.) within a configurable radius, sorted by distance. - Rich Results: Returns names, distances, cuisine, opening hours, addresses, phone numbers, and ready-to-use Google Maps and directions links, with optional JSON output. - Use Case: A user shares a Telegram location pin and asks for nearby coffee shops; the Skill runs the script with those coordinates and returns a ranked list of cafes with distances and map links. ## Quick Start Ask the assistant to find restaurants near a specific address or shared location pin, optionally specifying the place type and search radius.

Frequently Asked Questions about find-nearby

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

FAQPage Schema
How do I find nearby restaurants without a Google Maps API key?

Use OpenStreetMap's free Overpass API to query amenities around coordinates. The find_nearby.py script accepts --lat/--lon or --near with an address, plus --type restaurant and --radius, returning results sorted by distance with no API key required.

How to search multiple place types in one OpenStreetMap query?

Repeat the --type flag for each amenity, for example --type restaurant --type bar. The script builds a combined Overpass QL query covering all requested amenity types within the specified radius.

Can I search nearby places using a zip code or address instead of coordinates?

Yes, pass the address, city, zip code, or landmark with --near and it is geocoded automatically via Nominatim. Note that zip codes alone can be ambiguous globally, so include a country or state if results look wrong.

Why does the nearby search return no results?

Sparse results usually mean the radius is too small or OpenStreetMap coverage is limited in that region. Widen the radius from 1500m to 3000m, and note that the script tries multiple Overpass servers before returning empty.

Does OpenStreetMap data include opening hours for places?

Opening hours are included when present in OSM tags and appear in the hours field of results. Coverage is incomplete since OSM is community-maintained, so verify hours with a web search for accuracy.