4QueriesFree audit
Open Source · PythonFreeMIT · Python ≥3.10 · formerly siteprobe

sitehealth: broken links, redirects and sitemap audit

A free crawler that walks your site, reports broken links and redirect chains, then validates sitemap.xml and hreflang markup, all locally and without paid services. Two jobs, nothing else.

4xx and 5xx

Broken links

Walks internal and external links and collects every dead URL with its status code and the pages where it appears. Even beyond the page cap, every discovered link is still checked.

301 / 302

Redirect chains

Shows multi-step and looping redirects that burn crawl budget and leak link equity.

sitemap and hreflang

Sitemap validation

Discovers sitemap.xml through robots.txt or common paths, walks sitemap indexes, checks every URL status and flags hreflang alternates missing from the sitemap.

Install and run

Two commands

# install from source (not published on PyPI yet)
pip install git+https://github.com/trendbender/sitehealth.git

# broken links and redirect chains
sitehealth crawl https://your-site.com --max-pages 300

# sitemap health (auto-discovers the sitemap)
sitehealth sitemap https://your-site.com

# explicit sitemap + report file
sitehealth sitemap https://your-site.com \
  --sitemap https://your-site.com/sitemap_index.xml --report-file out.txt

Options: crawl has --max-pages (default 500), --depth, --timeout, --report-file; sitemap has --sitemap, --no-check, --timeout, --report-file. Output is a plain-text report on stdout. Note: an unrelated tool named siteprobe exists on PyPI; this one installs from GitHub and runs as sitehealth.

See it in action

The run and the report

Terminal after a sitehealth crawl: pages crawled, links checked, broken links and redirect counts
Output is a plain-text report on stdout: pages crawled, links checked, then broken links and redirect chains counted separately. Copy it into an issue or a client update as is.

Want a technical audit of your site?

We run sitehealth and linkrank on your site, find dead links, redirect chains and sitemap errors, and hand you a fix list.

Get a free 4Queries audit