Skip to content
Back to search

squirrelscan

Official squirrelscan plugins: website QA for coding agents. The plugin now ships from squirrelscan/skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/squirrelscan/squirrelscan with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/squirrelscan/squirrelscan'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/squirrelscan--squirrelscan/badge.svg)](/listings/squirrelscan--squirrelscan)

HTML

<a href="/listings/squirrelscan--squirrelscan"><img src="/api/listings/squirrelscan--squirrelscan/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Paste into your coding agent** (Claude Code, Codex, Cursor, opencode and friends):

Fetch and follow the setup instructions for squirrelscan at https://docs.squirrelscan.com/agent-setup/prompt.md

Your agent installs the CLI, connects MCP and runs a first audit. You can [read exactly what it will follow](https://docs.squirrelscan.com/agent-setup/prompt) first.

**macOS / Linux:**

curl -fsSL https://install.squirrelscan.com | bash

**Windows:**

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

**Homebrew (macOS):**

brew install --cask squirrelscan/tap/squirrel

The cask installs a launcher that runs the regular installer on first use. The CLI then updates itself with `squirrel self update`; `brew upgrade` leaves it alone.

**npm (all platforms):**

npm install -g squirrelscan

**npx (run without installing):**

npx squirrelscan audit example.com

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "squirrelscan",
  3. "owner": {
  4. "name": "squirrelscan",
  5. "email": "support@squirrelscan.com"
  6. },
  7. "description": "Official squirrelscan plugins: website QA for coding agents. The plugin now ships from squirrelscan/skills.",
  8. "plugins": [
  9. {
  10. "name": "squirrelscan",
  11. "source": {
  12. "source": "github",
  13. "repo": "squirrelscan/skills"
  14. },
  15. "description": "Website QA tool built for coding agents (Claude Code, Cursor). 340+ rules across SEO, performance, security, accessibility & agent experience: audit from the CLI, fix findings in code, publish reports, and connect over MCP.",
  16. "category": "productivity",
  17. "tags": ["seo", "audit", "website", "performance", "security"]
  18. }
  19. ]
  20. }
