Agent skills for working with OpenCage geocoding and geosearch services. These skills give any AI coding agent the context it needs to integrate with the OpenCage APIs correctly — including endpoint details, SDK usage patterns, error handling, and common pitfalls.
The skills are plain markdown files that work with any agent that can read documentation. First-class installation is provided for Claude Code via its plugin system.
| Skill | Purpose |
|---|---|
opencage-geocoding-api |
Forward/reverse geocoding via the OpenCage REST API |
opencage-geosearch |
Geographic autosuggest/autocomplete JavaScript widget |
Use when you need forward geocoding (address to coordinates), reverse geocoding (coordinates to address), or help working with geocoding API responses. Covers Python, Node.js, Ruby, PHP, Java, Perl, and command-line usage.
Includes language-specific reference files:
| Reference | Description |
|---|---|
references/api-details.md |
Full API parameter and response reference |
references/python.md |
Python SDK usage |
references/nodejs.md |
Node.js SDK usage |
references/ruby.md |
Ruby SDK usage |
references/php.md |
PHP SDK usage |
references/java.md |
Java SDK usage |
references/perl.md |
Perl SDK usage |
references/commandline.md |
Command-line batch CSV processing |
Use when you need geographic place autosuggest or autocomplete on a web page, or are integrating a location search widget with Leaflet, OpenLayers, or MapLibre.
graph TD
A{User typing partial text in a search box?}
A -- yes --> B[opencage-geosearch\nJS widget / front-end]
A -- no --> C{Need street addresses or coordinates?}
C -- yes --> D[opencage-geocoding-api\nREST API / back-end]
C -- no --> E[Neither skill needed]
See install.md for setup instructions covering Claude Code, Gemini CLI, Codex, and other agents.
- An OpenCage account with the appropriate API key(s):
- Geocoding API key (30 characters) — from opencagedata.com/dashboard
- Geosearch key (
oc_gs_...format) — from opencagedata.com/geosearch — this is a separate key from the geocoding API key
We run a worldwide geocoding API and geosearch service based on open data. Learn more about us.
We also organize Geomob, a series of regular meetups for location-based service creators. If you like geo stuff, check out the Geomob podcast.