// README.md - Instructions for setup and use

SEO Inspector & Schema Validator MCP

A Model Context Protocol (MCP) server for Cursor that analyzes web pages for SEO issues and validates structured data schemas.

Features

• Analyze HTML files in a codebase for SEO issues
• Validate JSON-LD structured data
• Get recommendations to improve SEO
• No browser extension required - works directly with your codebase

Installation

1. Clone this repository:
   git clone https://github.com/yourusername/seo-inspector-mcp.git cd seo-inspector-mcp
2. Install dependencies:
   npm install
3. Configure Cursor to use this MCP server:
   • Go to Settings > Features > MCP in Cursor
   • Add a new MCP server with:
     • Name: SEO Inspector
     • Type: sse
     • URL: http://localhost:8767/sse

Usage

1. Start the MCP server:
   ./run-mcp.sh
2. In Cursor, you can now use the SEO Inspector tools:
   • seo.analyze-codebase - Analyze HTML files in a directory
   • seo.analyze-html - Analyze a specific HTML string

Prioritized SEO Components

The tool checks for these key SEO elements (in order of importance):

Critical

• Page Title
• Meta Description
• H1 Heading
• Canonical URL

Important

• Heading Structure (H2-H6)
• Image Alt Text
• Structured Data (JSON-LD)
• Robots Directives

Recommended

• Open Graph Tags
• Twitter Cards
• Internal Linking
• URL Structure
• Mobile Friendliness

Schema Validation

The tool validates the following schema types:

• Organization
• LocalBusiness
• Product
• Article
• WebPage
• FAQPage
• Event
• Recipe
• Review

License

MIT