Skip to main content
Glama
mcp-seo-auditor

mcp-seo-auditor

by arturseo-geo

mcp-seo-auditor

Built by Artur Ferreira @ The GEO Lab Β· 𝕏 @TheGEO_Lab Β· LinkedIn Β· Reddit

Version Licence Claude Code

MCP server for on-page SEO auditing and JSON-LD schema validation. Replaces SEO Minion + Detailed SEO Extension as Claude Code tools.

Tools

Tool

Description

audit_page

Full on-page SEO audit β€” title, meta, H1-H6, canonical, OG, Twitter, links, images, word count. Each element scored green/yellow/red

validate_schema

Extract and validate all JSON-LD blocks β€” type-specific checks for Article, FAQPage, Product, HowTo, BreadcrumbList, Person

check_headings

Heading hierarchy analysis β€” missing H1, multiple H1s, skipped levels

audit_images

Image audit β€” alt text coverage, empty alts, lazy loading, missing dimensions

Related MCP server: seo-gaca-mcp

Features

βœ… GEO-native β€” built alongside the GEO Brand Citation Index, tracking brand visibility across ChatGPT, Perplexity, and Gemini

Install

# Claude Code
claude mcp add seo-auditor -- npx mcp-seo-auditor

# Or in .mcp.json
{
  "mcpServers": {
    "seo-auditor": {
      "command": "npx",
      "args": ["mcp-seo-auditor"]
    }
  }
}

Usage

Once installed, Claude Code can:

> audit the SEO of https://example.com
> validate the schema markup on https://thegeolab.net/geo-stack/
> check the heading hierarchy on this page
> audit images for alt text coverage

No API Keys Required

This server fetches pages directly β€” no external API keys needed.


Attributions & Licence

Built and maintained by Artur Ferreira @ The GEO Lab.

Email: artur@thegeolab.net

Best Practice Attribution

This MCP server was built following the open source Best Practice Approach β€” reading community work for inspiration, then writing original content, and crediting every source.

Based on:

SEO audit logic inspired by:

Dependencies:

  • cheerio β€” HTML parsing (MIT)

  • axios β€” HTTP client (MIT)

All server code is original writing. No files were copied or adapted from any source. MIT licence.


Found this useful? ⭐ Star the repo and connect: 🌐 thegeolab.net Β· 𝕏 @TheGEO_Lab Β· LinkedIn Β· Reddit

Licence

MIT β€” see LICENSE


Built and maintained by Artur Ferreira @ The GEO Lab Β· MIT License

Available Tools

4 tools
audit_imagesA

Audit all images on a page β€” alt text coverage, missing alt attributes, oversized images, lazy loading status.

Inputs: url (required).

audit_pageA

Full on-page SEO audit β€” title, meta description, H1-H6 hierarchy, canonical, OG tags, Twitter cards, internal/external links, image alt coverage, word count, robots meta. Each element scored green/yellow/red.

Inputs: url (required).

check_headingsA

Extract and analyze heading hierarchy (H1-H6) from a page. Checks for missing H1, multiple H1s, skipped levels, heading-to-content ratio.

Inputs: url (required).

validate_schemaA

Extract and validate all JSON-LD schema blocks on a page. Type-specific validation for Article, FAQPage, Product, HowTo, BreadcrumbList, Person, Organization.

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation3/5

    audit_page is a comprehensive audit that already includes heading hierarchy and image alt text, overlapping significantly with check_headings and audit_images. While the specific tools provide more detail, the boundaries are not crisp, and an agent could be uncertain which tool to invoke for a headings-only or images-only check.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (audit_page, validate_schema, check_headings, audit_images), using lowercase with underscores. Verbs are semantically apt for each action, and there are no mixed conventions.

    Tool Count5/5

    The server provides 4 tools, which is within the ideal 3-15 range for a focused SEO auditing tool. Each tool handles a distinct aspect of SEO analysis without excessive redundancy or overwhelming breadth.

    Completeness4/5

    The tool set covers the main on-page SEO dimensionsβ€”meta tags, headings, schema, imagesβ€”but lacks common SEO audit features like page speed, mobile-friendliness, or sitemap/robots.txt validation. For a single-page auditor, the coverage is solid but not exhaustive.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server for SEO, performance, GEO, and UX audits with 37 tools covering technical SEO, Lighthouse performance, AI search optimization, content analysis, accessibility, security, and more.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides a suite of SEO analysis tools for auditing meta tags, headings, links, keyword density, page speed, and sitemaps without requiring external API keys.
      6
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for SEO auditing that performs technical SEO, content quality, Schema.org, sitemap, hreflang, and GEO checks, returning scores and prioritized fixes.
      MIT