# seo-backlinks MCP Server

MCP server that lets Claude, Cursor, Windsurf, Cline, and other AI agents check **backlinks, domain rating, and expired-domain drops** directly via [seo-backlinks.net](https://seo-backlinks.net).

Built on Common Crawl data — **4.3B backlinks indexed, 262M hosts ranked**.

## What it does

Ask Claude:

- _"What's the Domain Rating of nytimes.com?"_
- _"Show me the top 10 sites linking to stripe.com"_
- _"List today's expired domains with backlinks under $50 potential"_
- _"Compare backlink profiles of ahrefs.com vs semrush.com"_

Claude will use this MCP server to query the seo-backlinks API and give you the answer inline.

## Tools

| Tool                     | What it does                                                          |
| ------------------------ | --------------------------------------------------------------------- |
| `check_domain`           | Get DR (0-100), rank, and referring domains count for any domain     |
| `get_referring_domains`  | List sites that link TO a target (competitor research, outreach)      |
| `get_domain_info`        | Detailed metadata + structure for a domain                            |
| `get_expired_domains`    | Today's freshly-expired domains that still have real backlinks        |
| `get_top_hosts`          | Top-ranked hosts across the web (from Common Crawl)                   |

## Install (Claude Desktop)

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "seo-backlinks": {
      "command": "npx",
      "args": ["-y", "seo-backlinks-mcp"],
      "env": {
        "SEO_BACKLINKS_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

**Config file location:**

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

Get a free API key: [seo-backlinks.net/sign-up](https://seo-backlinks.net/sign-up) (3 checks/day free, paid plans start at $29/mo with 7-day trial).

Restart Claude Desktop after editing config.

## Install (Cursor / Windsurf / Cline)

Same idea — add to your MCP settings. Point to the `npx -y seo-backlinks-mcp` command with `SEO_BACKLINKS_API_KEY` env var.

## Install (local dev)

```bash
git clone https://github.com/mouhabmzibra-rgb/mcp-seo-backlinks
cd mcp-seo-backlinks
npm install
npm run build
SEO_BACKLINKS_API_KEY=your_key node dist/index.js
```

## Environment variables

- `SEO_BACKLINKS_API_KEY` — your API key (get free at seo-backlinks.net)
- `SEO_BACKLINKS_API_BASE` — override API endpoint (default `https://api.seo-backlinks.net`)

## Pricing

The MCP server is **MIT-licensed and free**. The underlying seo-backlinks.net service:

- **Free tier** — 3 domain checks per day (no card)
- **Starter** — $29/mo, 1000 checks/mo, 7-day free trial
- **Pro** — $99/mo, 10,000 checks/mo + full API, 7-day free trial

## Support

- Website: https://seo-backlinks.net
- Docs: https://seo-backlinks.net/docs
- Issues: https://github.com/mouhabmzibra-rgb/mcp-seo-backlinks/issues

## License

MIT