Get the FREE Ultimate OpenClaw Setup Guide →
X

Geo Ip

Verified

@Xejrax

npx machina-cli add skill @Xejrax/geo-ip --openclaw
Files (1)
SKILL.md
624 B

Geo IP

Look up the geographic location for any IP address using the ipinfo.io API. Returns city, region, country, coordinates, and ISP information.

Commands

# Look up location for a specific IP address
geo-ip <ip-address>

# Look up your own public IP location
geo-ip me

Install

No installation needed. curl is always present on the system. Uses the public ipinfo.io API.

Source

git clone https://clawhub.ai/Xejrax/geo-ipView on GitHub

Overview

Geo IP looks up the geographic location for any IP address using the ipinfo.io API. It returns city, region, country, coordinates, and ISP information to help you contextualize traffic or customize experiences.

How This Skill Works

The tool runs geo-ip <ip-address> or geo-ip me, issuing a curl request to ipinfo.io. The API response provides location fields (city, region, country, coordinates) and ISP details, with no installation required beyond curl.

When to Use It

  • Personalize content or features based on a visitor's geographic location.
  • Analyze traffic patterns by country, region, or city for marketing or product decisions.
  • Support security or fraud checks by verifying IP origins.
  • Troubleshoot geo-related issues by confirming the reported location.
  • Verify user location during account creation or compliance checks.

Quick Start

  1. Step 1: Run geo-ip <ip-address> or geo-ip me.
  2. Step 2: Read the response for city, region, country, coordinates, and ISP.
  3. Step 3: Use the location data to tailor content, routing, or analytics.

Best Practices

  • Validate and sanitize incoming IPs before querying to avoid errors.
  • Cache ipinfo responses for repeated lookups to reduce API calls and latency.
  • Use geo-ip me to quickly test from your own IP when debugging.
  • Be mindful of privacy and regulatory considerations when using location data.
  • Cross-check critical decisions with multiple geolocation sources if precision matters.

Example Use Cases

  • A streaming service personalizes content recommendations based on a viewer's country and city.
  • An e-commerce site displays currency and shipping options according to the visitor's region.
  • A security dashboard flags logins from unusual locations for further verification.
  • A marketing analytics dashboard shows geographic distribution of users to plan campaigns.
  • Support teams verify user locale to triage regional outage or access issues.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers