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