Skip to content
PN Scripts

Developer tools

Mapwarden

A command-line sitemap auditor that requests every URL in your XML sitemaps and lists the ones search engines will trip over: errors, redirects, noindex pages, wrong canonicals and broken hreflang pairs.

  • Go
  • XML sitemaps
  • robots.txt (RFC 9309)
  • Coming soon

Coming soon

Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.

Terminal table listing 22 sitemap URLs with their status and issue codes

What it solves

The gap

Sitemaps go stale quietly: pages get redirected, removed or set to noindex, canonicals point elsewhere and hreflang pairs lose their return links, and search consoles report it weeks later, one sample at a time.

What it is

Mapwarden checks every URL in the sitemaps in one run, explains each problem with a code and a message, and returns an exit code a deployment pipeline can act on.

How you use it

Find every broken, redirected or contradictory sitemap entry before a search engine does, with a report you can diff, filter and open in a spreadsheet.

For developers and technical SEO people who maintain multilingual or fast-changing sites, Mapwarden is an offline, scriptable sitemap audit that respects robots.txt and fits into CI.

Who it is for

Use it when

  • Checking a sitemap after a migration or URL restructuring
  • Verifying hreflang pairs on a multilingual site before release
  • Failing a deployment pipeline when the sitemap lists errors or noindex pages

Built for

  • Web developers and DevOps engineers
  • Technical SEO specialists and agencies

What is inside

One run, every URL

Point Mapwarden at a site root and it finds the sitemaps through robots.txt, follows indexes and gzip files, removes duplicates and checks each URL. A summary groups the findings by code, so the biggest problem is the first line you read.

The checks

HTTP errors and failed requests, redirects, chains of more than one hop and loops, noindex in meta robots or the X-Robots-Tag header, canonical links that point elsewhere or conflict, missing, short or long titles, URLs blocked by robots.txt, duplicates and URLs on other hosts.

Hreflang that really pairs up

Every alternate is resolved and compared against the other audited pages. Missing return links, invalid codes such as en-UK, duplicate languages, alternates that redirect or fail and sets without a self-reference are reported on the page that has the problem.

Polite and scriptable

robots.txt rules and Crawl-delay are obeyed, with 4 parallel requests and 2 requests per second per host by default. JSON and CSV reports, the -only filter and -fail-on exit codes make it easy to run in CI or on a schedule.

Specs

Availability
Coming soon
Vendor
PN Scripts
Type
Software
Platforms
Go
Pricing
One-time purchase Price to be announced.
License
Proprietary
Deployment
Download (prebuilt binaries for Linux, macOS and Windows, plus Go source)
Maturity
v1.0.0

Compatibility

Platform or runtime Supported versions Tested up to
Linux amd64 (binary run) kernel 3.2 or newer Ubuntu 24.04, kernel 6.8
Go (to build from source) 1.22 or newer 1.26.0

Stack

  • Go
  • XML sitemaps
  • robots.txt (RFC 9309)

Mapwarden is coming soon

It is finished and tested. It is not on sale yet; this page will say where to get it when it is.

Coming soon

Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.

Questions

A command-line tool that audits every URL listed in a website's XML sitemaps for status, redirects, canonical, noindex, hreflang and title problems, and reports them as a table, JSON or CSV.

The binary for your platform (Linux, macOS or Windows, amd64 or arm64) and network access to the site you audit. To build from source you need Go 1.22 or newer.

It does not render JavaScript, read hreflang from sitemap xhtml:link entries or HTTP Link headers, or crawl links to find pages missing from the sitemap. It does not fix the site. Only the Linux amd64 binary was run during testing.

It is written in Go with no third-party modules, with its own robots.txt, sitemap and HTML head parsers, and tested against local test servers that simulate redirects, errors, noindex pages, gzip sitemaps and hreflang mistakes. Created with AI assistance; the parsers, audit rules and CLI were checked by PN Scripts with an automated Go test suite that uses local test servers only, and by running the Linux binary against the bundled demo site.

It is not on sale yet. When it is, this page will link to the store; PN Scripts does not take payment on this site.