A streamlined utility to retrieve city, region, country, and ISP information for any IP address using the ipinfo.io API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install geo-ip
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 geo-ip 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 Geo IP?
The Geo IP skill is a specialized tool designed to provide instant geographic context for any IP address. As part of the wider ecosystem of Openclaw Skills, it eliminates the need for manual browser-based lookups by delivering precise location data, including coordinates and organization details, directly to your technical environment. It is built for speed and reliability, utilizing the industry-standard ipinfo.io API to ensure high data accuracy.
This skill is particularly valuable for developers who need to verify network configurations or security analysts performing initial triage on incoming traffic. By integrating this functionality into your workspace, you leverage one of the most portable Openclaw Skills available, requiring no heavy dependencies beyond basic system tools like curl.
Geo IP Use Cases
- Mapping the physical location of remote server nodes during infrastructure debugging.
- Identifying the geographic origin of specific IP addresses found in security logs.
- Quickly verifying the public-facing IP address and ISP of the local machine.
- Enhancing technical documentation with precise network location metadata.
How Geo IP Works
- The user inputs a specific IP address or uses the 'me' keyword to trigger a lookup.
- The skill executes a network request using curl to the ipinfo.io public API.
- The API identifies the geographic data points associated with the provided IP.
- The skill receives the JSON response and formats it for clear display, showing city, country, and provider details.
Geo IP Setup
No complex installation is required for this skill. It utilizes the system's native curl binary to communicate with the geolocation API. Ensure your environment has curl installed:
# Verify curl installation
curl --version
# Look up a specific IP
geo-ip 8.8.8.8
# Look up your own IP
geo-ip me
Geo IP Data Schema & Taxonomy
The Geo IP skill processes and displays data in a structured format. The following table describes the primary data fields retrieved during a lookup:
| Attribute | Description |
|---|---|
| IP | The remote or local IP address being queried |
| City | The specific city where the IP is registered |
| Region | The administrative region or state |
| Country | The ISO country code |
| Coordinates | The latitude and longitude of the IP location |
| ISP/Org | The organization or service provider owning the IP block |
Geo IP Advanced Features
- Zero-dependency design ensures it works on any system with curl installed.
- Integration with Openclaw Skills allows for automated geolocation steps in larger AI agent workflows.
- Fast API response times optimized for low-latency network research.
- Simple command syntax allows for easy piping into other command-line tools for data processing.
SKILL.md
Loading
Related Openclaw Skills
File Search
A high-performance utility for finding files by name and searching code content using the power of fd and ripgrep.
Email Send Skill
A lightweight utility for sending emails via SMTP using msmtp without the need for a full mail client.
Docker Ctl
An essential utility for managing and inspecting Podman containers, logs, and images directly from your AI agent.
DNS Lookup
A networking utility that enables AI agents to perform DNS queries and reverse lookups using the industry-standard dig tool.
Git Helper
A specialized AI skill designed to simplify and automate common Git version control operations through optimized command wrappers.
Image OCR
A high-performance OCR tool for extracting text from various image formats using the Tesseract engine.
Featured*
