- name
- seo-audit
- description
- |
- OUTPUTS
- Markdown report with overall score (0-100), category breakdowns (Meta, Content, Technical, Performance), critical issues, warnings, and prioritized recommendations.
- INPUTS
- A single URL to audit. Optionally: target keywords to check against.
SEO Audit
Analyze any webpage for SEO issues and generate an actionable report.
Workflow
- Fetch the target URL using
web_fetch - Analyze the HTML content for SEO factors (see checklist below)
- Score each category (0-100)
- Generate a formatted report with findings and recommendations
- Save report as markdown file
SEO Checklist
Meta & Head (25 points)
- Title tag exists, 30-60 chars, contains target keywords
- Meta description exists, 120-160 chars, compelling
- Canonical URL present
- Open Graph tags (og:title, og:description, og:image)
- Twitter Card tags
- Favicon reference
- Language attribute on
<html>
Content Quality (25 points)
- Single H1 tag present
- Logical heading hierarchy (H1 → H2 → H3)
- Word count (minimum 300 for ranking)
- Image alt text coverage
- Internal links present
- External links present
- No broken heading structure
Technical (25 points)
- Mobile viewport meta tag
- HTTPS (check URL scheme)
- Clean URL structure (no excessive params)
- Structured data / Schema.org markup
- No duplicate content signals
- robots meta tag check
Performance Indicators (25 points)
- Total HTML size (flag if >100KB)
- Image count and alt coverage
- External resource count (CSS/JS files)
- Inline CSS volume (flag if excessive)
- Render-blocking resources estimate
Report Format
# SEO Audit Report: [URL]
**Date:** [date]
**Overall Score:** [X/100]
## Summary
[2-3 sentence overview]
## Scores
| Category | Score | Status |
|----------|-------|--------|
| Meta & Head | X/25 | ✅/⚠️/❌ |
| Content | X/25 | ✅/⚠️/❌ |
| Technical | X/25 | ✅/⚠️/❌ |
| Performance | X/25 | ✅/⚠️/❌ |
## Findings
### Critical Issues
...
### Warnings
...
### Passed
...
## Recommendations
[Prioritized action items]Scoring
- ✅ 80%+ of category points = Good
- ⚠️ 50-79% = Needs improvement
- ❌ Below 50% = Critical issues
Common Mistakes to Avoid
- Don't audit without fetching — always fetch the actual page HTML, don't guess from the URL alone
- Don't penalize single-page apps unfairly — SPAs often have minimal HTML; note it but don't tank the score
- Don't report Open Graph as "critical" — it's important but not a ranking factor. Keep severity accurate.
- Don't ignore context — a personal blog doesn't need Schema.org markup the way an e-commerce site does. Tailor severity to the site type.