| name | seo-validate |
| description | SEO validator: meta/OG, Schema.org, hreflang, Core Web Vitals, crawlability. Triggers: SEO, meta tags, Schema.org, hreflang, LCP, INP, CLS, Core Web Vitals, sitemap, crawlability. |
| user-invocable | true |
| effort | medium |
| disable-model-invocation | true |
| context | fork |
| agent | seo-specialist |
| argument-hint | [path] [--scope full|technical|content|performance|geo|rendering|topical] [--severity high|warn|info] [--framework auto|next|nuxt|astro|gatsby|sveltekit|remix|angular|vue|react-spa|vite-spa|cra|static] [--rendering auto|csr|ssr|ssg|isr|hybrid] [--output markdown|json] |
| allowed-tools | Read, Grep, Glob, Bash |
/seo-validate — SEO Validation Scanner
$ARGUMENTS
Scan a codebase for SEO issues using pattern-matching heuristics. Detects W3C/HTML violations, meta tag gaps, structured data problems, hreflang errors, Core Web Vitals risks (LCP/INP/CLS), resource-hint misuse, above-the-fold anti-patterns, GEO gaps (chunk architecture, hedging language, decision frameworks, semantic triples, freshness), topical authority gaps (pillar/cluster structure, orphan pages, cannibalization), SPA/CSR/SSG crawlability problems, technical SEO misconfigurations, and accessibility-for-SEO issues. Read-only — never modifies files.
Standards basis: W3C HTML5 Recommendation, W3C WCAG 2.2, Schema.org vocabulary, IETF RFC 5646 (BCP 47 language tags) for hreflang, web.dev Core Web Vitals thresholds (LCP <2.5s, INP <200ms, CLS <0.1), Google Search Central crawlability guidelines, and emerging GEO (Generative Engine Optimization) practices.
Usage
/seo-validate # Scan full project, auto-detect framework
/seo-validate src/ # Scan specific path
/seo-validate --scope rendering # Only SPA/CSR/SSG crawlability checks
/seo-validate --scope performance # Only Core Web Vitals static signals
/seo-validate --scope geo # Only GEO (Generative Engine Optimization)
/seo-validate --scope topical # Only topical authority and cluster architecture
/seo-validate --severity high # Filter to HIGH findings only
/seo-validate --framework next # Force framework (skip auto-detection)
/seo-validate --rendering csr # Force rendering-mode interpretation
/seo-validate --output json # Structured JSON output for CI integration
Scopes:
full (default) — all 10 categoriestechnical — HTML semantics, hreflang, CWV, rendering, technical SEO (categories 1, 4, 5, 7, 8)content — meta/OG, structured data, GEO, a11y-for-SEO (categories 2, 3, 6, 9)performance — only CWV static signals (category 5)geo — only GEO / citability checks (category 6)rendering — only category 7 (SPA/CSR/SSG crawlability) — useful for migration auditstopical — only topical authority and cluster architecture (category 10)
Severity filtering: --severity high shows only HIGH, --severity warn shows HIGH+WARN, --severity info shows all. Default: all.
What This Command Does
- from , config files, and entry HTML.
