node package manager
Easy collaboration. Discover, share, and reuse code in your team. Create a free org »



npm install rir-parser    


  • What it is: A Node.js parser for RIR Statistics Files (IP address assignment by country, published daily by each Regional Internet Registry)
  • Why to use it: This module can be part of a geo-IP system that maps IP addresses to the country in which they are located.
  • Why not to use it: This is a low-level module that does not include geo-IP functionality. It’s an important building block for a geo-IP module, but does not itself provide that functionality (the author intends to publish such a module).

More information

Five Regional Internet Registries (AfriNIC, APNIC, ARIN, LACNIC and RIPENCC), control the assignment of IP addresses worldwide.

These RIRs publish lists (called RIR statistics) showing which addresses have been assigned, and to which country they are assigned. These lists can be obtained from several locations, including the Number Resource Organization and via FTP from ARIN and RIPE.

This module parses those lists, consolidating adjacent IPv4 ranges and returning a minimal list of IP ranges (both IPv4 and IPv6) and the country to which the range is assigned.


This module exposes one class, RirParser, which is a Node.js Transform stream.

To use it, create an instance of RirParser and pipe the list to it. The RirParser will output a series of JavaScript objects of the form:

{range: …, kind: ['ipv4'|'ipv6'], country: [two-letter country code]}


var RirParser = require('rir-parser');
var parser = new RirParser();
parser.on('readable', function() {
  var ipRange;
  do {
    ipRange =;
    if (ipRange) { console.log(ipRange); }
  } while (ipRange);