Skip to main content
The report command lets you view and query audit reports from the local database.

​
Usage

squirrel report [id] [options]

​
Arguments

ArgumentDescription
idAudit ID (UUID) or domain name (optional, defaults to latest)

​
Options

OptionAliasDescriptionDefault
--list-lList recent auditsfalse
--format-fOutput format: console, text, json, html, markdown, xml, llmconsole
--output-oOutput file pathauto
--input-iLoad from JSON file (fallback mode)-
--severityFilter by severity: error, warning, allall
--categoryFilter by categories (comma-separated)all
--diffCompare current report against baseline (audit ID or domain)-
--regression-sinceCompare against baseline and show regressions-
--allow-cross-siteAllow diff across different base URLsfalse
--publish-pPublish report to reports.squirrelscan.comfalse
--visibilityVisibility: public, unlisted, privatepublic

​
Publishing

Share reports online by publishing to reports.squirrelscan.com.
Publishing requires authentication. Run squirrel auth login first.

​
Visibility Levels

LevelDescription
publicListed and searchable (default)
unlistedAccessible via link only, not listed
privateOnly 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

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