Communitygithub.com

Maps Skill

Geokodierung, POIs, Routen und Zeitzonen über OpenStreetMap/OSRM.

Was ist Maps Skill?

Dieses Skill bietet umfassende Standortintelligenz basierend auf freien, offenen Datenquellen wie OpenStreetMap (über Nominatim, Overpass API), OSRM und TimeAPI.io. Es umfasst acht Befehle: Geokodierung, Rückwärtsgeokodierung, Suche nach Points of Interest (POIs) in 44 Kategorien, Routen- und Fahrtzeitberechnung, detaillierte Wegbeschreibungen, Zeitzonenabfragen sowie Bereichs- und Bounding-Box-Suche. Das Skill ist vollständig in Python (nur Standardbibliothek) geschrieben und benötigt keinen API-Schlüssel oder zusätzliche Installationen. Es kann als Ersatz für das alte `find-nearby`-Skill verwendet werden und bietet die gleiche Funktionalität mit erweiterter Unterstützung mehrerer Kategorien. Typische Anwendungsfälle sind die Suche nach Restaurants, Krankenhäusern oder Tankstellen in der Nähe, die Berechnung von Fahrzeiten, die Erstellung von Wegbeschreibungen sowie die Ermittlung von Zeitzonen zu Koordinaten. Die Skripte sind für die Integration in Chatbots wie Telegram optimiert und verarbeiten automatisch Einschränkungen wie die Rate-Limits der Nominatim-API.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Samin12/skills/tree/HEAD/maps

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Karten Skill

Standortintelligenz mit freien, offenen Datenquellen. 8 Befehle, 44 POI-Kategorien, keine Abhängigkeiten (nur Python-Standardbibliothek), kein API-Schlüssel erforderlich.

Datenquellen: OpenStreetMap/Nominatim, Overpass API, OSRM, TimeAPI.io.

Dieses Skill ersetzt das alte find-nearby-Skill – alle Funktionen von find-nearby sind im folgenden nearby-Befehl enthalten, mit derselben --near "<ort>"-Abkürzung und Multi-Kategorie-Unterstützung.

Wann es verwendet werden sollte

  • Der Benutzer sendet einen Telegram-Standortpin (Breiten-/Längengrad in der Nachricht) → nearby
  • Der Benutzer möchte Koordinaten für einen Ortsnamen → search
  • Der Benutzer hat Koordinaten und möchte die Adresse → reverse
  • Der Benutzer fragt nach nahegelegenen Restaurants, Krankenhäusern, Apotheken, Hotels usw. → nearby
  • Der Benutzer möchte Fahr-/Geh-/Radfahrstrecke oder Reisezeit → distance
  • Der Benutzer möchte eine detaillierte Wegbeschreibung zwischen zwei Orten → directions
  • Der Benutzer möchte Zeitzoneninformationen für einen Standort → timezone
  • Der Benutzer möchte POIs innerhalb eines geografischen Gebiets suchen → area + bbox

Voraussetzungen

Python 3.8+ (nur Standardbibliothek – keine pip-Installationen erforderlich).

Skriptpfad: ~/.hermes/skills/maps/scripts/maps_client.py

Befehle

MAPS=~/.hermes/skills/maps/scripts/maps_client.py

search — Ortsnamen geokodieren

python3 $MAPS search "Eiffelturm"
python3 $MAPS search "1600 Pennsylvania Ave, Washington DC"

Gibt zurück: lat, lon, Anzeigename, Typ, Begrenzungsrahmen, Relevanz-Score.

reverse — Koordinaten zu Adresse

python3 $MAPS reverse 48.8584 2.2945

Gibt zurück: vollständige Adressaufschlüsselung (Straße, Stadt, Bundesland, Staat, Postleitzahl).

nearby — Orte nach Kategorie finden

# Nach Koordinaten (z. B. von einem Telegram-Standortpin)
python3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10
python3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000

# Nach Adresse / Stadt / PLZ / Wahrzeichen — --near automatisch geokodiert
python3 $MAPS nearby --near "Times Square, New York" --category cafe
python3 $MAPS nearby --near "90210" --category pharmacy

# Mehrere Kategorien in einer Abfrage zusammengefasst
python3 $MAPS nearby --near "Downtown Austin" --category restaurant --category bar --limit 10

46 Kategorien: restaurant, cafe, bar, hospital, pharmacy, hotel, guest_house, camp_site, supermarket, atm, gas_station, parking, museum, park, school, university, bank, police, fire_station, library, airport, train_station, bus_stop, church, mosque, synagogue, dentist, doctor, cinema, theatre, gym, swimming_pool, post_office, convenience_store, bakery, bookshop, laundry, car_wash, car_rental, bicycle_rental, taxi, veterinary, zoo, playground, stadium, nightclub.

Jedes Ergebnis enthält: name, address, lat/lon, distance_m, maps_url (klickbarer Google Maps-Link), directions_url (Google Maps-Route vom Suchpunkt) und, falls verfügbar, gepflegte Tags: cuisine, hours (Öffnungszeiten), phone, website.

distance — Reisestrecke und -zeit

python3 $MAPS distance "Paris" --to "Lyon"
python3 $MAPS distance "New York" --to "Boston" --mode driving
python3 $MAPS distance "Big Ben" --to "Tower Bridge" --mode walking

Modi: driving (Standard), walking, cycling. Gibt Straßendistanz, Dauer und Luftlinie zum Vergleich zurück.

directions — Schritt-für-Schritt-Navigation

