ip

What This Skill Does

The IP Geolocation skill for OpenClaw is an essential utility built upon the Juhe (聚合数据) V3.0 API. It provides precise geographical and service provider information for any valid IPv4 address. By inputting an IP string, the skill returns a structured data object containing the country, province, city, and ISP (Internet Service Provider) associated with that IP. It acts as a bridge between raw network data and human-readable location intelligence, allowing users to verify traffic sources, troubleshoot connectivity issues, or analyze the origins of network requests directly within the OpenClaw environment.

Installation

To integrate this skill into your environment, use the OpenClaw package manager. Open your terminal and execute: clawhub install openclaw/skills/skills/365bug/ip-new. Once installed, ensure you have the requests Python library available (pip install requests). Critically, the skill requires a valid API key from Juhe. Export this as an environment variable by running export JUHE_API_KEY='your_api_key' on Linux/macOS or $env:JUHE_API_KEY='your_api_key' on Windows PowerShell. Without this key, the skill will remain inactive.

Use Cases

This tool is ideal for network administrators monitoring server logs, security analysts investigating suspicious connection attempts, and developers verifying the accuracy of geo-fencing implementations. Content creators and marketers can also use it to verify the regional distribution of their user base or confirm that regional content restrictions are functioning as intended during QA testing. It is a lightweight, high-performance utility for rapid network diagnostics.

Example Prompts

1. "Check the location and ISP for the IP address 8.8.8.8 using the IP skill."
2. "Analyze this IP: 114.114.114.114 and tell me which province it is registered to."
3. "Where is the traffic coming from? Please query 202.108.22.5."

Tips & Limitations

This skill is specifically designed for IPv4 addresses; it does not currently support IPv6 lookups. Ensure your network has outgoing access to the Juhe API endpoints to avoid request failures. As this relies on a third-party service, verify your API key usage limits and balance frequently to prevent service interruption. For automation workflows, always handle the 'error_code' field in the response to ensure your agent gracefully manages scenarios where the IP might not be found in the database.