← Back to Skills Marketplace
OSRM Maps Skill
by
Adhish Thite
· GitHub ↗
· v1.0.3
809
Downloads
0
Stars
2
Active Installs
4
Versions
Install in OpenClaw
/install maps-osrm
Description
Distance, routing, and geocoding using free APIs (OSRM + Nominatim/OSM). Use when the user asks about distance between places, travel time, directions, how f...
README (SKILL.md)
Maps
Free distance/routing (OSRM) and geocoding (Nominatim/OSM). No API keys needed.
Geocoding (place name → coordinates)
bash scripts/geocode.sh "Times Square, New York"
Returns lat,lon and display name. Use this first when you have place names instead of coordinates.
Distance & Route
bash scripts/distance.sh \x3Corigin_lat>,\x3Corigin_lon> \x3Cdest_lat>,\x3Cdest_lon> [mode]
Modes: driving (default), foot, bicycle
Examples:
# Manhattan to JFK Airport
bash scripts/distance.sh 40.7580,-73.9855 40.6413,-73.7781 driving
# Golden Gate Park to Fisherman's Wharf (walking)
bash scripts/distance.sh 37.7694,-122.4862 37.8080,-122.4177 foot
Workflow
- If user gives place names → geocode both with
geocode.sh - Use returned lat,lon pairs with
distance.sh - Report distance in km and duration in minutes
Limits
- OSRM: free public demo server, no hard rate limit but be reasonable
- Nominatim: max 1 request/second (OSM policy), include User-Agent
- No live traffic data — durations are estimates based on road type/speed
- Routing is road-network only (no public transit)
Usage Guidance
This skill appears coherent and implements what it claims. Important considerations before installing: (1) The scripts make network requests to public Nominatim (nominatim.openstreetmap.org) and OSRM (router.project-osrm.org); any place names or coordinates you pass will be sent to those services. Do not send sensitive or private location data unless you are comfortable with that. (2) Nominatim politely requires ~1 request/second and a descriptive User-Agent (the scripts set one); avoid high-volume use — for production/high-volume use, self-hosting these services is recommended. (3) The scripts validate inputs and avoid shell injection by delegating to python, which is good practice, but you should still review and run them in a controlled environment if you have strict security policies. (4) If you need offline or private routing/geocoding, host your own OSRM/Nominatim instances instead of using the public demo servers.
Capability Analysis
Type: OpenClaw Skill
Name: maps-osrm
Version: 1.0.3
The OpenClaw Maps skill bundle is benign. It provides distance, routing, and geocoding functionality using legitimate, well-known public APIs (OSRM and Nominatim/OSM). The scripts (`scripts/distance.sh`, `scripts/geocode.sh`) delegate URL construction and input validation to inline Python code, which properly sanitizes user input (e.g., `urllib.parse.quote` for geocoding queries, regex and range validation for coordinates) before making network requests. There is no evidence of prompt injection attempts in `SKILL.md` or `README.md`, nor any code for data exfiltration, malicious execution, persistence, or obfuscation.
Capability Assessment
Purpose & Capability
Name/description (OSRM + Nominatim geocoding and routing) matches the included scripts and SKILL.md. The only runtime dependency is python3, which is reasonable for the provided Python one-liners. No unexplained binaries, env vars, or config paths are requested.
Instruction Scope
SKILL.md instructs running two scripts that (a) query Nominatim for geocoding and (b) query OSRM for routing. The scripts validate inputs, set a User-Agent, and do not read arbitrary files, environment variables, or other system state. They perform network calls only to the documented public endpoints.
Install Mechanism
No install spec; it's instruction-only with bundled scripts. Nothing is downloaded or extracted at install time and the scripts rely on existing system python3, which is low-risk.
Credentials
The skill requires no credentials or environment variables. It does make outbound requests to public OSRM and Nominatim endpoints (documented); this is proportionate to the stated functionality.
Persistence & Privilege
always is false, the skill is user-invocable and does not request persistent system privileges or modify other skills. It does not store tokens or change system configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install maps-osrm - After installation, invoke the skill by name or use
/maps-osrm - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Updated requirement: now only requires python3 (3.6+) instead of curl and python3.
- Updated metadata and description to reflect the change in required dependencies.
v1.0.2
- No changes detected in this version.
- Functionality and documentation remain unchanged.
v1.0.1
- Added a README.md file with documentation for the maps-osrm skill.
- Updated requirements in SKILL.md to specify that curl and python3 are needed.
- Improved usage examples with more varied city locations.
- Expanded details on routing limits and clarified that no live traffic or public transit data is included.
v1.0.0
Initial release of maps-osrm skill.
- Provides distance, routing (OSRM), and geocoding (Nominatim) using free, no-auth APIs.
- Converts place names to coordinates and calculates distance & travel time for driving, walking, or bicycling.
- Simple bash scripts: geocode.sh for places to coordinates, distance.sh for route info.
- No API keys or authentication required.
- Currently includes example locations for Pune.
- Note: No real-time traffic data; durations are estimates.
Metadata
Frequently Asked Questions
What is OSRM Maps Skill?
Distance, routing, and geocoding using free APIs (OSRM + Nominatim/OSM). Use when the user asks about distance between places, travel time, directions, how f... It is an AI Agent Skill for Claude Code / OpenClaw, with 809 downloads so far.
How do I install OSRM Maps Skill?
Run "/install maps-osrm" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OSRM Maps Skill free?
Yes, OSRM Maps Skill is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OSRM Maps Skill support?
OSRM Maps Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OSRM Maps Skill?
It is built and maintained by Adhish Thite (@adhishthite); the current version is v1.0.3.
More Skills