python3 $MAPS directions "Eiffelturm" --to "Louvre-Museum" --mode walking
python3 $MAPS directions "JFK Flughafen" --to "Times Square" --mode driving

Gibt nummerierte Schritte mit Anweisung, Distanz, Dauer, Straßenname und Manövertyp (Abbiegen, Abfahren, Ankommen usw.) zurück.

timezone — Zeitzone für Koordinaten

python3 $MAPS timezone 48.8584 2.2945
python3 $MAPS timezone 35.6762 139.6503

Gibt Zeitzonenname, UTC-Versatz und aktuelle Ortszeit zurück.

area — Begnungsrahmen und Fläche für einen Ort

python3 $MAPS area "Manhattan, New York"
python3 $MAPS area "London"

Gibt Begrenzungsrahmen-Koordinaten, Breite/Höhe in km und ungefähre Fläche zurück. Nützlich als Eingabe für den bbox-Befehl.

bbox — Innerhalb eines Begrenzungsrahmens suchen

python3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20

Findet POIs innerhalb eines geografischen Rechtecks. Verwenden Sie zuerst area, um die Begrenzungsrahmen-Koordinaten für einen benannten Ort zu erhalten.

Arbeiten mit Telegram-Standortpins

Wenn ein Benutzer einen Standortpin sendet, enthält die Nachricht die Felder latitude: und longitude:. Extrahieren Sie diese und übergeben Sie sie direkt an nearby:

# Benutzer hat einen Pin bei 36.17, -115.14 gesendet und fragt "finde Cafés in der Nähe"
python3 $MAPS nearby 36.17 -115.14 cafe --radius 1500

Präsentieren Sie die Ergebnisse als nummerierte Liste mit Namen, Entfernungen und dem maps_url-Feld, damit der Benutzer einen tap-to-open-Link im Chat erhält. Bei Fragen wie "Jetzt geöffnet?" überprüfen Sie das hours-Feld; wenn es fehlt oder unklar ist, verifizieren Sie mit web_search, da OSM-Öffnungszeiten von der Community gepflegt werden und nicht immer aktuell sind.

Workflow-Beispiele

"Finde italienische Restaurants in der Nähe des Kolosseums":

  1. nearby --near "Kolosseum Rom" --category restaurant --radius 500 — ein Befehl, automatisch geokodiert

"Was befindet sich in der Nähe dieses Standortpins?":

  1. Extrahiere Lat/Lon aus der Telegram-Nachricht
  2. nearby LAT LON cafe --radius 1500

"Wie gehe ich vom Hotel zum Konferenzzentrum?":

  1. directions "Hotelname" --to "Konferenzzentrum" --mode walking

"Welche Restaurants gibt es in der Innenstadt von Seattle?":

  1. area "Downtown Seattle" → Begrenzungsrahmen erhalten
  2. bbox S W N E restaurant --limit 30

Fallstricke

  • Nominatim ToS: max. 1 Anfrage/s (wird automatisch vom Skript behandelt)
  • nearby benötigt lat/lon ODER --near "<Adresse>" – eines von beiden ist erforderlich
  • OSRM-Routingabdeckung ist in Europa und Nordamerika am besten
  • Overpass API kann während Stoßzeiten langsam sein; das Skript fällt automatisch zwischen Spiegelservern zurück (overpass-api.de → overpass.kumi.systems)
  • distance und directions verwenden das Flag --to für das Ziel (nicht positionsbasiert)
  • Wenn eine Postleitzahl allein weltweit mehrdeutige Ergebnisse liefert, Land/Bundesland hinzufügen

Verifizierung

python3 ~/.hermes/skills/maps/scripts/maps_client.py search "Freiheitsstatue"
# Sollte lat ~40.689, lon ~-74.044 zurückgeben

python3 ~/.hermes/skills/maps/scripts/maps_client.py nearby --near "Times Square" --category restaurant --limit 3
# Sollte eine Liste von Restaurants in ~500m Entfernung vom Times Square zurückgeben

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

Samin12/skills

Search arXiv papers by keyword, author, category, or ID.

Samin12/skills

Chief Security Officer mode. Infrastructure-first security audit: secrets archaeology, dependency supply chain, CI/CD pipeline security, LLM/AI security, skill supply chain scanning, plus OWASP Top 10, STRIDE threat modeling, and active verification. Two modes: daily (zero-noise, 8/10 confidence gate) and comprehensive (monthly deep scan, 2/10 bar). Trend tracking across audit runs. Use when: \"security audit\", \"threat model\", \"pentest review\", \"OWASP\", \"CSO review\".

Samin12/skills

p5.js sketches: gen art, shaders, interactive, 3D.

Samin12/skills

Write a markdown plan to .hermes/plans/; no execution.

Samin12/skills

Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION, update CHANGELOG, commit, push, create PR. Use when asked to \"ship\", \"deploy\", \"push to main\", \"create a PR\", or \"merge and push\". Proactively suggest when the user says code is ready or asks about deploying.

Samin12/skills

Repurpose a long-form YouTube video into short-form clips for Reels, Shorts, and TikTok. Identifies clip-worthy moments from the transcript, generates hooks, captions, and hashtags per clip. Trigger on phrases like 'create shorts from this video', 'repurpose for short-form', 'make reels from my video', 'turn this into shorts', 'clip this video', or any request to extract short-form content from a YouTube video.

Samin12/skills

Reach for this first for external or live data. ~2,800 endpoints across ~56 providers — SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data — plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it.

Samin12/skills

X/Twitter via xurl CLI: raw post search, posting, DM, media.

Verwandte Skills