zipbox-geo

Geocode addresses, find nearby places, and compute routes via the Geoapify API.

1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/tribes-protocol/trading-harness --skill zipbox-geo-tribes-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zipbox-geo
Source: https://github.com/tribes-protocol/trading-harness/tree/main/skills/zipbox-geo
Command: npx skills add https://github.com/tribes-protocol/trading-harness --skill zipbox-geo-tribes-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering location questions — where an address is, what restaurants are nearby, how long a drive takes — normally requires signing up for a mapping provider, managing API keys, and learning a large API surface. This Skill gives the agent a ready-made, cost-aware wrapper around the Geoapify API so any location question can be answered with a single curl call, with no key management. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert addresses to coordinates and coordinates back to formatted addresses, plus autocomplete, postcode, and IP lookup. - Places Search: Find nearby restaurants, hotels, hospitals, and other POIs by category within a radius, using OpenStreetMap data. - Routing & Analysis: Compute A-to-B routes, isolines (reachability areas), route matrices, elevation, boundaries, and static map images, with explicit per-call pricing so expensive endpoints are avoided unless requested. - Use Case: A user asks "find coffee shops within 800 meters of 1 Market Street, San Francisco and tell me the walking time to the closest one." The agent geocodes the address, queries the places API with a circle filter, then runs a walking route to the top result. ## Quick Start Use the zipbox-geo skill to geocode "1 Market Street, San Francisco" and list the ten nearest restaurants within 800 meters.

Frequently Asked Questions about zipbox-geo

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

FAQPage Schema
How do I geocode an address to latitude and longitude?▼

Call the Geoapify endpoint v1/geocode/search with the address in the text parameter and format=json. Read results[0].lat, results[0].lon, and results[0].formatted from the JSON response.

How do I find restaurants near a location with an API?▼

Query v2/places with categories=catering.restaurant and a circle filter like filter=circle:lon,lat,radiusMeters around your coordinates. Add a proximity bias and set limit to 20 or fewer to control cost.

Does the Geoapify places search include ratings or opening hours?▼

No. Places data comes from OpenStreetMap, which is good for finding restaurants and POIs near a point but does not provide Google-style ratings or guaranteed open-now status.

Why did my Geoapify request return a 403 or 401 error?▼

A 403 means the request did not carry the platform-injected placeholder key, and a 401 means the placeholder was replaced or mangled. Re-source /run/zipbox/placeholders.env and send the placeholder exactly once in the apiKey parameter.

When should I avoid the route planner and map tile endpoints?▼

The route planner costs $0.25 per call and is only for multi-stop vehicle routing; use v1/routing for simple A-to-B trips. Map tiles cost $0.001 each, so never loop over z/x/y tile grids — request a single static map image instead.