# seo-a11y-analyzer > Analyzes HTML/JSX/TSX files for SEO and accessibility issues including WCAG 2.1 AA compliance, color contrast (4.5:1), heading hierarchy, meta tags, image alt text, and ARIA attributes. Use when checking web pages for SEO, accessibility, WCAG compliance, or when user mentions "a11y", "contrast", "alt text", "meta tags", "heading structure", or "accessibility audit". - Author: naporitan - Repository: naporin0624/claude-web-audit-plugins - Version: 20251226193538 - Stars: 2 - Forks: 0 - Last Updated: 2026-02-06 - Source: https://github.com/naporin0624/claude-web-audit-plugins - Web: https://mule.run/skillshub/@@naporin0624/claude-web-audit-plugins~seo-a11y-analyzer:20251226193538 --- --- name: seo-a11y-analyzer description: Analyzes HTML/JSX/TSX files for SEO and accessibility issues including WCAG 2.1 AA compliance, color contrast (4.5:1), heading hierarchy, meta tags, image alt text, and ARIA attributes. Use when checking web pages for SEO, accessibility, WCAG compliance, or when user mentions "a11y", "contrast", "alt text", "meta tags", "heading structure", or "accessibility audit". --- # SEO & Accessibility Analyzer Analyzes HTML/JSX/TSX files for SEO issues and WCAG 2.1 AA compliance. ## Quick Start Copy this workflow checklist and track progress: ``` Analysis Progress: - [ ] Step 1: Read target file - [ ] Step 2: Run quick checks (P0 critical issues) - [ ] Step 3: Run detailed checks (all issues) - [ ] Step 4: Validate with axe-core CLI - [ ] Step 5: Generate report with fixes ``` ## Step 1: Read Target File Read the HTML/JSX/TSX file using the Read tool. Identify file type: - `.html` - Standard HTML - `.jsx` / `.tsx` - React components (check className instead of class) ## Step 2: Quick Checks (P0 Critical Issues) Check these **immediately** - they block compliance: ### 1. Title Tag (WCAG 2.4.2) ```html Descriptive Page Title - Site Name ``` - Must exist and be non-empty - Recommended length: 50-60 characters - Should be unique per page ### 2. Meta Description (SEO) ```html ``` - Must exist - Recommended length: 150-160 characters ### 3. H1 Uniqueness (WCAG 2.4.6) - Exactly **one** `

` per page - Must be descriptive and unique ### 4. Heading Hierarchy - No skipped levels (h1 → h3 without h2) - Logical nesting structure ### 5. Image Alt Text (WCAG 1.1.1) ```html ``` - All `` must have `alt` attribute - Decorative images: `alt=""` - Informative images: descriptive text (not filename) ### 6. Color Contrast (WCAG 1.4.3) - Normal text: 4.5:1 minimum - Large text (18pt / 14pt bold+): 3:1 minimum - See [reference/color-contrast.md](reference/color-contrast.md) for common color combinations If any P0 issue found, report immediately with location and fix. ## Step 3: Detailed Checks ### SEO Checks See [reference/seo-checks.md](reference/seo-checks.md) for complete list (30 items). Key items: - Canonical URL: `` - Open Graph tags: ``, `og:description`, `og:image` - Twitter Cards: ``, `twitter:title` - Structured data: `