squirrelscan
v0.0.38
Published
Free CLI for SEO, performance & security audits. Built for Claude Code, Cursor, and AI workflows.
Maintainers
Readme
squirrelscan
Website audit tool built for your coding agent
Free CLI for SEO, performance & security audits. Built for Claude Code, Cursor, and AI workflows. 230+ rules, LLM-optimized reports, single binary install.
Features
- 230+ Rules, 21 Categories - Comprehensive coverage across SEO, accessibility, performance, and security
- AI-Native Design - LLM-optimised output for Claude Code, Cursor, and any AI assistant
- Smart Incremental Crawling - ETag, Last-Modified, content hashing. Resume from checkpoints.
- Developer-First CLI - Single binary, zero dependencies, shell completions, self-update
- E-E-A-T Auditing - Dedicated rules for Experience, Expertise, Authority, Trust
- Crawl History & Changes - Track site evolution, compare crawls, spot regressions
- Multiple Output Formats - Console, JSON, HTML, Markdown, Text, LLM, XML
Three Ways to Use
1. CLI for Humans
Run audits directly in your terminal:
squirrel audit example.com2. AI Coding Agent Skill
Install the skill for autonomous workflows:
npx skills install squirrelscan/skillsUse the slash command:
/audit-websiteOr prompt your AI agent more specifically:
Use the audit-website skill to audit this site and fix all issues but only crawl 10 pagesMore information in the skills repository and our Getting started with AI Agents documentation.
3. Pipe to AI agent
Pipe clean output to any AI assistant:
squirrel audit example.com --format llm | claudeInstallation
macOS / Linux:
curl -fsSL https://squirrelscan.com/install | bashWindows:
iwr -useb https://squirrelscan.com/install.ps1 | iexnpm (all platforms):
npm install -g squirrelscannpx (run without installing):
npx squirrelscan audit example.comQuick Start
# Audit a website
squirrel audit https://example.com
# Generate HTML report
squirrel audit https://example.com -f html -o report.html
# Pipe to Claude for AI analysis
squirrel audit https://example.com --format llm | claude
# Limit pages for faster results
squirrel audit https://example.com -m 10Resources
- Website: squirrelscan.com
- Documentation: docs.squirrelscan.com
- AI Agent Skills: github.com/squirrelscan/skills
Rule Categories
| Category | Rules | Focus | |----------|-------|-------| | Accessibility | 56 | ARIA, button/input names, landmarks, lists, tables, focus | | Performance | 24 | Core Web Vitals, compression, caching, JS optimization | | Crawlability | 15 | Robots.txt, sitemaps, indexability | | Security | 15 | HTTPS, CSP, cookies, leaked secrets (96 patterns) | | Links | 15 | Broken links, redirects, anchor text | | Images | 15 | Alt text, formats, lazy loading, optimization | | Content | 15 | Readability, freshness, word count | | E-E-A-T | 14 | Authority, trust, expertise signals | | Core | 13 | Meta tags, canonical, doctype, charset | | Structured Data | 11 | JSON-LD, schema validation | | URL Structure | 8 | Length, format, parameters | | Mobile | 6 | Viewport, tap targets, responsive | | Social Media | 4 | Open Graph, Twitter Cards | | SEO | 4 | Meta robots, indexability | | Video | 3 | Schema, captions, thumbnails | | Local SEO | 3 | NAP, geo tags, service areas | | Legal | 3 | Privacy policy, cookie consent | | Internationalization | 2 | Hreflang, lang attribute | | Analytics | 2 | GTM, consent mode | | AI Detection | 2 | AI content signals | | Adblock Detection | 2 | Blocked elements, tracking |
Total: 230+ rules across 21 categories
See the rules reference for full details.
AI Agent Integration
squirrelscan is designed for autonomous AI workflows:
# Install the skill for Claude Code, Cursor, etc.
npx skills install squirrelscan/skillsExample AI prompts:
- "Audit example.com and fix all critical issues"
- "Check for SEO regressions after my recent changes"
- "Generate a comprehensive audit report and enter plan mode to fix issues"
- "Audit only the /blog section and focus on E-E-A-T signals"
- "Run a security-focused audit and check for leaked secrets"
See AI Agent Integration docs for advanced workflows.
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 |
Development Status
squirrelscan is in active beta. Expect rapid iteration and breaking changes. Feedback and issue reports welcome!
