report - squirrelscan

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`

Publishing

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

Publishing requires authentication. Run squirrel auth login first.

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

Output:

Report published successfully!
URL: https://reports.squirrelscan.com/XVv4NO7aPr
Visibility: public

Manage your reports: https://squirrelscan.com/dashboard/reports

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

Diff mode supports console, text, json, llm, and markdown. html and xml are not supported in diff mode.

Diff mode cannot be published with --publish.

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
adblock - Adblock detection

Exit Codes

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

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

Documentation Index

​Usage

​Arguments

​Options

​Publishing

​Visibility Levels

​Publish Report

​Publish with Visibility

​Publish Specific Audit

​Examples

​View Latest Audit

​List All Audits

​View Specific Audit by ID

​View Latest Audit for Domain

​Export as JSON

​Export as HTML

​Export as Markdown

​Filter by Severity

​Filter by Category

​Diff Reports

​LLM-Optimized Format

​Output Formats

​console (default)

​text

​json

​markdown

​llm

​html

​Valid Categories

​Exit Codes

​Related

Usage

Arguments

Options

Publishing

Visibility Levels

Publish Report

Publish with Visibility

Publish Specific Audit

Examples

View Latest Audit

List All Audits

View Specific Audit by ID

View Latest Audit for Domain

Export as JSON

Export as HTML

Export as Markdown

Filter by Severity

Filter by Category

Diff Reports

LLM-Optimized Format

Output Formats

console (default)

text

json

markdown

llm

html

Valid Categories

Exit Codes

Related