GitHub

Introduction

CLI Website Audits for Humans, Agents & LLMs

A comprehensive website audit tool for SEO, performance, content and more that fits into your AI workflow. Single binary, zero dependencies.

Four Ways to Run squirrelscan

Same audit engine, same report — four front doors: your terminal, your coding agent, the cloud, or MCP.

Run audits directly in your terminal — a single binary with zero dependencies:

bash
squirrel audit example.com

Perfect for:

  • Manual audits during development
  • Quick site health checks
  • CI/CD pipelines (fail builds on score or severity thresholds)

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

bash
npx skills install squirrelscan/skills

Then prompt your agent:

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

Or pipe LLM-optimized output to any assistant:

bash
squirrel audit example.com --format text | claude

Perfect for:

  • Autonomous fixing of SEO/accessibility issues
  • Multi-step AI workflows with plan mode
  • Ad-hoc AI assistance and custom scripts

Log in and squirrelscan enriches each audit in the cloud — browser rendering, AI analysis, technology detection, and shareable reports. Billed in credits:

bash
squirrel auth login
squirrel audit example.com

Perfect for:

  • JavaScript-heavy sites and SPAs (real browser rendering)
  • AI parsability and E-E-A-T authority signals
  • Shareable dashboard reports with score history

See the cloud docs for features and costs.

Run a local MCP server so agents call squirrelscan’s audit engine and cloud features as tools — no shell glue:

bash
squirrel mcp

Your agent launches it via its MCP config. Perfect for:

  • Agents and clients that speak MCP
  • Tool-calling instead of parsing CLI output
  • Claude Code and Cursor MCP setups

Why squirrelscan?

AI-Native Design

Built for coding agents. LLM-optimised output works seamlessly with Claude Code, Cursor, and any AI assistant.

Developer-First CLI

Single binary, zero dependencies. Shell completions, self-update, and CI/CD compatible exit codes.

240+ Rules, 22 Categories

Comprehensive coverage across SEO, accessibility, performance, and security audits.

Smart Incremental Crawling

ETag, Last-Modified, and content hashing. Skip unchanged pages. Resume interrupted crawls.

E-E-A-T Auditing

Dedicated rules for Experience, Expertise, Authority, and Trust—Google’s top ranking signals.

Multiple Output Formats

Console, JSON, HTML reports, LLM-friendly output. Export exactly what you need.

Works Where You Work

Terminal

Run anywhere with a single command.

Claude Code

Install the audit-website skill for autonomous workflows.

Cursor

Native skill integration with composer mode.

Any AI Agent

Pipe text/JSON/markdown to any LLM.

Cloud

Log in for rendering, AI analysis, and shareable reports.

MCP

Expose the audit engine to any MCP client as tools.

CI/CD

Fail pipelines on audit errors with exit codes.

Shell Scripts

Integrate into your automation workflows.

Rule Categories

squirrelscan runs 240+ rules across 22 categories:

CategoryDescription
AccessibilityARIA, focus, landmarks
AILLM parsability, AI content detection
AnalyticsGTM, consent mode
BlockingAd-blocker & privacy-filter blocked content
ContentQuality, readability, freshness
Core SEOMeta tags, canonical URLs, h1, favicon
CrawlRobots.txt, sitemap, indexing
E-E-A-TExperience, expertise, trust signals
Gap AnalysisKeyword & content gaps (cloud)
i18nHreflang, lang attribute
ImagesAlt text, dimensions, formats
LegalPrivacy, cookies, TOS
LinksInternal, external, broken links
Local SEONAP consistency, geo meta
MobileViewport, tap targets
PerformanceCore Web Vitals, LCP/CLS/INP
SchemaJSON-LD structured data
SecurityHTTPS, CSP, headers
Site IntegrityInjected pages, phishing, malware, SEO spam
SocialOpen Graph, Twitter cards
URL StructureLength, hyphens, keywords
VideoVideoObject schema, accessibility

Resources

Type to search…

↑↓ navigate ↵ open esc close