{
  "markdown": "# crawlgraph-mcp\n\nMCP server for the [CrawlGraph](https://crawlgraph.com) backlink-intelligence API. Gives any MCP client — Claude Desktop, Claude Code, Cursor, Cline, Zed, Windsurf — backlink lookups and competitor gap analysis built on the public [Common Crawl](https://commoncrawl.org) webgraph (4.4B edges, 120M domains).\n\n> Backlink data without the $129/month subscription. CrawlGraph is $99 lifetime; API access is included on the lifetime tier.\n\n## What you can do\n\n- **`backlinks`** — every referring domain for a target, with authority scores\n- **`gap_analysis`** — domains linking to your competitors but not to you\n- **`gap_outreach_targets`** — the warm-outreach play: the domains that link to **all** of your competitors but not to you, ranked and de-noised. These are publishers who cover your whole space and have simply never heard of you — the warmest backlink targets you will ever pitch.\n- **`releases`** — list the Common Crawl snapshots you can query\n\n## Install\n\nYou need a CrawlGraph API key (`cg_live_...`). **Free tier: 15 backlink calls/month, no card** - get a key emailed to you at [crawlgraph.com/docs/api](https://crawlgraph.com/docs/api). The `gap_analysis` and `gap_outreach_targets` tools need the [$99 lifetime tier](https://crawlgraph.com) (1,000 calls + 50 gap analyses/month, no subscription).\n\n### Claude Desktop / Claude Code\n\nAdd to your MCP config (`claude_desktop_config.json`, or `.mcp.json` for Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"crawlgraph\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"crawlgraph-mcp\"],\n      \"env\": {\n        \"CRAWLGRAPH_API_KEY\": \"cg_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf / Cline / Zed\n\nSame shape — point the client's MCP config at `npx -y crawlgraph-mcp` with `CRAWLGRAPH_API_KEY` in the env. Restart the client and the four tools appear.\n\n## The outreach play, in one prompt\n\nOnce it's connected, you don't call the tools by hand — you describe the goal:\n\n> \"Use gap_outreach_targets for mydomain.com against competitor-a.com and competitor-b.com, then draft a short, specific outreach email to each priority target.\"\n\nBehind the scenes the server submits the gap job, polls until it completes, filters the results down to the domains that link to **every** competitor but not to you, strips out platform/CDN noise (amazonaws, github, facebook, ...), and hands your agent a clean ranked list to write outreach against.\n\n**Why 2-3 competitors, not one:** a site linking to one competitor might be a fluke or a paid placement. A site linking to three of your competitors is a publisher who covers your whole category. That overlap is the qualifier.\n\n## Tools reference\n\n| Tool | Arguments | Quota cost |\n|------|-----------|------------|\n| `backlinks` | `domain`, `limit?`, `sort?` (`authority`\\|`hosts`), `release_id?` | 1 backlinks call |\n| `gap_analysis` | `my_domain`, `competitor_domains[]` (1-5) | 1 gap job |\n| `gap_outreach_targets` | `my_domain`, `competitor_domains[]` (2-5), `include_platforms?` | 1 gap job |\n| `releases` | — | free |\n\nLifetime quota: 1,000 backlinks calls + 50 gap jobs per calendar month. Full API reference: [crawlgraph.com/docs/api](https://crawlgraph.com/docs/api).\n\n## Configuration\n\n| Env var | Required | Default |\n|---------|----------|---------|\n| `CRAWLGRAPH_API_KEY` | yes | — |\n| `CRAWLGRAPH_BASE_URL` | no | `https://crawlgraph.com` |\n\n## Limitations\n\nCrawlGraph is a **quarterly** Common Crawl snapshot, not a live crawler. It's built for one-off competitor prospecting, not live backlink monitoring — for change-tracking within days, a continuous-crawl tool like Ahrefs is the right choice. The gap result carries which competitors each domain links to (`found_on`) but not per-domain authority; use the `backlinks` tool if you need to score an individual target.\n\n## Develop\n\n```bash\nnpm install\nnpm run build\nCRAWLGRAPH_API_KEY=cg_live_... npm start\n```\n\n## License\n\nMIT\n",
  "bytes": 3930,
  "sha": "607cc910da59c5b624b8476dcfb61ca971b5fadb0b3a1543f5bab6eab7818fef",
  "repo_slug": "pucilpet/crawlgraph-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pucilpet_crawlgraph_mcp_97d1e895/readme"
}