A high-performance IPv4 geolocation lookup tool powered by Juhe Data for automated IP intelligence.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ip-new
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 ip-new 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 IP Geolocation?
The IP Geolocation skill provides a robust interface for querying detailed geographic information associated with IPv4 addresses. By integrating the Juhe Data V3.0 API, this skill allows users and automated agents to retrieve specific metadata such as country, province, city, and Internet Service Provider (ISP). As part of the Openclaw Skills library, it is designed for developers who need reliable, programmatic access to location intelligence within their AI-driven environments.
IP Geolocation Use Cases
- Identifying the geographic origin of server logs or network traffic.
- Automating security audits by flagging suspicious IP login locations.
- Personalizing user experiences in web applications based on regional data.
- Enriching data analytics pipelines with service provider and city-level information.
How IP Geolocation Works
- The AI agent or user passes a valid IPv4 address as a command-line argument to the script.
- The skill verifies the JUHE_API_KEY environment variable to ensure authorized access.
- A request is dispatched to the Juhe Data V3.0 geolocation endpoint.
- The raw API response is processed and normalized into a structured format.
- The resulting JSON object is returned, allowing Openclaw Skills to utilize the data for further processing.
IP Geolocation Setup
To use this skill, ensure you have Python 3 installed and follow these steps:
# Install the required dependency
pip install requests
# Configure your API key (Linux/macOS)
export JUHE_API_KEY="your_juhe_api_key_here"
# Configure your API key (Windows PowerShell)
$env:JUHE_API_KEY="your_juhe_api_key_here"
# Execute a lookup
python3 skills/ip/ip.py 114.114.114.114
IP Geolocation Data Schema & Taxonomy
The skill returns a structured JSON object containing the following fields:
| Field | Type | Description |
|---|---|---|
error_code |
integer | Success indicator (0 for success) |
reason |
string | Description of the response status |
result.ip |
string | The queried IPv4 address |
result.country |
string | Country of origin |
result.province |
string | Province or state |
result.city |
string | City name |
result.sp |
string | Internet Service Provider (e.g., China Unicom) |
IP Geolocation Advanced Features
- Direct integration with the Openclaw Skills ecosystem for seamless multi-agent task execution.
- Normalized data output optimized for Large Language Model (LLM) consumption.
- Minimal dependency footprint using only the requests library for high portability.
- Support for real-time ISP identification to assist in network routing analysis.
SKILL.md
Loading
Related Openclaw Skills
Ekalavya Self Improvement
A specialized behavioral protocol that forces AI agents to prioritize shipping code and maintaining execution momentum over conversational chatter.
Tencent Cloud Smart Advisor Assistant
An AI-powered assistant for managing Tencent Cloud architectures, performing Well-Architected assessments, and generating secure console access links.
China Relocation Guide
A specialized relocation intelligence skill designed to help expats, digital nomads, and professionals navigate the complexities of moving to and living in China.
Edge-TTS
A high-quality neural text-to-speech engine that converts text into natural-sounding audio using Microsoft Edge's TTS service.
Li CodeQL LLM Security Scanner
A professional security automation skill that integrates CodeQL static analysis with LLM intelligence to detect, analyze, and prioritize code vulnerabilities.
Nonprofit Grant Outline Generator
A specialized AI tool for generating structured nonprofit grant proposal outlines that align project goals with budgets and impact metrics.
Featured*
