geoip-mmdb

Add IP-to-location lookups to web applications using MMDB files.

Updated May 13, 2026
One-click install
npx skills add https://github.com/dloschiavo/orca --skill geoip-mmdb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geoip-mmdb
Source: https://github.com/dloschiavo/orca/tree/main/recipe/geoip-mmdb
Command: npx skills add https://github.com/dloschiavo/orca --skill geoip-mmdb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires maxmind, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the addition of IP-to-location lookups to web applications, providing a streamlined solution for developers.

Core Features & Use Cases

  • IP-to-Location Lookups: Perform real-time IP-based geolocation lookups to retrieve city, region, country, and latitude/longitude information.
  • Pluggable Backend: Choose between local disk and Google Cloud Storage (GCS) backends for storing MMDB files, with automatic selection based on environment variables.
  • Lazy Singleton Load: Efficiently loads the MMDB into memory for quick lookups, with hot-reloading on file updates.
  • Admin Spoof Cookie: Allows administrators to override their resolved location for testing purposes.

Quick Start

Use the geoip-mmdb skill to perform an IP-to-location lookup for the IP address '192.168.1.1'.

Frequently Asked Questions about geoip-mmdb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate IP-to-location lookups into my web application?

You can integrate IP-to-location lookups by utilizing the maxmind package to handle binary MMDB files. This approach provides real-time geolocation data, retrieving city, region, country, and latitude/longitude coordinates for your application users.

Can I store and load MMDB files from Google Cloud Storage?

Yes, you can store MMDB files on Google Cloud Storage. The system features a pluggable backend that automatically selects between local disk and GCS storage based on your environment variables.

Does maxmind support hot-reloading of MMDB files?

The system supports hot-reloading of MMDB files by using a lazy singleton load pattern. This efficiently loads the file into memory for quick lookups and automatically updates when the file changes.

How do I test geolocation features in an admin interface?

You can test geolocation data in an admin interface by using a spoof cookie. This allows administrators to override their resolved location for testing and data visualization purposes.

What is the best way to retrieve city and region data from an IP address?

The best way to retrieve city and region data is by performing real-time IP-based geolocation lookups against a binary MMDB file. This provides accurate geographical coordinates mapped directly from the user's IP address.