find-nearby

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

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill find-nearby-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: find-nearby
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/leisure/find-nearby
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill find-nearby-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding local places like restaurants, pharmacies, or cafes usually requires opening a maps app and manually searching. This Skill lets you discover nearby places directly from a conversation using coordinates, addresses, cities, zip codes, or Telegram location pins, with no API keys required. ## Core Features & Use Cases - Flexible Location Input: Accepts raw coordinates, street addresses, city names, zip codes, or landmarks, with automatic geocoding via Nominatim. - Multi-Type Place Search: Query multiple amenity types (restaurant, bar, pharmacy, hotel, etc.) in one call with configurable radius and result limits. - Rich Results: Returns names, distances, cuisine, opening hours, addresses, and Google Maps links plus turn-by-turn directions URLs. - Use Case: A user shares a Telegram location pin and asks for nearby coffee shops. The Skill extracts the coordinates, queries OpenStreetMap, and returns the closest cafes with distances and map links. ## Quick Start Ask the agent 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 a coordinate. The find_nearby.py script accepts --lat/--lon or a --near address, geocodes it via Nominatim, and returns restaurants sorted by distance with map links.

How to search for multiple place types in one OpenStreetMap query?▼

Pass the --type flag multiple times, for example --type restaurant --type bar. The script builds a combined Overpass QL query with one amenity filter per type and returns merged results sorted by distance.

Does OpenStreetMap place search work with zip codes?▼

Yes, zip codes are geocoded through Nominatim into coordinates before the Overpass search. However, zip codes can be ambiguous globally, so include a country or state if results appear to be in the wrong region.

Why does the nearby search return no results?▼

Empty results usually mean the radius is too small or OpenStreetMap coverage is sparse in that area. Widen the radius from 1500m to 3000m or more, and verify the geocoded location matches the intended place.

Can I check if a place is open now from OpenStreetMap data?▼

Results include an opening_hours field when present in OSM tags, but coverage is incomplete. Cross-reference with a web search to verify current hours, since community-maintained OSM data is not always up to date.