Skip to content
toringePublic

About

Country lookup service - get AS-numbers and prefixes for a given country

Resources

Security policy

Stars

28 stars

Watchers

4 watching

Forks

Latest commit

 

History

114 Commits

Folders and files

Repository files navigation

CC2ASN

A lookup service for AS-numbers and prefixes belonging to any given country in the world. Simply provide country codes as input and you'll get all ASNs, IPv4 or IPv6 addresses registered to that country. For more detailed information check out the website at www.cc2asn.com.

This repository holds the newest state of the project: the pipeline runs on an AWS Lambda python3.14 runtime, and the data is additionally served by a new web API (Lambda Web Adapter + Function URL) with whois-compatible semantics, free latest-day lookups only (max 100 queries per user per day). For the legacy server-based version, see legacy/README.md; the old TCP whois server keeps running until the web API fully replaces it (the whois-to-API bridge plan lives in docs/2026-10-29-cc2asn-api-design.md).

Repo layout

Directory Content
lambda/ The production pipeline: downloader, parser, curator (one file per function) + Makefile for build/deploy
api/ The web API: a Python HTTP server behind aws-lambda-web-adapter, Function URL front door, DynamoDB daily rate limits, query logs
legacy/ The original server-based implementation (TCP whois, Python 2)
example-s3/ Local-only mirror of the production buckets for testing (gitignored)
docs/ Design docs and plans (api design, parked platform evaluation)
misc/ Architecture diagrams

Pipeline

Event-driven, one file per function (see lambda/README.md for build/deploy):

  1. downloader — fetches a RIR delegation file, verifies MD5, stores it in S3
  2. parser — S3-triggered; parses the RIR SEF format into per-country JSON
  3. curator — writes per-country files (<CC>_<TYPE>, <CC>_ALL) to the delivery bucket under latest/ and yyyy/mm/dd/

Web API

GET /{CC} and GET /{TYPE}/{CC} serve the latest day of curated data, free, limited to 100 queries per user/device per day. Historic lookups are not offered (the historic data stays in S3; a paid historic tier was designed and parked, see docs/superpowers/). A dedicated query log in legacy whois format keeps the same usage record the old server produced. See api/README.md for endpoints, rate limits and deployment, and docs/2026-10-29-cc2asn-api-design.md for the design and cost model (everything sized to stay in the AWS free tiers).

Architecture

Architecture Diagram Architecture Diagram

About

Country lookup service - get AS-numbers and prefixes for a given country

Resources

Security policy

Stars

28 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages