report

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

Usage

squirrel report [id] [options]

Arguments

Options

Publishing

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

Visibility Levels

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

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

Related

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