README.md · README · 303 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ![squirrelscan](docs/logo/light.svg)
  2. # squirrelscan
  3. **The website QA tool for your coding agent**
  4. squirrelscan is an Open Source cli tool that audits websites for SEO, performance, security, accessibility, agent experience and other issues, and gives your coding agent exact fixes. Run it from the CLI, inside your coding agent, in the cloud, or over MCP.
  5. Combine your coding agent with a deterministic and extensible audit tool.
  6. [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://squirrelscan.com/add/cursor)
  7. [![Add to Claude Code](https://img.shields.io/badge/Add_to-Claude_Code-d97757?style=for-the-badge)](https://squirrelscan.com/add/claude)
  8. [![Add to Codex](https://img.shields.io/badge/Add_to-Codex-000000?style=for-the-badge)](https://squirrelscan.com/add/codex)
  9. [![Add to opencode](https://img.shields.io/badge/Add_to-opencode-383838?style=for-the-badge)](https://squirrelscan.com/add/opencode)
  10. [![MCP Registry](https://img.shields.io/badge/MCP-Registry-1f6feb?style=for-the-badge)](https://registry.modelcontextprotocol.io)
  11. [![CI](https://img.shields.io/github/actions/workflow/status/squirrelscan/squirrelscan/ci.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/squirrelscan/squirrelscan/actions/workflows/ci.yml)
  12. [![CodeQL](https://img.shields.io/github/actions/workflow/status/squirrelscan/squirrelscan/codeql.yml?branch=main&style=for-the-badge&label=CodeQL)](https://github.com/squirrelscan/squirrelscan/actions/workflows/codeql.yml)
  13. [![npm](https://img.shields.io/npm/v/squirrelscan?style=for-the-badge&label=npm)](https://www.npmjs.com/package/squirrelscan)
  14. [![License: MIT](https://img.shields.io/badge/License-MIT-52a852?style=for-the-badge)](LICENSE)
  15. ![Terminal demo: squirrel audit on a small test site reports 13 failed checks, the report is piped to Claude Code, which fixes the pages and re-audits from 32/100 (F) to 92/100 (A), then git status lists the files it changed](assets/readme-demo.gif)
  16. <sub>A real run on a tiny test site, with the released CLI (signed out, so free) and Claude Code. We cut the two minutes the agent spent working, because nobody wants to watch an agent think.</sub>
  17. ## Features
  18. - **[Built for coding agents](https://docs.squirrelscan.com/developers/agents)** - Skills for Claude Code, Cursor, Codex and any coding agent run the audit, fix and re-audit loop. Connect over the CLI, the hosted or local MCP server, or the API.
  19. - **[Enriched fixes for you and your coding agent](https://docs.squirrelscan.com/guides/fix-your-site-with-an-ai-agent)** - Every finding says how to fix it, in LLM-optimized output your agent can apply, and every rule has its own docs page. Signed in, the report adds an editor's summary of what to fix first and the technology stack the site runs on.
  20. - **[340+ rules, 22 categories](https://docs.squirrelscan.com/rules)** - Audit coverage across SEO, accessibility, performance, security, content and more.
  21. - **[Agent experience](https://docs.squirrelscan.com/rules/ax)** - Audit how well AI agents can read, discover and act on your site: llms.txt, AGENTS.md, Markdown responses, and what AI crawlers are served.
  22. - **[Link checking and monitoring](https://docs.squirrelscan.com/guides/link-checking)** - Perch, the cloud link checker, tells a broken link from a blocked one and confirms a failure before reporting it. On Pro and Team, scheduled audits email you when a link breaks.
  23. - **[Security and site integrity](https://docs.squirrelscan.com/rules/integrity)** - Detect phishing kits, injected pages, leaked credentials and missing security headers.
  24. - **[Entity map](https://docs.squirrelscan.com/guides/entity-map)** - Your site's JSON-LD collapsed into one graph: one identity, or a new one on every page.
  25. - **[Browser rendering in the cloud](https://docs.squirrelscan.com/guides/browser-rendering)** - Signed in, pages are rendered in a real browser in the cloud, so single-page apps and JavaScript-heavy sites are audited as visitors see them, at no extra cost per page.
  26. - **[Cloud audits](https://docs.squirrelscan.com/guides/cloud-audits)** - AI page analysis, scheduled audits, a per-website issue tracker and shareable reports.
  27. - **[Smart crawling](https://docs.squirrelscan.com/crawl)** - Fast and memory efficient, incremental with ETag, Last-Modified and content hashing, and resumable from checkpoints.
  28. - **[Crawl history and changes](https://docs.squirrelscan.com/cli/report)** - Track site evolution, compare crawls, spot regressions.
  29. - **[Developer-first CLI](https://docs.squirrelscan.com/cli)** - Single binary, zero dependencies, shell completions, self-update.
  30. - **[Multiple output formats](https://docs.squirrelscan.com/cli/report#output-formats)** - Console, JSON, HTML, Markdown, Text, LLM, XML.
  31. ## Rule categories
  32. Ordered by how much a failure usually costs you, not by how many rules each one has.
  33. | Category | Rules | What it covers |
  34. |----------|-------|----------------|
  35. | Crawlability | 24 | Whether search engines and agents can reach and index you at all: robots.txt, sitemap validity and coverage, indexability conflicts, redirect and canonical chains, soft 404s |
  36. | Core SEO | 14 | The per-page fundamentals: title, meta description, H1, canonical, charset, doctype, robots meta, Open Graph and Twitter cards, plus canonical form drift across the site |
  37. | Agent Experience | 18 | How ready you are for AI agents to read, discover and act on the site: whether GPTBot and Claude-User get the same content a browser does, AGENTS.md, llms.txt, Markdown responses, API and MCP discovery, licensing and noai signals, WebMCP tools, pay-per-crawl, response token weight |
  38. | Site Integrity | 9 | Signs the site has been compromised: injected doorway pages, phishing kit signatures, obfuscated scripts, brand impersonation, cloaking, known-malicious URLs |
  39. | Security | 32 | Transport and header hygiene: HTTPS and HSTS, CSP, cookie flags, mixed content, subresource integrity, leaked secrets, tokens in web storage, unprotected and downgraded forms, open GraphQL introspection and mutations over GET, API endpoints that return data without authentication, credentials and bulk personal data in JSON API responses, exposed .git, .env and backup files, auth endpoints that leak password hashes or the user record, open redirects, admin APIs that answer without credentials, exposed Spring Boot Actuator endpoints, Supabase tables readable with the public anon key |
  40. | Links | 15 | Internal and external link health: broken and dead links, in-page anchors whose target is gone, redirect chains, anchor-text quality, orphan and dead-end pages, pages linked only from sitewide chrome, HTTPS downgrades |
  41. | Content | 30 | Text quality and honesty: common misspellings, duplicate titles and descriptions, title-template consistency, readability, font consistency, voice consistency, terminology consistency, word count, freshness, stale dated copy, heading hierarchy, keyword stuffing, hidden text, placeholder media and contact details, encoding damage |
  42. | Performance | 32 | Core Web Vitals and delivery: LCP, CLS and INP hints, TTFB, compression, caching, render-blocking resources, DOM size, font delivery, legacy and unminified JS/CSS |
  43. | Reliability | 5 | Scripts, stylesheets and fonts that fail to load (a first-party bundle that answers 404 or 500 after a deploy, third-party and font failures), and forms that lose submissions |
  44. | Images | 16 | Alt text, modern formats, responsive `srcset`, intrinsic dimensions and aspect-ratio mismatches, lazy loading above versus below the fold, file weight |
  45. | Structured Data | 26 | JSON-LD validity and rich-result eligibility for Article, Product, FAQ, Review, Breadcrumb, Organization, LocalBusiness, Video and site search, the markup a page's classified type should carry, plus thirteen site-wide checks on the entity map: whether the site declares one identity for itself or a new one on every page, and rating markup that is not about the page it sits on |
  46. | Accessibility | 63 | WCAG coverage: ARIA roles and names, form labels and autocomplete tokens, colour contrast, heading order, landmarks, tables and lists, focus visibility, touch targets, captions |
  47. | Mobile | 8 | Viewport configuration, tap-target size, legible font sizes, horizontal scroll, blocked zoom, form fields small enough to zoom the page on focus, intrusive interstitials, the web app manifest and its icons |
  48. | Social Media | 5 | Open Graph and Twitter Card completeness, image dimensions, canonical URL match, social profile links, site-chrome assets that disagree across pages |
  49. | URL Structure | 10 | Length, casing, hyphenation, stop words, query parameters, special characters, trailing-slash consistency, site-wide convention consistency |
  50. | E-E-A-T | 16 | Experience, expertise, authority and trust signals: author bylines and credentials, byline consistency across pages of a type, about and contact pages, citations, editorial policy, disclaimers, YMYL detection |
  51. | Legal Compliance | 4 | Privacy policy, terms of service, real cookie-consent machinery, subprocessor disclosure |
  52. | Internationalization | 4 | hreflang correctness, the document language declaration, and spelling, date and currency conventions that contradict each other on one page |
  53. | Local SEO | 3 | NAP (name, address, phone) consistency across every crawled page, geo metadata, service-area businesses |
  54. | Video | 3 | VideoObject markup, captions and accessibility, thumbnails |
  55. | Analytics | 3 | Google Tag Manager presence, consent-mode wiring, and the same GA4 or GTM ID installed twice |
  56. | Blocking | 3 | Content, links and trackers that ad blockers and privacy filters strip for a large share of your visitors |
  57. **Total: 340+ rules across 22 categories**
  58. Cloud audits also run ten [third-party rules](https://docs.squirrelscan.com/cloud/third-party) (compromised, proxied and unpinned vendor scripts, session replay and tag managers on sign-in and checkout pages, vendor counts). They are cloud-only and are not counted above.
  59. See the [rules reference](https://docs.squirrelscan.com/rules) for full details.
  60. ## CLI
  61. ### Installation
  62. **Paste into your coding agent** (Claude Code, Codex, Cursor, opencode and friends):
  63. ```text
  64. Fetch and follow the setup instructions for squirrelscan at https://docs.squirrelscan.com/agent-setup/prompt.md
  65. ```
  66. Your agent installs the CLI, connects MCP and runs a first audit. You can [read exactly what it will follow](https://docs.squirrelscan.com/agent-setup/prompt) first.
  67. **macOS / Linux:**
  68. ```bash
  69. curl -fsSL https://install.squirrelscan.com | bash
  70. ```
  71. **Windows:**
  72. ```powershell
  73. iwr -useb https://install.squirrelscan.com/install.ps1 | iex
  74. ```
  75. **Homebrew (macOS):**
  76. ```bash
  77. brew install --cask squirrelscan/tap/squirrel
  78. ```
  79. The cask installs a launcher that runs the regular installer on first use. The CLI then updates itself with `squirrel self update`; `brew upgrade` leaves it alone.
  80. **npm (all platforms):**
  81. ```bash
  82. npm install -g squirrelscan
  83. ```
  84. **npx (run without installing):**
  85. ```bash
  86. npx squirrelscan audit nutshop.squirrelscan.com
  87. ```
  88. ### Quick start
  89. ```bash
  90. # Audit a website
  91. squirrel audit nutshop.squirrelscan.com
  92. # Generate HTML report
  93. squirrel audit nutshop.squirrelscan.com -f html -o report.html
  94. # Pipe to Claude for AI analysis
  95. squirrel audit nutshop.squirrelscan.com --format llm | claude
  96. # Quick audit for a fast first look (other levels: surface, full)
  97. squirrel audit nutshop.squirrelscan.com --level quick
  98. # run only agent experience and performance rules
  99. squirrel audit nutshop.squirrelscan.com --rule-include ax,performance
  100. # login for cloud audits and cloud rendering
  101. squirrel auth login
  102. ```
  103. ## Reports
  104. A health score and grade, group scores for SEO, performance, security and Agent Experience (AX) colored by score, a ranked list of issues, and a copy fix prompt for each one that you can paste into your coding agent. Publish reports to the web to share with team members or coding agents (fix instructions are embedded).
  105. ![A squirrelscan report for squirrelscan.com. The header shows the site, 220 of 220 pages scanned, the Full audit level and a health score of 79 (C). A notice says 912 of 1412 external links were not checked. Four group cards show SEO 86 (B), Performance 59 (F), Security 95 (A) and Agents 42 (F), each with its error and warning counts. Below are pass, warning and fail totals, an auto-generated summary, and the first three ranked issues, each with a Copy fix prompt button.](docs/images/report/example-report.webp)
  106. [See an example report](https://reports.squirrelscan.com/01M5NJH51Q6FNRAA3QGW8GYWB6), or read [how to read your report](https://docs.squirrelscan.com/guides/read-your-report).
  107. ## Add to your coding agent
  108. squirrelscan ships as an **MCP server** (hosted at `mcp.squirrelscan.com`), **skills** (autonomous audit + fix workflows), and a **plugin** for Claude Code and Cursor. Cursor installs in one click from the badge above; the rest are a single copy-paste.
  109. ### Cursor
  110. Click the **Add to Cursor** badge above, or add it manually to `~/.cursor/mcp.json`:
  111. ```json
  112. {
  113. "mcpServers": {
  114. "squirrelscan": { "url": "https://mcp.squirrelscan.com/mcp" }
  115. }
  116. }
  117. ```
  118. Skills: `squirrel skills install`
  119. ### Claude Code
  120. Install the plugin (bundles skills + the MCP server):
  121. ```
  122. /plugin marketplace add squirrelscan/skills
  123. /plugin install squirrelscan@squirrelscan
  124. ```
  125. Or add just the MCP server:
  126. ```bash
  127. claude mcp add --transport http squirrelscan https://mcp.squirrelscan.com/mcp
  128. ```
  129. ### OpenAI Codex
  130. Add the server to `~/.codex/config.toml`:
  131. ```toml
  132. [mcp_servers.squirrelscan]
  133. url = "https://mcp.squirrelscan.com/mcp"
  134. ```
  135. Codex reads Agent Skills from `~/.agents/skills`, so skills work too: `squirrel skills install`
  136. ### opencode
  137. Add the server to `opencode.json`:
  138. ```json
  139. {
  140. "$schema": "https://opencode.ai/config.json",
  141. "mcp": {
  142. "squirrelscan": {
  143. "type": "remote",
  144. "url": "https://mcp.squirrelscan.com/mcp",
  145. "enabled": true
  146. }
  147. }
  148. }
  149. ```
  150. ### Any MCP client
  151. squirrelscan is in the [MCP Registry](https://registry.modelcontextprotocol.io) as `com.squirrelscan/squirrelscan`. Point any client at the remote server:
  152. ```
  153. https://mcp.squirrelscan.com/mcp
  154. ```
  155. Authentication is per-user OAuth (or pass a squirrelscan API key as a Bearer token). Skills follow the [Agent Skills standard](https://agentskills.io): `squirrel skills install` puts them in `~/.agents/skills/` and `~/.claude/skills/`.
  156. ## Skills
  157. Two skills drive agent workflows. They live in [squirrelscan/skills](https://github.com/squirrelscan/skills), along with the Claude Code, Cursor and Agent Plugins packages that bundle them with the MCP server. `squirrel skills install` downloads and verifies them itself, and from v0.0.99 `squirrel`'s auto-update keeps them current. Installs made earlier with `npx skills` are taken over.
  158. - **`squirrelscan`** - operating the CLI: install, login, keys, credits, running audits, publishing reports, the entity map, MCP setup, config, troubleshooting.
  159. - **`audit-website`** - the full fix loop: audit, map issues to source files, fix in batches, re-audit until the site scores well.
  160. ```bash
  161. squirrel skills install
  162. ```
  163. Then, in your agent:
  164. ```
  165. Use the audit-website skill to audit this site and fix all issues but only crawl 10 pages
  166. ```
  167. ## Output formats
  168. | Format | Flag | Use Case |
  169. |--------|------|----------|
  170. | Console | (default) | Human-readable terminal output |
  171. | JSON | `-f json` | CI/CD, programmatic processing |
  172. | HTML | `-f html` | Visual reports for sharing |
  173. | Markdown | `-f markdown` | Documentation, GitHub |
  174. | Text | `-f text` | Clean output for piping to LLMs |
  175. | LLM | `-f llm` | LLM optimized output |
  176. | XML | `-f xml` | XML output |
  177. ## Source and development
  178. The complete local CLI, crawler, audit engine, rules, report generators, CLI-facing cloud clients, and documentation site are open source in this repository. The hosted API, website, dashboard, and cloud worker implementations are separate private services.
  179. Prerequisites: [Bun 1.4.4](https://bun.sh/) and Git.
  180. ```bash
  181. git clone https://github.com/squirrelscan/squirrelscan.git
  182. cd squirrelscan
  183. bun install --frozen-lockfile
  184. bun run dev -- audit https://nutshop.squirrelscan.com --max-pages 10
  185. ```
  186. Run the same checks used in pull requests:
  187. ```bash
  188. bun run format:check
  189. bun run lint
  190. bun run typecheck
  191. bun test
  192. bun run build
  193. bun run docs:check
  194. bun run docs:build
  195. ```
  196. See [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request. Contributions require a Developer Certificate of Origin sign-off (`git commit -s`).
  197. ## Telemetry
  198. Telemetry is enabled by default and is deliberately minimal: event name, CLI version, a random install ID, and bounded error categories. It does not send API keys, URLs, report contents, or raw error messages. After `squirrel auth login`, telemetry requests carry your login session (the 90-day sign-in token from login, never an API key) so events tie to your account; signed out, they are anonymous. Nothing is sent when telemetry is off.
  199. Disable it permanently with:
  200. ```bash
  201. squirrel self settings set telemetry false
  202. ```
  203. Or disable all telemetry and install registration for any invocation by defining `NO_TELEMETRY` (any defined value works, including an empty value, `0`, or `false`) or `DO_NOT_TRACK=1` (or `true`). A project can opt out with `"telemetry": false` in `.squirrel/settings.json`:
  204. ```bash
  205. NO_TELEMETRY=1 squirrel audit https://nutshop.squirrelscan.com
  206. ```
  207. ## Links
  208. - [Website](https://squirrelscan.com)
  209. - [Documentation](https://docs.squirrelscan.com)
  210. - [FAQ](https://docs.squirrelscan.com/faq)
  211. - [Coding agent integration](https://docs.squirrelscan.com/agents)
  212. - [Share feedback](https://squirrelscan.com/feedback)
  213. - [Bugs, issues and feature requests](https://github.com/squirrelscan/squirrelscan/issues)
  214. - [Twitter/X](https://x.com/squirrelscan_)
  215. If squirrelscan caught something your agent missed, a [star on GitHub](https://github.com/squirrelscan/squirrelscan) helps other developers find it.
  216. ## License
  217. The CLI and the repository contents are licensed under the [MIT License](LICENSE). squirrelscan names and logos are covered by [TRADEMARKS.md](TRADEMARKS.md).
  218. The CLI bundles the DB-IP IP to Country Lite and IP to ASN Lite databases (snapshot 2026-11) for offline hosting-country and edge-provider lookups, with the CDN providers' published IP ranges: [IP Geolocation by DB-IP](https://db-ip.com), licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.