Skip to content
A streaming parser for sitemap files. Is able to deal with deeply nested sitemaps with 100+ million urls in them.
CoffeeScript JavaScript
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Upgrade dependencies Dec 7, 2017
LICENSE Fix Code Example 2 Nov 11, 2018


A streaming parser for sitemap files. It is able to deal with GBs of deeply nested sitemaps with hundreds of URLs in them. Maximum memory usage is just over 100Mb at any time.


The main method to extract URLs for a site is with the parseSitemaps(urls, url_cb, done) method. You can call it with both a single URL or an Array of URLs. The url_cb is called for every URL that is found. The done callback is passed an error and/or a list of all the sitemaps that were checked.


var sitemaps = require('sitemap-stream-parser');

sitemaps.parseSitemaps('', console.log, function(err, sitemaps) {
    console.log('All done!');


var sitemaps = require('sitemap-stream-parser');

var urls = ['', ''];

all_urls = [];
sitemaps.parseSitemaps(urls, function(url) { all_urls.push(url); }, function(err, sitemaps) {
    console.log('All done!');

Sometimes sites advertise their sitemaps in their robots.txt file. To parse this file to see if that is the case use the method sitemapsInRobots(url, cb). You can easily combine those 2 methods.

var sitemaps = require('sitemap-stream-parser');

sitemaps.sitemapsInRobots('', function(err, urls) {
    if(err || !urls || urls.length == 0)
    sitemaps.parseSitemaps(urls, console.log, function(err, sitemaps) {
You can’t perform that action at this time.