// 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

1. Install dependencies:

npm install

1. Configure Cursor to use this MCP server:
2. Go to Settings > Features > MCP in Cursor
3. 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

1. In Cursor, you can now use the SEO Inspector tools:
2. seo.analyze-codebase - Analyze HTML files in a directory
3. 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