SEO Audit

You can run and integrate the SEO Audit MCP Server to systematically analyze and improve the technical SEO of job boards. It brings page-level analysis, site-wide crawling, Lighthouse performance checks, sitemap/robots analysis, and JobPosting schema validation into a unified MCP workflow, enabling you to audit pages, extract insights, and optimize landing pages for search and indexing.

How to use

You use an MCP client to invoke the SEO Audit MCP Server tools. Start with a quick page audit to assess a single URL for meta tags, headings, structured data, and rendering behavior. Then run a site crawl to understand page type distribution and detect duplicates. Use Lighthouse audits to measure Core Web Vitals and overall performance, and analyze your robots.txt and sitemaps to ensure job postings are discoverable. Finally, validate JobPosting schema to confirm compliance with required and recommended fields.

How to install

Prerequisites you need before installing the MCP server are listed here. Make sure you have Node.js 18 or newer and Chrome/Chromium available for Playwright. Installing Lighthouse CLI is optional but recommended for performance auditing.

Step by step installation flow you will follow:

Clone or extract the project into a working directory.

Install dependencies.

Install Playwright browsers (Chromium).

Install Lighthouse globally (optional but recommended).

Build the project.

Claude Desktop configuration

{
  "mcpServers": {
    "seo-audit": {
      "command": "node",
      "args": ["/path/to/seo-audit-mcp/dist/index.js"]
    }
  }
}

Claude CLI configuration

claude --mcp-server "node /path/to/seo-audit-mcp/dist/index.js"

Build and run locally

The following commands reflect the flow to build and prepare the MCP server for use. Run each command on its own line.

# Clone or extract the project
# (Replace the path with your actual project path)
git clone https://example.com/seo-audit-mcp.git
cd seo-audit-mcp

# Install dependencies
npm install

# Install Playwright browsers
npx playwright install chromium

# Install Lighthouse globally (optional but recommended)
npm install -g lighthouse

# Build the project
npm run build

Optional runtime configuration notes

If you are integrating with Claude Desktop or Claude CLI, point them to the local build output. The standard runtime entry point is the built index under dist, invoked with Node as shown in the configuration snippets above.

Available tools

analyze_page

Analyze a single web page for SEO factors including meta tags, headings, structured data, rendering behavior, and links. Returns page-level insights and JobPosting schema validation results.

crawl_site

Crawl multiple pages starting from a URL to classify pages, detect duplicates, and report critical issues and warnings across the site.

run_lighthouse

Execute Lighthouse audits for performance, accessibility, best practices, and SEO, and report Core Web Vitals metrics.

analyze_sitemap

Analyze robots.txt and XML sitemaps to extract discovered URLs and provide job URL detection and recommendations.

check_urls

Check HTTP status codes for a list of URLs and report status, redirects, and timings.