kennyzir 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
- Validate IP format (IPv4 and IPv6 supported)
- Detect private/reserved ranges (127.x, 10.x, 192.168.x) — returns immediately
- Query geolocation service with 5s timeout
- 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
- Sign up at claw0x.com
- Create API key in Dashboard
- 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:
{
"ip": "8.8.8.8"
}
Output:
{
"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 is the native skills layer for AI agents.