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.
Install squirrelscan and run your first audit in under 2 minutes.
Use squirrelscan with Claude Code, Cursor, and other AI coding assistants.
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:
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:
npx skills add squirrelscan/squirrelscan
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:
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:
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:
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?
Built for coding agents. LLM-optimised output works seamlessly with Claude Code, Cursor, and any AI assistant.
Single binary, zero dependencies. Shell completions, self-update, and CI/CD compatible exit codes.
Comprehensive coverage across SEO, accessibility, performance, and security audits.
ETag, Last-Modified, and content hashing. Skip unchanged pages. Resume interrupted crawls.
Dedicated rules for Experience, Expertise, Authority, and Trust: Google’s top ranking signals.
Console, JSON, HTML reports, LLM-friendly output. Export exactly what you need.
Works Where You Work
Run anywhere with a single command.
Install the squirrelscan skills for autonomous workflows.
Native skill integration with composer mode.
Pipe text/JSON/markdown to any LLM.
Log in for rendering, AI analysis, and shareable reports.
Expose the audit engine to any MCP client as tools.
Fail pipelines on audit errors with exit codes.
Integrate into your automation workflows.
Rule Categories
squirrelscan runs 264 rules across 21 categories, plus opt-in cloud gap analysis:
| Category | Description |
|---|---|
| Accessibility | ARIA, focus, landmarks |
| Agent Experience | AI crawler access, LLM parsability, page-type, site profile |
| Analytics | GTM, consent mode |
| Blocking | Ad-blocker & privacy-filter blocked content |
| Content | Quality, readability, freshness |
| Core SEO | Meta tags, canonical URLs, h1, favicon |
| Crawl | Robots.txt, sitemap, indexing |
| E-E-A-T | Experience, expertise, trust signals |
| Gap Analysis | Keyword & content gaps (cloud, opt-in) |
| i18n | Hreflang, lang attribute |
| Images | Alt text, dimensions, formats |
| Legal | Privacy, cookies, TOS |
| Links | Internal, external, broken links |
| Local SEO | NAP consistency, geo meta |
| Mobile | Viewport, tap targets |
| Performance | Core Web Vitals, LCP/CLS/INP |
| Schema | JSON-LD structured data |
| Security | HTTPS, CSP, headers |
| Site Integrity | Injected pages, phishing, malware, SEO spam |
| Social | Open Graph, Twitter cards |
| URL Structure | Length, hyphens, keywords |
| Video | VideoObject schema, accessibility |
