Skip to content

thegridwork/siteaudit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@gridwork/siteaudit

An MCP server that audits any website for accessibility (WCAG 2.1 AA / EAA), performance, SEO, design quality, and mobile responsiveness. Get actionable scores, grades, and prioritized fixes.

Built for the compliance era: EU Accessibility Act enforcement is live, EU AI Act deadline is August 2026. Every website needs auditing.

By Gridwork

Tools

Tool Description
audit_site Full comprehensive audit across all 5 categories
quick_check Scores and grades only — fast triage
audit_accessibility WCAG 2.1 AA focused audit with criterion references
audit_performance Performance analysis with actionable fixes
audit_seo SEO check: meta, OG, structured data, etc.
compare_sites Side-by-side comparison of two URLs

Install

Claude Code

claude mcp add @gridwork/siteaudit -- node /path/to/@gridwork/siteaudit/dist/index.js

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "@gridwork/siteaudit": {
      "command": "node",
      "args": ["/path/to/@gridwork/siteaudit/dist/index.js"]
    }
  }
}

Cursor / Windsurf

Add to your MCP config:

{
  "@gridwork/siteaudit": {
    "command": "node",
    "args": ["/path/to/@gridwork/siteaudit/dist/index.js"]
  }
}

Build from Source

npm install
npm run build

What It Checks

Accessibility (30% of score)

  • Language attribute, image alt text, form labels
  • Heading hierarchy, link text quality, ARIA landmarks
  • Skip navigation, tab order, auto-playing media
  • WCAG criterion references on every issue

Performance (20%)

  • Load time, page size, DOM complexity
  • Render-blocking resources, compression, caching
  • Image optimization (dimensions, lazy loading)
  • Resource preloading and preconnect hints

SEO (20%)

  • Title, meta description, heading structure
  • Open Graph, Twitter Cards, canonical URL
  • Structured data (JSON-LD), favicon
  • Internal linking, robots directives

Design Quality (15%)

  • Font consistency, color system coherence
  • Touch target sizes, text readability
  • Visual hierarchy, CTA presence
  • Dark mode support, branding elements

Mobile (15%)

  • Viewport configuration, zoom support
  • Fixed-width overflow detection
  • Responsive images, media queries
  • Input types for mobile keyboards

EAA Compliance Status

Every audit includes an EAA (European Accessibility Act) compliance assessment:

  • COMPLIANT: Meets WCAG 2.1 AA baseline
  • PARTIAL: Some issues to resolve
  • NON-COMPLIANT: Critical accessibility failures

License

MIT

About

MCP server that audits websites for accessibility (WCAG/EAA), performance, SEO, design quality, and mobile responsiveness

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors