# Next.js SEO Audit

> Next.js SEO Audit is an open-source MCP server for marketing and seo. Local read-only MCP server that audits a deployed site for SEO and indexing problems. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/josephdourden/nextjs-seo-audit-mcp
- **MCP Registry name:** io.github.JosephDoUrden/nextjs-seo-audit
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Aimed at Next.js sites, this server wraps the `vercel-seo-audit` CLI so a coding agent can check a deployed URL and read back the CLI's agent-format JSON. Checks cover redirects, robots.txt, sitemap, canonicals, noindex, metadata streamed into the body and preview deployments left indexable, across 17 modules. It does not run JavaScript, so it sees what the deployment serves, not what a browser renders.

Three tools exist on stdio only. One audit runs at a time with a 120-second cap, plus two seconds per crawled page. Findings are labelled as untrusted page content, with control and format characters stripped. Private and loopback addresses are refused to limit server-side request forgery, with an environment flag to audit a local dev server; DNS rebinding is noted as not covered. It never writes files, and fix text is only a suggestion. Node 22 or newer is required.

## Features

- **Site audit:** Audits one URL and returns findings sorted by severity.
- **Issue explanations:** Explains what an issue code means and which module reports it.
- **Check listing:** Lists every module id and the codes it can report.
- **Sitemap crawl:** Optionally audits 1 to 50 pages from the sitemap.
- **Diff against earlier run:** Passing a previous result returns new, resolved and unchanged findings.
- **SSRF protection:** Refuses private addresses unless explicitly allowed.

## Good for

- Audit a preview deployment before launch
- Find pages accidentally set to noindex
- Check robots.txt and sitemap health
- Re-run an audit and see what was fixed
- Audit a local dev server with the private-address flag

## Install

### Claude Code (Terminal)

```sh
claude mcp add nextjs-seo-audit -- npx -y nextjs-seo-audit-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nextjs-seo-audit": {
      "command": "npx",
      "args": [
        "-y",
        "nextjs-seo-audit-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nextjs-seo-audit": {
      "command": "npx",
      "args": [
        "-y",
        "nextjs-seo-audit-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nextjs-seo-audit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "nextjs-seo-audit-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nextjs-seo-audit": {
      "command": "npx",
      "args": [
        "-y",
        "nextjs-seo-audit-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nextjs-seo-audit": {
      "command": "npx",
      "args": [
        "-y",
        "nextjs-seo-audit-mcp"
      ]
    }
  }
}
```

## Tools

- `audit_site`: Audits one URL and returns findings sorted error, warning, info.
- `explain_finding`: Explains an issue code, its module and category.
- `list_checks`: Lists every module id with the codes it can report.

## FAQ

### Does it change my project?

No. It is read-only and never writes files.

### Does it run JavaScript?

No. It reads what the deployment serves.

### Why was my local URL refused?

Private addresses are blocked unless NEXTJS_SEO_AUDIT_MCP_ALLOW_PRIVATE is set to 1.

### What Node version is needed?

Node 22 or newer.

### Is Next.js SEO Audit free?

Yes. Next.js SEO Audit is open source, so you can use and self-host it for free.

### How do I add Next.js SEO Audit to Claude Code?

Run this command in your terminal: claude mcp add nextjs-seo-audit -- npx -y nextjs-seo-audit-mcp

### What are the best alternatives to Next.js SEO Audit?

The closest alternatives to Next.js SEO Audit are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/next-js-seo-audit
