A precision toolkit for converting addresses to coordinates, performing reverse lookups, and calculating global distances.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install geocode-lookup
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install geocode-lookup using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is geocode-lookup?
The geocode-lookup skill is a specialized utility designed to provide AI agents with robust geographic capabilities. By integrating this tool, developers can empower their agents to perform forward geocoding to resolve human-readable addresses into precise latitude and longitude coordinates, or utilize reverse geocoding to identify locations based on raw GPS data. This tool is a core component of the Openclaw Skills ecosystem, enabling context-aware applications that understand physical space.
Built for high performance and privacy, the skill supports Haversine distance calculations between two points, whether they are defined by address strings or specific coordinates. It serves as a lightweight, API-driven solution for workflows requiring spatial awareness, such as logistics, local search, or proximity filtering, without the overhead of heavy GIS platforms.
geocode-lookup Use Cases
- Converting user-provided shipping addresses into GPS coordinates for logistics and mapping applications.
- Identifying city or neighborhood names from raw mobile device location data for personalized experiences.
- Calculating travel distances between global landmarks to estimate transit costs or flight times.
- Enhancing search queries by filtering results based on proximity to a specific point of interest or user location.
How geocode-lookup Works
- The AI agent receives a location-based request, such as an address string or a pair of coordinates.
- The skill sends a POST request to the relevant endpoint at geocode.agentutil.net within the Openclaw Skills framework.
- The API processes the request using optimized geospatial datasets and Haversine formulas for distance math.
- A structured JSON response is returned, containing normalized display names, coordinates, and metadata.
- The AI agent interprets the response to complete the user task, such as plotting a point or calculating a delivery fee.
geocode-lookup Setup
Integrating geocode-lookup into your Openclaw Skills workflow is straightforward. No API key is required for the free tier, which allows up to 10 queries per day.
To perform a forward geocode lookup via the CLI:
curl -X POST https://geocode.agentutil.net/v1/forward \
-H "Content-Type: application/json" \
-d '{"address": "Auckland, New Zealand"}'
For high-volume production needs, the skill supports the x402 protocol, allowing for pay-per-query access using USDC on the Base network.
geocode-lookup Data Schema & Taxonomy
The skill returns data in a consistent JSON format to ensure seamless integration across different Openclaw Skills implementations.
| Field | Type | Description |
|---|---|---|
| results | Array | List of location objects containing lat, lon, and display_name |
| request_id | String | Unique identifier for the specific API transaction |
| service | String | The endpoint URL providing the geospatial data |
Each result object includes:
- lat: Floating point latitude
- lon: Floating point longitude
- display_name: The formatted, human-readable address string
- type: The classification of the location (e.g., city, house)
geocode-lookup Advanced Features
- Multi-unit distance support: Calculate gaps between points in kilometers, miles, meters, or nautical miles.
- Hybrid input flexibility: The distance endpoint accepts any combination of raw coordinates or address strings.
- Frictionless scaling: Native support for x402 micropayments on the Base network for enterprise-grade throughput.
- Candidate limiting: Define the number of results (1-5) returned for ambiguous address lookups to optimize agent processing.
SKILL.md
Loading
Related Openclaw Skills
Data Validate
A comprehensive validation tool for AI agents to verify URL, JSON schema, email, and phone number formatting.
verify-claim
A real-time fact-checking skill that validates claims against live data sources with structured verdicts and confidence scores.
unit-convert
A comprehensive conversion utility for real-time currency exchange, physical unit transformations, and data encoding.
1-SEC Security Platform
An open-source, single-binary cybersecurity platform offering 16 specialized modules to protect Linux servers and AI agent hosts.
hash-generate
A comprehensive cryptographic utility for generating hashes, HMACs, UUIDs, and identifying unknown hash algorithms via a secure API.
dns-lookup
Perform DNS lookups, reverse DNS, WHOIS queries, and IP geolocation directly through an AI agent.
Featured*
