Skip to content

Audit Report

The HTML audit report is SiteOne Crawler’s flagship output — the single deliverable that turns a crawl into something you can act on. Every audit ends with an interactive, self-contained HTML report and an automatic 0–10 quality score across Performance, SEO, Security, Accessibility & Best Practices — plus a “Fix first” panel that ranks the highest-impact issues and gives you actionable remediation hints, so you know exactly where to start.

It is the same kind of audit competitors charge for — only it is free, open source, and produced by one command.

Don’t take our word for it — open a real report. These are full audits of well-known production sites, hosted on unique, unguessable URLs:

Each report opens on a Summary tab with the overall quality score, the per-category scores, and the Fix first list — then lets you drill into sortable tables for every page, asset, redirect and finding.

The report is a single .html file you can open in any browser, e-mail to a colleague, or share via a private link. Inside you get:

  • A 0–10 quality score — a weighted average across five categories (Security 25%, Performance 20%, SEO 20%, Accessibility 20%, Best Practices 15%), with a color-coded label from Critical to Excellent.
  • A “Fix first” panel — the highest-impact problems ranked by severity and impact, each with a concrete remediation hint, so you can prioritize instead of guessing.
  • Per-category drill-downs — sortable, filterable tables for SEO & OpenGraph, performance, accessibility, security, headers, redirects, 404s, content types, caching and more.
  • Findings color-highlighted by severity — criticals, warnings and notices are easy to scan at a glance.
  • Optional AI insights — an executive summary and prioritized recommendations at the top of the Summary tab when you enable the AI assistant.

Install once, then point the crawler at any URL — the full HTML report and 0–10 score are produced automatically:

Terminal window
# macOS / Linux (Homebrew)
brew install janreges/tap/siteone-crawler
# Audit any site — full HTML report + 0-10 quality score in one command
siteone-crawler --url=https://your-site.com

No account, no dependencies — one native binary. The HTML report path is printed at the end of the run; add --upload to share it via a private link. Not sure where to start? Run siteone-crawler with no arguments for an interactive wizard.

The 0–10 score is the headline, but the report is backed by a full suite of built-in analyzers. Each has its own deep-dive page:

Prefer a guided tour? This short video walks through the report, the quality score and the Fix first panel:

You don’t have to wait for the report. As soon as the crawl starts — in both the CLI and desktop versions — a clear, color-highlighted console output is displayed in real time, structured and formatted to your terminal width:


SiteOne Crawler running a website audit in the command line, with color-highlighted findings and a live progress table

The report path is printed at the end of every run. By default it is saved to tmp/%domain%.report.%datetime%.html, and you can change it with --output-html-report (set it to an empty value to disable the HTML report entirely). In the desktop application you can open the finished report with a button.

To share a report without sending a file, the crawler can upload it to a unique, unguessable URL. Add --upload, and optionally set the --upload-retention (from 1h to forever), protect it with --upload-password, or send it to --upload-to your own endpoint.

For the full upload workflow, retention details and self-hosting, see the dedicated online HTML report upload page.

Generate your own report in one command →

Section titled “Generate your own report in one command →”

Ready to audit your site? The Quick Start Guide gets you from install to your first HTML report and 0–10 quality score in under a minute.


If you have ideas on how to improve the audit report or continuous display of the result, don’t be afraid to send a feature request (to desktop application, or to command-line interface) with a suggestion for improvement. We are happy to consider and implement it if it will benefit more users.