io.github.thegridwork/siteaudit
Audit websites for accessibility, performance, SEO, design, and mobile. 47 WCAG checks.
Open source Open in the app JSON README (API)
About
Audit websites for accessibility, performance, SEO, design, and mobile. 47 WCAG checks.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- thegridwork
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-04-08T13:56:21Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 04:01:32
- Updated
- 2026-08-29 04:01:32
- Origin id
io.github.thegridwork/siteaudit
README
# @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](https://github.com/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
```bash
claude mcp add @gridwork/siteaudit -- node /path/to/@gridwork/siteaudit/dist/index.js
```
### Claude Desktop (claude_desktop_config.json)
```json
{
"mcpServers": {
"@gridwork/siteaudit": {
"command": "node",
"args": ["/path/to/@gridwork/siteaudit/dist/index.js"]
}
}
}
```
### Cursor / Windsurf
Add to your MCP config:
```json
{
"@gridwork/siteaudit": {
"command": "node",
"args": ["/path/to/@gridwork/siteaudit/dist/index.js"]
}
}
```
## Build from Source
```bash
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