siteone-mcp-server

MCP server that wraps the SiteOne Crawler CLI for SEO auditing and site analysis. Use it with Claude Code, Claude Desktop, or any MCP-compatible client.

Install SiteOne Crawler

The auto-installer downloads the correct SiteOne Crawler binary for your platform:

npx -y siteone-mcp-server --install

This installs to ~/.siteone-crawler/ and the MCP server will auto-detect it — no further configuration needed.

Supports macOS (arm64, x64) and Linux (arm64, x64). Windows users should download manually.

Quick Start

Claude Code

claude mcp add siteone -- npx -y siteone-mcp-server

Claude Desktop

Add to your MCP settings (~/.claude/mcp_settings.json):

{
  "mcpServers": {
    "siteone": {
      "command": "npx",
      "args": ["-y", "siteone-mcp-server"]
    }
  }
}

Available Tools

Configuration

The server resolves the SiteOne binary in this order:

1. --siteone-bin CLI argument (highest priority)

2. SITEONE_BIN environment variable

3. ~/.siteone-crawler/crawler (auto-installed location)

4. crawler in PATH (fallback)

CLI argument

claude mcp add siteone -- npx -y siteone-mcp-server --siteone-bin=/path/to/crawler

Or in Claude Desktop config:

{
  "mcpServers": {
    "siteone": {
      "command": "npx",
      "args": ["-y", "siteone-mcp-server", "--siteone-bin=/path/to/crawler"]
    }
  }
}

Environment variables

Examples

Once configured, ask Claude:

• "Crawl https://example.com and summarize the SEO issues"

• "Check if https://example.com has any broken links"

• "Generate a sitemap for https://example.com"

• "Export https://example.com as markdown"

• "Give me a quick health check of https://example.com"

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Test with MCP Inspector
npm run inspect

License

MIT