GitHub

Introduction

The website QA tool for your coding agent

squirrelscan audits your website for SEO, performance, security, accessibility and agent experience issues, and gives your coding agent exact fixes. 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 with a single binary and 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 skills for autonomous workflows in Claude Code, Cursor, Codex, and any coding agent:

bash
npx skills add 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 required:

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.

249 Rules, 21 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 squirrelscan skills 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 249 rules across 21 categories, plus opt-in cloud gap analysis:

CategoryDescription
AccessibilityARIA, focus, landmarks
Agent ExperienceAI crawler access, LLM parsability, page-type, site profile
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, opt-in)
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