# SEOBolt

> Self-hosted SEO platform for developers and AI agents. An open-source alternative to Ahrefs, SEMrush, and Moz.

URL: https://seobolt.app

## Features

- Site Audit: Crawl websites and detect 20+ SEO issues with fix suggestions
- Rank Tracker: Monitor keyword rankings over time
- Keywords Research: Discover and track organic keywords
- Backlink Monitor: Track referring domains and backlink profiles
- Content Optimizer: Score page content for target keywords (0-100)
- Competitor Analysis: Head-to-head SEO comparison with content gaps
- Internal Links Analysis: Audit internal linking structure
- Domain Rating: Calculate domain authority score (0-100) based on backlink profile
- Keyword Difficulty: Score how hard it is to rank for any keyword (0-100) with SERP analysis
- Content Gap Analysis: Find topics competitors rank for that you don't cover
- Link Prospects: Discover domains linking to competitors but not you — outreach targets

## Pricing

- Free: $0/month — 2 projects, 3 crawls/month, 100 pages per crawl
- Starter: $19/month — 10 projects, 30 crawls/month, 1,000 pages per crawl
- Pro: $49/month — 50 projects, 100 crawls/month, 10,000 pages per crawl
- Business: $99/month — Unlimited projects & crawls, 50,000 pages per crawl

All paid plans include a 7-day free trial.

## Agent Quickstart

Sign up programmatically (no browser needed):

```
curl -X POST https://seobolt.app/api/agent-signup \
  -H "Content-Type: application/json" \
  -d '{"name":"Claude"}'
```

Response:
```json
{
  "api_key": "sk_live_...",
  "user_id": "...",
  "project_id": "...",
  "message": "Use this API key with the MCP server or API"
}
```

## MCP Server

Install and configure the MCP server for Claude or other AI assistants:

```bash
npm install -g @seobolt/mcp
```

Claude Desktop config (~/.claude/config.json):
```json
{
  "mcpServers": {
    "seobolt": {
      "command": "npx",
      "args": ["-y", "@seobolt/mcp"],
      "env": {
        "SEOBOLT_API_KEY": "sk_live_your_key_here",
        "SEOBOLT_URL": "https://seobolt.app"
      }
    }
  }
}
```

### MCP Tools

1. seo_projects — List all SEO projects with health scores and stats
2. seo_audit — Get SEO audit (health score, issues summary) for a project
3. seo_issues — Get detailed SEO issues with fix recommendations
4. seo_start_crawl — Start a new SEO crawl for a project
5. seo_fix_suggestions — Get specific code fix suggestions for a page URL
6. seo_content_score — Score a page's SEO optimization for a target keyword
7. seo_compare — Compare two pages head-to-head on SEO metrics
8. seo_get_checkout_url — Get a payment URL to upgrade plan (human-in-the-loop)
9. seo_domain_rating — Get Domain Rating (0-100) for any domain
10. seo_keyword_difficulty — Check keyword difficulty score with SERP analysis
11. seo_content_gap — Find content gaps between you and competitors (async)
12. seo_link_prospects — Discover link building prospects from competitor backlinks

## API Endpoints

All endpoints require `Authorization: Bearer sk_live_...` header.

- GET /api/v1/projects — List projects
- GET /api/v1/audit?projectId=... — Get latest audit
- POST /api/v1/audit — Start a new crawl (body: { projectId })
- GET /api/v1/audit/issues?projectId=... — Get detailed issues
- POST /api/v1/checkout-url — Get checkout URL (body: { plan: "STARTER"|"PRO"|"BUSINESS" })
- POST /api/agent-signup — Create agent account (body: { name })
- GET /api/domain-rating?domain=... — Get Domain Rating for a domain
- GET /api/keyword-difficulty?keyword=... — Get keyword difficulty score
- POST /api/keyword-difficulty — Batch keyword difficulty (body: { keywords: string[] })
- POST /api/content-gap — Start content gap analysis (body: { projectId, competitors })
- GET /api/content-gap?projectId=... — Get content gap results (poll for completion)
- POST /api/link-prospects — Find link prospects (body: { projectId, competitors })
- GET /api/link-prospects?projectId=... — Get saved link prospects (paginated)

## Links

- Pricing: https://seobolt.app/pricing
- For AI Agents: https://seobolt.app/agents
- Login: https://seobolt.app/login
- Register: https://seobolt.app/register