Quickstart

Install squirrelscan and run your first SEO audit

Installation

curl -fsSL --connect-timeout 10 --max-time 120 https://install.squirrelscan.com | bash

iwr -useb https://install.squirrelscan.com/install.ps1 | iex

This downloads the binary to ~/.local/bin/squirrel and adds it to your PATH.

Four Ways to Run squirrelscan

Run audits directly with human-readable terminal output:

squirrel audit example.com

Install the skills for autonomous workflows in Claude Code, Cursor, Codex, and any coding agent:

npx skills add squirrelscan/squirrelscan

Then run /audit-website or prompt your agent:

Use the audit-website skill to audit this site and fix all issues

Or pipe LLM-optimized output to any assistant:

squirrel audit example.com --format llm | claude

squirrel auth login
squirrel audit example.com

Run a local MCP server so agents call squirrelscan’s tools directly:

squirrel mcp

Run Your First Audit

Audit a website with a single command:

squirrel audit https://example.com

You’ll see output like:

 ▄█▀ ▄▀█ █ █ █ █▀▄ █▀▄ █▀▀ █   ▄█▀ ▄▀▀ ▄▀█ █▄ █
 ▀▄  █ █ █ █ █ ██▀ ██▀ █▀  █   ▀▄  █   █▀█ █ ▀█
 █▄▀ ▀▀█ ▀▄▀ █ █ █ █ █ █▄▄ █▄▄ █▄▀ ▀▄▄ █ █ █  █

  v0.0.84  •  https://squirrelscan.com
────────────────────────────────────────────
Auditing  https://example.com
Coverage  surface · max 100 pages
Config    defaults
Account   you@example.com · 500 credits
Dashboard https://app.squirrelscan.com

✓ Audited 12 pages in 2.1s

──────────────────────────────────────────────────
SQUIRRELSCAN REPORT
https://example.com • 12 pages • 72/100 (C)
──────────────────────────────────────────────────

Category Breakdown:
--------------------------------------------------
Core SEO             ███████░░░ 75%
Content              ████████░░ 82%
Links                █████████░ 91%
...

ISSUES

Core SEO (1 error, 3 warnings)
  core/meta-description Meta Description (error)
    ✗ meta-description: Missing meta description
      → /about
      → /contact

  core/og-tags Open Graph Tags (warning)
    ⚠ og-image: Missing og:image
      → /

Content (2 warnings)
  content/word-count Word Count (warning)
    ⚠ word-count: Thin content: 150 words (min 300)
      → /landing

──────────────────────────────────────────────────
87 passed • 12 warnings • 3 failed
──────────────────────────────────────────────────

Common Options

Limit pages crawled
For large sites, limit pages to get faster results:
```
squirrel audit https://example.com -m 10
```
Export to JSON
Output machine-readable JSON for CI/CD or AI processing:
```
squirrel audit https://example.com -f json -o report.json
```

Generate HTML report

Create a visual HTML report:

squirrel audit https://example.com -f html -o report.html

Fresh crawl
Ignore cache and fetch all pages fresh:
```
squirrel audit https://example.com --refresh
```
Choose a coverage mode
Trade depth for speed. quick is fast, local and free, surface audits one page per template, full is comprehensive:
```
squirrel audit https://example.com -C quick
```
The default is quick when you’re signed out and surface when you’re signed in.
Run only some categories
Narrow the audit to the categories you care about right now:
```
squirrel audit https://example.com --rule-include ax,performance
```
A filtered run produces a partial report. Scores reflect only the rules that ran, so don’t compare them against a full audit.

Output Formats

Format	Flag	Use Case
`console`	(default)	Human-readable terminal output
`json`	`-f json`	CI/CD, programmatic processing
`html`	`-f html`	Visual reports for sharing
`markdown`	`-f markdown`	Documentation, GitHub
`text`	`-f text`	Clean output for piping to LLMs
`llm`	`-f llm`	LLM optimized output
`xml`	`-f xml`	XML output

Using with AI Agents

squirrelscan is designed for AI workflows. Two primary methods:

1. Install the Skills (Recommended)

npx skills add squirrelscan/squirrelscan

Then use with Claude Code, Cursor, or any skill-compatible agent:

Use the audit-website skill to audit example.com and fix all issues

2. Pipe Output to AI

# Audit and pipe directly to Claude
squirrel audit example.com --format llm | claude "analyze and prioritize fixes"

The --format llm provides compact, token-optimized output designed specifically for AI agents.

Next Steps

Run squirrel --help for all available commands
See Configuration to customize audit behavior
Check CLI Reference for full audit options
View the GitHub repo for updates

Edit this page