# pucilpet/crawlgraph-mcp [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/pucilpet/crawlgraph-mcp  
**GitHub Stars:** 5  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pucilpet-crawlgraph-mcp

## Description
Backlink intelligence and competitor gap analysis on the public Common Crawl webgraph (4.4B edges, 120M domains) via CrawlGraph. 4 tools: backlink lookups, gap analysis, and a composite outreach-targets finder (domains linking to all your competitors but not you, de-noised and ranked by authority). Install: npx -y crawlgraph-mcp.

## Tools
Capabilities this server exposes over MCP:

- **backlinks** — Look up referring domains (backlinks) for a single target domain from the Common Crawl webgraph. Returns each linking domain with host count and CrawlGraph authority score, plus the target's own authority/rank. Costs one backlinks call against the monthly quota (1,000/mo on lifetime).
- **gap_analysis** — Run a competitor backlink gap analysis: find domains that link to one or more of your competitors but NOT to you. Submits an async job and polls until done (usually 5-30s). Returns every gap with `found_on` listing which competitors each domain links to. Costs one gap job against the monthly quota (50/mo on lifetime).
- **gap_outreach_targets** — The warm-outreach play. Runs a gap analysis, then ranks results: PRIORITY = domains linking to ALL your competitors but not you (publishers who cover your whole space and have never heard of you), SECONDARY = domains linking to 2+ competitors. Platform/CDN noise is filtered, top N priority targets are scored by authority. Use 2-3 competitors. Costs one gap job + one backlinks call per enriched target.
- **releases** — List the Common Crawl releases the API can query. Does not count against any quota. Use a release `id` with the backlinks tool to query a specific snapshot.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "crawlgraph-mcp": {
    "command": "npx",
    "args": ["-y","crawlgraph-mcp"],
    "env": {
      "CRAWLGRAPH_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `CRAWLGRAPH_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the pucilpet/crawlgraph-mcp MCP server does

The pucilpet/crawlgraph-mcp MCP server connects MCP clients to the CrawlGraph backlink-intelligence API. Its data comes from the public Common Crawl webgraph, which the project describes as covering 4.4 billion edges and 120 million domains. The server is intended for competitor backlink research, gap analysis, and outreach prospecting.

The `backlinks` tool accepts a target domain and returns referring domains, host counts, CrawlGraph authority scores, and the target domain's own authority or rank. The `gap_analysis` tool finds domains that link to one or more competitors but not to the specified domain. Each gap includes a `found_on` field identifying which competitors link from that domain.

## How it works

The pucilpet/crawlgraph-mcp MCP server sends requests to CrawlGraph using an API key. Backlink lookups are direct API calls. Gap analysis submits an asynchronous job and polls until the result is ready; completion usually takes 5–30 seconds.

`gap_outreach_targets` combines those operations into a prospecting workflow. It runs a gap analysis, removes platform and CDN noise unless configured otherwise, and classifies results into priority and secondary groups. Priority domains link to all supplied competitors but not to the user's domain. Secondary domains link to at least two competitors. The tool can enrich top priority targets with authority scores. The documentation recommends using two or three competitors for this workflow.

The `releases` tool lists Common Crawl snapshots available through the API. A returned release ID can be supplied to `backlinks` to query a particular snapshot.

## Setup and configuration

Install the package with:

```bash
npx -y crawlgraph-mcp
```

The server requires a CrawlGraph API key in `CRAWLGRAPH_API_KEY`. The API documentation provides free keys by email, with a free allowance of 15 backlink calls per month. The gap tools require the $99 lifetime tier. That tier includes 1,000 backlink calls and 50 gap analyses per calendar month, according to the supplied material.

`CRAWLGRAPH_BASE_URL` is optional and defaults to `https://crawlgraph.com`. Configure the server in an MCP client by running the package with `npx -y` and passing the API key through the process environment. The README gives configuration examples for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and Zed.

## Tools and capabilities

- `backlinks`: Look up referring domains for one target. Results can be limited, sorted by authority or host count, and associated with a selected release.
- `gap_analysis`: Compare one domain with one to five competitor domains and return missing referring-domain opportunities.
- `gap_outreach_targets`: Compare two to five competitors, filter noise, group prospects, and score selected targets by authority.
- `releases`: List queryable Common Crawl snapshots without consuming the monthly quota.

Backlink calls and gap jobs consume separate quotas. Enriching outreach targets also consumes backlink calls for the targets being scored.

## Limitations and notes

The data is based on quarterly Common Crawl snapshots, not a live crawl. This makes the server suitable for periodic prospecting and research, but not for tracking backlink changes over a period of days. Gap results identify the competitors associated with each domain but do not include per-domain authority; use `backlinks` when an individual prospect needs an authority score.

The project is released under the MIT license. The pucilpet/crawlgraph-mcp MCP server does not itself provide outreach writing; an MCP client or agent can use the returned prospect data for that purpose.

_Full upstream README: https://allmcps.com/mcp/pucilpet-crawlgraph-mcp/readme_