ipinfo

What This Skill Does

The ipinfo skill provides a streamlined interface for interacting with the ipinfo.io API, allowing OpenClaw to perform accurate IP geolocation lookups. By inputting an IP address, the agent can retrieve detailed geographical metadata including city, region, country, postal code, timezone, and precise GPS coordinates (latitude and longitude). Beyond simple location, it returns organization and ASN data, which is critical for network analysis and security profiling. The skill functions seamlessly out of the box with the free tier and can be upgraded by providing an optional API token to accommodate higher request volumes, making it suitable for both casual scripts and professional data-enrichment pipelines.

Installation

To integrate this skill into your environment, use the OpenClaw CLI tool. Run the following command in your terminal: clawhub install openclaw/skills/skills/tiagom101/ipinfo. Once installed, you can optionally configure an API token by navigating to the OpenClaw dashboard or by setting the IPINFO_TOKEN environment variable on your host machine. No further setup is required for basic functionality.

Use Cases

• Security Analysis: Identify the source region of suspicious traffic or unauthorized access attempts.
• Data Enrichment: Populate datasets with geographic context to perform spatial analysis or map out user demographics.
• Operational Logic: Tailor system responses or regional content delivery based on the detected timezone or country of the user's connection.
• Network Auditing: Verify the organization or ISP associated with specific IP addresses to detect potential proxy or VPN usage.

Example Prompts

1. "Look up the location details for 8.8.8.8 and tell me which timezone it operates in."
2. "I have a list of IPs: 1.1.1.1 and 208.67.222.222. Please provide the city and country for each one."
3. "Where is the IP 104.21.55.22 located, and can you provide the latitude and longitude for my map script?"

Tips & Limitations

The free tier is generous (50k requests per month) but imposes a rate limit of approximately 1 request per second. For high-throughput applications, you must obtain an API token from ipinfo.io. Always handle potential API errors, such as rate limits or invalid IP formats, within your agent workflows. Note that while geolocation is generally accurate, it is based on ISP records and may not represent the physical location of the user with 100% precision.