A zero-config network intelligence tool for fetching real-time geographic location, ISP details, and proxy status for any IP address.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install china-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 china-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 China IP Lookup?
China IP Lookup is a specialized utility within the Openclaw Skills ecosystem designed for developers and system administrators who need instant network insights. It allows AI agents to query the geographic origin, service provider (ISP), and organizational data of any IPv4, IPv6, or domain name without requiring complex API authentication.
By leveraging reliable public endpoints like ip-api.com and ipinfo.io, this skill provides high-fidelity data including region names, ASN details, and heuristic detection for proxies or VPNs. It is optimized for Chinese network environments, offering localized results while maintaining global compatibility.
China IP Lookup Use Cases
- Identifying the geographic origin and ISP of a specific server or visitor IP.
- Verifying if a domain name resolves to a server located within mainland China.
- Troubleshooting network latency by analyzing ASN and routing information.
- Detecting potential security risks by identifying proxy, VPN, or data center hosting IPs.
- Checking the outbound public IP of the current Openclaw environment.
How China IP Lookup Works
- The user provides an IP address, domain, or a request to check the local machine's public IP.
- The skill validates the input type to determine if it is a valid IPv4, IPv6, or domain name.
- It attempts to fetch detailed metrics from the primary provider (ip-api.com) with localization set to Simplified Chinese.
- If the primary provider fails due to rate limits or network issues, it automatically falls back to the secondary provider (ipinfo.io).
- In cases of total network isolation, it performs a local heuristic check against known IP ranges to provide basic regional classification.
- The data is parsed and presented in a clean, formatted dashboard showing location flags, network types, and security warnings.
China IP Lookup Setup
Ensure that curl is installed on your system. No API keys are required for the standard tier of this skill.
# Check if curl is available
curl --version
# The skill uses the following endpoints internally:
# Primary: http://ip-api.com
# Secondary: https://ipinfo.io
China IP Lookup Data Schema & Taxonomy
The skill organizes IP intelligence into the following structured format:
| Field | Description | Example |
|---|---|---|
country |
Name of the country and emoji flag | China 🇨🇳 |
regionName |
Province, state, or administrative region | Guangdong |
city |
Specific city of origin | Shenzhen |
isp |
Internet Service Provider | China Unicom |
as |
Autonomous System Number and name | AS17816 |
proxy |
Boolean flag for detected proxy/VPN | false |
hosting |
Identification of data center/hosting IPs | false |
China IP Lookup Advanced Features
- Multi-provider failover logic ensures high availability even during API rate-limiting.
- Batch processing support for querying up to 100 IP addresses in a single request via POST.
- Heuristic detection of mobile networks, VPNs, and cloud hosting providers.
- Offline fallback mode for identifying private IP ranges (LAN) and common Chinese network segments.
- Native support for internationalization with a focus on Chinese (zh-CN) data accuracy.
SKILL.md
Loading
Related Openclaw Skills
http-status
An offline reference tool for looking up HTTP status codes with detailed explanations, common causes, and actionable fix suggestions.
Terraform Patterns
An opinionated infrastructure-as-code agent skill for designing, auditing, and managing secure Terraform modules and workflows.
Learning Assistant
An advanced technical learning co-pilot designed to help users master computer science, AI, and software engineering through structured knowledge analysis and personalized study plans.
Simple CSC
A sophisticated, training-free approach to Chinese Spelling Correction (CSC) and Character Error Correction (C2EC) using large language models as pure language models.
Clawhub Publish
A professional release management skill designed to validate, audit, and execute the publication of AI agent capabilities to the ClawHub registry.
WebsitePublisher AI Skill
Build and publish production-ready websites including pages, assets, and dynamic data through simple conversational commands.
Featured*
