Use Case

MDX SEO Validator

Validate meta tags, schema markup, and keyword placement across your MDX and Markdown content. Catch SEO issues before they ship — not after Google ignores your pages.

Get Started See what it checks

MDX gives you control. But SEO falls through the cracks.

When you write content in MDX or Markdown, there's no CMS checking your meta tags, generating your schema, or warning you about missing descriptions. Every page is a file in your repo, and SEO validation is on you.

You ship a blog post with a 15-character description. You forget og:image on a landing page. You write 2,000 words without mentioning your target keyword in the first paragraph. These are invisible problems until you check Google Search Console weeks later and wonder why nobody found your content.

An MDX SEO validator catches these before deploy — the same way a linter catches syntax errors before commit.

What the MDX validator checks

Every check runs against your actual MDX files — frontmatter, content, and rendered output.

Frontmatter & meta tags

Validates title, description, og:image, twitter:card, and canonical URL in your MDX frontmatter. Flags missing or too-short fields.

Schema markup

Checks for valid JSON-LD structured data — BlogPosting, Article, FAQ, HowTo. Verifies required fields match your content.

Keyword placement

Audits keyword density and placement against your target keywords. Checks H1, first paragraph, subheadings, and meta description.

Heading structure

Validates H1/H2/H3 hierarchy. Catches duplicate H1s, skipped levels, and headings that don't include target keywords.

Image alt text

Finds images missing alt attributes. Suggests keyword-relevant alt text based on surrounding content.

Internal links

Detects broken internal links, orphaned pages, and missing cross-references between related content.

What it looks like

Ask your AI to validate an MDX file. It scans the content and tells you exactly what to fix.

You

Scan my latest blog post at /blog/ai-seo-tools for SEO issues before I merge this PR.

Claude (using scan_page, optimize_content)

I scanned the MDX file. Found 4 issues:

errorMeta description is 12 characters — minimum 120 recommended

errorNo schema markup found — BlogPosting recommended for blog posts

warnTarget keyword “ai seo tools” missing from first paragraph

warn2 images missing alt attributes

I can fix all of these. Want me to update the frontmatter, add schema, and adjust the content?

You

Yes, fix all of them.

Claude (editing blog/ai-seo-tools/page.mdx)

- description: "AI SEO tools"

+ description: "Compare the best AI SEO tools for automated site audits, keyword research, and content optimization. Hands-on review with real results."

All 4 issues fixed. Meta description expanded, BlogPosting schema added, keyword placed in the intro paragraph, and alt text generated for both images. Changes are staged.