IP Geolocation Skill for Openclaw

A specialized tool for resolving IP addresses and domains into detailed geographic and network provider information.

marc-chen
v0.1.3
Mar 11, 2026
0
1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install ip-geo-location-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install ip-geo-location-skill 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 Skill?

This skill enables AI agents to perform real-time geolocation lookups for IPv4 and IPv6 addresses. By integrating with the mcp-geoip-server, it provides accurate data on countries, cities, and Autonomous System Numbers (ASN). This is an essential component for Openclaw Skills users who need to analyze network traffic or identify user locations.

The skill handles both direct IP queries and domain-to-IP resolution, ensuring comprehensive coverage for various network-related tasks. It prioritizes security by blocking private IP ranges and using encrypted transport for all data requests. Whether used for single lookups or batch processing, it provides structured and actionable intelligence for network administrators and developers alike.

IP Geolocation Skill Use Cases

  • Identifying the physical location of a specific IPv4 or IPv6 address.
  • Performing batch lookups for multiple IP addresses simultaneously to compare regional routing.
  • Resolving website domains to their underlying hosting locations and server IPs.
  • Investigating network provider information and ASN details for security auditing and traffic analysis.

How IP Geolocation Skill Works

  1. The agent extracts IP addresses or domains from the user's natural language input.
  2. If a domain is provided, a resolution script converts it into valid A or AAAA IP records.
  3. The tool validates the IP format and ensures it is not a private or reserved address (e.g., 127.0.0.1).
  4. A request is sent to the remote mcp-geoip-server using secure HTTPS transport.
  5. The geolocation and ASN data are retrieved and mapped to a structured JSON schema.
  6. Results are presented to the user in a clear Markdown table for easy readability.

IP Geolocation Skill Setup

To integrate this with Openclaw Skills, configure your workspace or user MCP settings (e.g., .vscode/mcp.json):

{
  "servers": {
    "mcp-geoip-server": {
      "type": "http",
      "url": "https://ip.api4claw.com/mcp"
    }
  }
}

Ensure that node is installed on your system to support the internal resolution and invocation scripts used by this skill.

IP Geolocation Skill Data Schema & Taxonomy

The skill returns structured geographic data as follows:

Field Type Description
ip string The queried IPv4 or IPv6 address
country string Full name of the country
country_code string ISO country code (e.g., US, CN)
province string State, province, or region
city string City name
asn number Autonomous System Number
asn_org string Organization name associated with the ASN

IP Geolocation Skill Advanced Features

  • Intelligent Domain-to-IP workflow that handles complex DNS resolution automatically.
  • Privacy protection filters that locally block private and reserved IP ranges from being sent to external servers.
  • Multi-IP batch processing which aggregates results into a single comparison table.
  • Automated session management that re-initializes MCP connections if a session timeout occurs.
  • Support for both IPv4 and IPv6 networking standards.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*