geofeed-tuner

Validate and improve RFC 8805 self-published IP geolocation feeds in CSV format.

1|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/ultraviollettnympho/transit-ticket --skill geofeed-tuner-ultraviollettnympho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geofeed-tuner
Source: https://github.com/ultraviollettnympho/transit-ticket/tree/main/.github/skills/geofeed-tuner
Command: npx skills add https://github.com/ultraviollettnympho/transit-ticket --skill geofeed-tuner-ultraviollettnympho

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Network operators publishing IP geolocation feeds often produce CSV files with invalid country codes, malformed region codes, deprecated postal codes, or non-public IP ranges, causing geolocation providers to ignore or misinterpret their data. ## Core Features & Use Cases - RFC 8805 Validation: Checks CSV structure, IP prefix syntax, ISO 3166-1 country codes, ISO 3166-2 region codes, and deprecated postal code fields against the standard. - Opinionated Tuning Suggestions: Flags overly large prefixes, missing region codes, small-territory redundancies, and do-not-geolocate entries beyond baseline RFC compliance. - HTML Tuning Reports: Generates a structured report summarizing errors, warnings, suggestions, and accuracy-level statistics, enriched with tuning data from Fastah's MCP lookup tool. - Use Case: An ISP engineer pastes a geofeed CSV or provides its public URL, and receives a full validation report listing every invalid prefix, mismatched region, and actionable improvement. ## Quick Start Ask the assistant to validate and tune your IP geolocation feed by providing a local CSV file or a public feed URL.

Frequently Asked Questions about geofeed-tuner

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

FAQPage Schema
How do I validate an RFC 8805 geofeed CSV file?

Provide the feed as pasted text, a local CSV file, or a public URL. The skill parses each entry, checks IP prefix syntax, country codes, region codes, and city names, then produces a report of errors, warnings, and suggestions.

What is an RFC 8805 self-published IP geolocation feed?

It is a CSV file published by a network operator mapping IP prefixes to coarse location data: country code, region, and city. Geolocation providers like Google consume these feeds to correct IP location data.

Does the geofeed validator work with private IP addresses?

No, it applies only to publicly routable IP addresses. Private, loopback, link-local, and multicast ranges are flagged as errors because RFC 8805 feeds must not contain non-public address space.

Why are postal codes rejected in geofeed CSV files?

RFC 8805 Section 2.1.1.5 deprecates postal codes because they are too fine-grained for IP-range mapping and raise privacy concerns. Any non-empty postal code field is reported as an error that must be removed.

What happens if the tuning data lookup service is unavailable?

If the Fastah MCP server is unreachable or returns errors, the skill logs a warning and continues. The report is still generated with validation results only, and affected entries receive an empty TunedEntry object.