report

The report command lets you view and query audit reports from the local database.

Usage

squirrel report [id] [options]

Arguments

Argument	Description
id	Audit ID (UUID) or domain name (optional, defaults to latest)

Options

Option	Alias	Description	Default
--list	-l	List recent audits	false
--format	-f	Output format: console, text, json, html, markdown, xml, llm	console
--output	-o	Output file path	auto
--input	-i	Load from JSON file (fallback mode)	-
--severity		Filter by severity: error, warning, all	all
--category		Filter by categories (comma-separated)	all
--diff		Compare current report against baseline (audit ID or domain)	-
--regression-since		Compare against baseline and show regressions	-
--allow-cross-site		Allow diff across different base URLs	false
--publish	-p	Publish report to reports.squirrelscan.com	false
--visibility		Visibility: public, unlisted, private	public
--summary		Print only the score, category breakdown, and issue counts — no per-issue detail. Console format only	false

Publishing

Share reports online by publishing to reports.squirrelscan.com.

Visibility Levels

Level	Description
public	Listed and searchable (default)
unlisted	Accessible via link only, not listed
private	Only visible to you when logged in

Publish Report

squirrel report --publish

On success the command prints the published report URL (and nothing else, so it pipes cleanly):

https://reports.squirrelscan.com/XVv4NO7aPr

Manage published reports in the dashboard.

Publish with Visibility

squirrel report --publish --visibility unlisted

Publish Specific Audit

squirrel report a7b3c2d1 --publish --visibility private

Examples

View Latest Audit

squirrel report

List All Audits

squirrel report --list

Output:

Recent Audits:
================================================================================
ID                                     Date                   Pages    Status
--------------------------------------------------------------------------------
a7b3c2d1                              1/17/2026, 10:30 AM    42       complete
  https://example.com
5e9f1a3b                              1/16/2026, 3:45 PM     38       complete
  https://test.com

Total: 2 audits

View Specific Audit by ID

squirrel report a7b3c2d1

View Latest Audit for Domain

squirrel report example.com

or with full URL:

squirrel report https://example.com

Export as JSON

squirrel report -f json -o report.json

Export as HTML

squirrel report -f html -o report.html
open report.html

Export as Markdown

squirrel report -f markdown -o report.md

Filter by Severity

Show only errors:

squirrel report --severity error

Show only warnings:

squirrel report --severity warning

Filter by Category

Show only core SEO issues:

squirrel report --category core

Show multiple categories:

squirrel report --category core,links,images

Diff Reports

Compare the latest report against a baseline audit:

squirrel report --diff a7b3c2d1 --format json

Compare the latest report for a domain against a baseline audit:

squirrel report --regression-since example.com --format llm

LLM-Optimized Format

Export in format optimized for LLM consumption:

squirrel report -f llm -o report.txt

Or pipe directly to Claude:

squirrel report -f llm | claude "analyze this SEO report"

Output Formats

console (default)

Human-readable colored output for terminal:

SquirrelScan Report
========================================
Site: https://example.com
Audited: 42 pages

ISSUES

[high] Missing meta description
  → /about
  → /contact

[medium] Image missing alt text
  → /images/hero.png on /

text

Plain text without colors (for piping):

squirrel report -f text > report.txt

json

Machine-readable JSON for CI/CD and programmatic use:

squirrel report -f json -o report.json

{
  "baseUrl": "https://example.com",
  "crawledAt": "2025-01-17T00:00:00Z",
  "pages": [...],
  "checks": [...],
  "stats": {
    "pagesTotal": 42,
    "issuesCount": { "high": 12, "medium": 18, "low": 23 }
  }
}

markdown

Markdown format for documentation:

squirrel report -f markdown -o report.md

llm

Optimized format for LLM analysis:

squirrel report -f llm | claude "what are the top 3 issues?"

html

Visual HTML report:

squirrel report -f html -o report.html

Opens in browser with interactive filtering and sorting.

Valid Categories

Filter reports by these categories:

• core - Core SEO elements
• content - Content quality
• links - Link analysis
• images - Image optimization
• schema - Structured data
• security - Security headers
• a11y - Accessibility
• i18n - Internationalization
• perf - Performance
• social - Social media
• crawl - Crawlability
• url - URL structure
• mobile - Mobile optimization
• legal - Legal compliance
• local - Local SEO
• video - Video optimization
• analytics - Analytics
• eeat - E-E-A-T signals
• blocking - Ad-blocker & privacy-filter impact (adblock still accepted)

Exit Codes

Code	Meaning
0	Success
1	Error (no audit found, invalid format, etc.)

Related

• auth - Authentication for publishing
• audit - Run new audit
• analyze - Re-analyze crawl
• Dashboard - Manage published reports
• Configuration - Config file options