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

Tool	Description
crawl_site	Full site crawl — returns JSON with SEO, performance, and security metrics for all URLs
crawl_single_page	Single page analysis — fast, lightweight audit of one URL
generate_sitemap	Crawl a site and generate an XML sitemap file
export_markdown	Crawl a site and export all pages as markdown files
get_crawl_summary	Quick shallow crawl for health check statistics

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

Variable	Purpose	Default
SITEONE_BIN	Path to the SiteOne crawler binary	Auto-detected (see above)
SITEONE_OUTPUT_DIR	Working directory for crawl outputs	Current working directory

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