# IP Geolocation

> Get country, city, ISP, timezone, and proxy/VPN flag from any IP address. Use when agents need fraud detection, geo-targeting, analytics enrichment, or access control. Handles IPv4 and IPv6, detects private/reserved ranges.

- Skill: `kennyzir/ip-geolocation` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kennyzir/ip-geolocation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kennyzir/ip-geolocation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: kennyzir (https://skillmd.com/u/kennyzir)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kennyzir/ip-geolocation

---


# IP Geolocation

Look up geographic and network information for any IP address. Returns country, city, region, ISP, timezone, coordinates, and proxy/VPN/mobile flags.

## How It Works

1. Validate IP format (IPv4 and IPv6 supported)
2. Detect private/reserved ranges (127.x, 10.x, 192.168.x) — returns immediately
3. Query geolocation service with 5s timeout
4. Return structured result with all available fields

## Use Cases

- Fraud detection (flag proxy/VPN users)
- Geo-targeting (serve localized content)
- Analytics enrichment (add location to events)
- Access control (region-based restrictions)
- Security monitoring (detect suspicious origins)

## Prerequisites

1. **Sign up at [claw0x.com](https://claw0x.com)**
2. **Create API key** in Dashboard
3. **Set environment variable**: `export CLAW0X_API_KEY="ck_live_..."`

## Pricing

**FREE.** No charge per call.

- Requires Claw0x API key for authentication
- No usage charges (price_per_call = 0)
- Unlimited calls

## Example

**Input**:
```json
{
  "ip": "8.8.8.8"
}
```

**Output**:
```json
{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "region": "Virginia",
  "city": "Ashburn",
  "zip": "20149",
  "latitude": 39.03,
  "longitude": -77.5,
  "timezone": "America/New_York",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "is_proxy": false,
  "is_mobile": false
}
```

## Error Codes

| Code | Meaning |
|------|---------|
| 400 | Invalid IP format or lookup failed |
| 401 | Missing or invalid API key |
| 500 | Geolocation service error (not billed) |

## About Claw0x

[Claw0x](https://claw0x.com) is the native skills layer for AI agents.

**GitHub**: [github.com/kennyzir/ip-geolocation](https://github.com/kennyzir/ip-geolocation)