ScrapeUnblocker Documentation

The official MCP server lets Claude (Desktop, Code, and the web app) and any other Model Context Protocol client fetch any web page’s HTML - or AI-parsed JSON, or Google results - through ScrapeUnblocker, bypassing anti-bot protection (Cloudflare, DataDome, PerimeterX, Akamai, Shape). You bring your own API key. Nothing is proxied through a shared account.

npx -y scrapeunblocker-mcp

Requires Node.js 18+. Published on npm as scrapeunblocker-mcp.

Tools

Tool	What it does
`fetch_html`	Fetch the fully rendered HTML of any URL.
`fetch_parsed`	Fetch a page and return AI-parsed structured JSON.
`google_search`	Run a Google search and return organic results as JSON.

Get an API key

Grab your key from the dashboard. The server reads it from the SCRAPEUNBLOCKER_KEY environment variable, so each user runs it with their own key.

Install

Claude Code
Claude Desktop
Any MCP client

claude mcp add scrapeunblocker \
  --env SCRAPEUNBLOCKER_KEY=YOUR_API_KEY \
  -- npx -y scrapeunblocker-mcp

Add this to your claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude Desktop:

{
  "mcpServers": {
    "scrapeunblocker": {
      "command": "npx",
      "args": ["-y", "scrapeunblocker-mcp"],
      "env": {
        "SCRAPEUNBLOCKER_KEY": "YOUR_API_KEY"
      }
    }
  }
}

The server speaks MCP over stdio. Start it with your key in the environment:

SCRAPEUNBLOCKER_KEY=YOUR_API_KEY npx -y scrapeunblocker-mcp

Once connected, the three tools appear automatically and the assistant calls them when it needs to reach a page that would otherwise be blocked.

Hosted connector (claude.ai web & mobile)

Don’t want to run anything locally? Use the hosted server. It works across claude.ai (web and mobile), Claude Desktop, and Claude Code - no install. There are two ways to connect: sign in with OAuth (no key to copy) or put your API key in the URL. Connect with your ScrapeUnblocker login - no key to paste, and it bills your own account.

On claude.ai: Settings → Connectors → Add custom connector.
URL: https://mcp.scrapeunblocker.com/mcp (no ?key=).
Open Advanced settings and set OAuth Client ID to:
5BM5Wk2dE4ABkDITmuKfemPLnn3QQ8jd
Leave OAuth Client Secret empty.
Add, then sign in with your ScrapeUnblocker account and Authorize.

The tools then appear everywhere you use Claude. You need a ScrapeUnblocker account for the email you sign in with - create a free one first if you don’t have it.

Or use your API key in the URL

Simplest for Claude Code and other MCP clients - your key goes in the URL:

https://mcp.scrapeunblocker.com/mcp?key=YOUR_API_KEY

claude.ai: Settings → Connectors → Add custom connector, paste the URL above (with your key), Save. Claude Code:

claude mcp add --transport http scrapeunblocker \
  "https://mcp.scrapeunblocker.com/mcp?key=YOUR_API_KEY"

The key can also be sent as an Authorization: Bearer YOUR_API_KEY header instead of the query parameter.

Example prompts

“This page keeps blocking me: https://example-shop.com/product/123. Use fetch_html to get it and list the price.”
“Fetch the parsed data for https://www.amazon.com/dp/B08N5WRWNW and summarise the product.”
“Search Google for best running shoes 2026 and give me the top 5 links, then fetch the first one.”

Configuration

Environment variable	Required	Description
`SCRAPEUNBLOCKER_KEY`	Yes	Your API key. `SCRAPEUNBLOCKER_API_KEY` is also accepted.
`SCRAPEUNBLOCKER_BASE_URL`	No	Override the API base URL (defaults to `https://api.scrapeunblocker.com`).

The MCP server is a thin wrapper over the Node.js SDK and the same getPageSource endpoint. Anything the tools return is exactly what the API returns - see the guides for response shapes.

Source

npm: scrapeunblocker-mcp
GitHub: ScrapeUnblocker/scrapeunblocker-mcp

Get Started

No-code area

Plugins

AI Assistants

Guides

Code Examples

MCP Server (Claude)

Tools

Get an API key

Install

Hosted connector (claude.ai web & mobile)

Or use your API key in the URL

Example prompts

Configuration

Source

​Tools

​Get an API key

​Install

​Hosted connector (claude.ai web & mobile)

​Sign in with OAuth (recommended on claude.ai)

​Or use your API key in the URL

​Example prompts

​Configuration

​Source

Tools

Get an API key

Install

Hosted connector (claude.ai web & mobile)

Sign in with OAuth (recommended on claude.ai)

Or use your API key in the URL

Example prompts

Configuration

Source