The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Scrapeunblocker MCP listing page.
A Model Context Protocol server that lets Claude (and any other MCP client) fetch any web page's HTML through the ScrapeUnblocker scraping API, bypassing anti-bot protection (Cloudflare, DataDome, PerimeterX, Akamai, Shape).
You bring your own API key. Nothing is shared or proxied through us.
| Tool | What it does |
|---|---|
fetch_html | Fetch the fully rendered HTML of a URL (optionally after running interactive browser steps). |
list_elements | List a page's notable elements with a ready-to-use selector for each (selector discovery). |
fetch_parsed | Fetch a page and return AI-parsed structured JSON. |
google_search | Run a Google search and return organic results as JSON. |
Some pages only reveal what you need after you interact with them - accept a
cookie banner, click a tab, type into a search box and submit, or scroll to
trigger lazy loading. Pass an optional steps array to fetch_html and those
actions run in a real browser, in order, after the page loads; the resulting
HTML is then returned.
Available actions:
| Action | Fields |
|---|---|
wait_for | selector, selector_type? (css/xPath/className/tagName), timeout_ms? |
wait_for_text | value, timeout_ms? |
wait | value (ms) |
click | selector, selector_type?, timeout_ms? |
type | selector, selector_type?, value, clear?, timeout_ms? (typed human-like) |
select | selector, selector_type?, value, timeout_ms? |
press_key | value (Enter, Tab, Escape, Backspace, Delete, Space, Arrow*, Home, End, PageUp, PageDown) |
scroll | value ("bottom" or a pixel offset) |
Steps are not idempotent - they run once per call. If a step fails,
fetch_html returns which step failed, why, and the page HTML at that moment so
you can fix the selector and retry.
list_elements loads a page and returns a JSON list of its notable elements
(links, inputs, buttons, selects, ...), each with a ready-to-use selector plus
tag, text and useful attributes (name, id, type, placeholder,
aria_label, href, ...):
The natural workflow is discover, then act: call list_elements to find the
selectors you need, then pass matching steps to fetch_html to click/type/
select and capture the resulting HTML.
Sign up and grab your key at app.scrapeunblocker.com. The server
reads it from the SCRAPEUNBLOCKER_KEY environment variable.
The easiest route is the official plugin, which installs this server for you,
prompts for your API key (stored in your OS keychain rather than an environment
variable), and adds a /scrape-url command plus reference skills:
See ScrapeUnblocker/claude-code-plugin.
To add the bare server instead:
Add this to your claude_desktop_config.json
(Settings → Developer → Edit Config):
Restart Claude Desktop and the ScrapeUnblocker tools appear.
Run the server over stdio:
MIT