
Web scraping MCP server for Claude, Cursor, Windsurf & AI agents — scrape any site, extract
Web scraping MCP server for Claude, Cursor, Windsurf & AI agents — scrape any site, extract structured data, take screenshots. Anti-bot bypass, proxy rotation, authenticated scraping.
·
Give Claude, Cursor, and Windsurf the ability to scrape any website, extract structured data, and take screenshots — with automatic anti-bot bypass.
Get Started Free → $1 free balance on signup — up to 5,000 scrapes.
claude mcp add alterlab -- npx -y alterlab-mcp-server@latestThen set your API key: export ALTERLAB_API_KEY=sk_live_... or add it to .claude.json (see full setup below).
# Add to .cursor/mcp.json — see full config belownpx -y @smithery/cli install alterlab-mcp-server --client claudeClaude's built-in WebFetch tool and open-source browser MCP servers fail on most real-world websites. They cannot bypass Cloudflare, render JavaScript SPAs, or extract structured data.
AlterLab replaces broken fetch tools with one MCP server that actually works:
| Capability | WebFetch / fetch() | Browser MCP | AlterLab MCP |
|---|---|---|---|
| Anti-bot bypass (Cloudflare, DataDome, Akamai) | No | Partial | Yes — automatic |
| JavaScript rendering (React, Angular, Vue SPAs) | No | Yes (slow) | Yes — headless Chromium |
| Structured data extraction (JSON, Schema.org) | No | No | Yes — built-in profiles |
| Smart tier escalation (cheapest method first) | N/A | N/A | Yes — saves 60-80% |
| Residential proxy rotation (195+ countries) | No | No | Yes |
| Screenshot and PDF capture | No | Screenshot only | Yes — both |
| OCR text extraction from images | No | No | Yes |
| Cost per request | Free (but fails) | Free (but slow) | From $0.0002 |
AlterLab uses a multi-tier scraping architecture. It automatically selects the cheapest method capable of fetching each URL:
Auto mode starts at Tier 1 and escalates only when blocked. Most websites resolve at Tiers 1-2, so $1 gets you 1,000 to 5,000 scrapes depending on the sites you target.
Add to your Claude config file (~/.claude.json for Claude Code, or Settings for Claude Desktop):
{
"mcpServers": {
"alterlab": {
"command": "npx",
"args": ["-y", "alterlab-mcp-server@latest"],
"env": {
"ALTERLAB_API_KEY": "sk_live_your_key_here"
}
}
}
}Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"alterlab": {
"command": "npx",
"args": ["-y", "alterlab-mcp-server@latest"],
"env": {
"ALTERLAB_API_KEY": "sk_live_your_key_here"
}
}
}
}Add to Windsurf MCP settings (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"alterlab": {
"command": "npx",
"args": ["-y", "alterlab-mcp-server@latest"],
"env": {
"ALTERLAB_API_KEY": "sk_live_your_key_here"
}
}
}
}npx -y @smithery/cli install alterlab-mcp-server --client claudeALTERLAB_API_KEY field in your MCP configalterlab_scrape — Scrape Any WebpageScrape a URL and return its content as markdown, text, HTML, or JSON. Automatically handles anti-bot protection with tier escalation. Returns markdown by default — optimized for LLM context windows.
"Scrape https://www.amazon.com/dp/B0BSHF7WHW and summarize the product"| Parameter | Type | Default | Description |
|---|---|---|---|
url | string | required | URL to scrape |
mode | auto | html | js | pdf | ocr | auto | Scraping mode |
method / body / content_type / headers | enum / string / enum / object | GET | POST support (1.5x cost) and custom target headers |
formats | (text|json|json_v2|html|markdown|rag|content|raw)[] | ["markdown"] | Output formats |
extraction_schema / extraction_prompt | object / string | — | LLM extraction (+$0.001) |
extraction_profile / extraction_template | enum | — | auto, product, article, job_posting, faq, recipe, event, ecommerce_homepage, directory_listing (template is a deprecated alias) |
extraction_provider / extraction_model | enum / string | — | BYOK LLM selection |
evidence, promote_schema_org, filter_content | boolean | — | Extraction behaviour |
cache, cache_ttl, force_refresh | boolean / number / boolean | — | Response caching (cache_ttl 60-86400) |
render_js | boolean | "auto" | API default | Headless browser (forces Browser tier, $0.004) |
use_proxy, proxy_country | boolean, string | — | Premium proxy (+$0.0002) and geo-targeting |
use_own_proxy, use_system_proxy, proxy_integration_id | boolean, boolean, string | — | Bring-your-own-proxy selection |
skip_tls_verification | boolean | — | Omit (recommended) = verify, fall back on invalid certs; true skip, false require valid cert |
wait_for, wait_until, wait_condition | string | — | Selector / load-event waits |
actions | object[] (max 20) | — | Browser actions: wait, wait_for, click, fill, press, scroll, infinite_scroll, screenshot, evaluate |
screenshot, generate_pdf, ocr | boolean | — | Add-ons (+$0.0002 / +$0.0004 / +$0.001) |
scroll_to_load, scroll_count, enable_scroll | boolean / 1-10 / boolean | — | Lazy-load handling |
include_iframes, flatten_shadow_dom, block_images, remove_cookie_banners | boolean | — | Rendering options |
section_filter | object | — | Filter for json_v2 sections |
session_id, cookies, session_headers | UUID, object, object | — | Authenticated scraping |
sticky_session, sticky_session_ttl | string, 300-7200 | — | Reuse cookies and exit IP across calls (paid plans) |
location | {country, language} | — | Geo-targeting |
cost_controls | object | — | force_tier, max_tier, max_credits, prefer_cost, prefer_speed, fail_fast, time_budget (prefer_cost, prefer_speed, fail_fast also accepted at top level) |
embeddings | object | — | enabled, model, chunk_size, chunk_overlap (+$0.001/page) |
sync_policy | auto | wait_until_deadline | auto | Wait behaviour for long scrapes |
timeout, max_response_bytes, include_raw_html | number, number, boolean | 90, 5 MB, false | Limits and raw output |
estimate_first | boolean | false | Run a free cost estimate first |
Not exposed: source (dashboard tracking tag), sync (the tool is always synchronous), webhook_url (use alterlab_batch/alterlab_crawl webhooks). If a scrape outlives the ~85s synchronous window the tool returns a job_id; fetch it with alterlab_get_job.
alterlab_extract — Extract Structured DataExtract structured fields from HTML, text or markdown content using pre-built profiles or custom JSON Schema. Returns clean JSON — ready for databases, spreadsheets, or downstream processing.
"Extract the product name, price, and rating from this Amazon page"| Parameter | Type | Default | Description |
|---|---|---|---|
content | string (max 500,000) | required | HTML, text or markdown you already have (this tool does not fetch a URL) |
content_type | html | text | markdown | html | Type of content |
extraction_profile / extraction_template | enum | — | Profile: auto, product, article, job_posting, faq, recipe, event, ecommerce_homepage, directory_listing |
extraction_schema | object | — | Custom JSON Schema for structured output |
extraction_prompt | string | — | Natural language extraction instructions |
extraction_provider / extraction_model | enum / string | — | BYOK LLM selection |
formats | enum[] | ["json"] | Output formats |
source_url, evidence | string, boolean | — | Context URL and provenance |
cache, cache_ttl | auto | skip | only, number | auto | Extraction result cache |
To scrape and extract in one step, use alterlab_scrape with extraction_schema.
Extraction profiles:
alterlab_screenshot — Screenshot Any PageTake a full-page screenshot of any URL. Returns a PNG image directly in the conversation — no URLs to copy, no files to download.
"Take a screenshot of our landing page at https://alterlab.io"| Parameter | Type | Default | Description |
|---|---|---|---|
url | string | required | URL to screenshot |
wait_for | string | — | CSS selector to wait for before capture |
wait_until | enum | networkidle | networkidle, domcontentloaded, or load |
timeout | number | 90 | Timeout in seconds (1-300) |
use_proxy, proxy_country | boolean, string | — | Premium proxy and geo-targeting |
session_id, cookies | UUID, object | — | Screenshot pages behind a login |
location | {country, language} | — | Geo-targeting |
alterlab_estimate_cost — Estimate Before You ScrapeCheck how much a scrape will cost before running it. Returns the predicted tier, cost per request, and confidence level.
"How much would it cost to scrape linkedin.com?"| Parameter | Type | Default | Description |
|---|---|---|---|
url | string | required | URL to estimate |
mode | enum | auto | Scraping mode |
method | GET | POST | GET | POST costs 1.5x |
render_js | boolean | "auto" | false | Include JS rendering cost |
use_proxy, use_own_proxy | boolean | false | Include proxy cost / BYOP discount |
screenshot, generate_pdf, ocr | boolean | — | Include add-on cost |
alterlab_get_job — Fetch an Async JobFetch the status and result of a scrape that returned a job_id (a scrape that outlived the synchronous wait window). Parameter: job_id (string, required).
alterlab_check_balance — Check Your CreditsCheck your account balance, total deposited, and total spent. No parameters needed.
"Check my AlterLab balance"alterlab_list_sessions — List Stored SessionsList all stored sessions for authenticated scraping. Sessions contain cookies for specific domains, allowing you to scrape content behind login walls.
"List my stored sessions"alterlab_create_session — Create a SessionCreate a new stored session with cookies from a logged-in browser. The session is stored securely and can be reused across multiple scrape requests.
"Create an Amazon session with these cookies: session-id=abc123, session-token=xyz789"| Parameter | Type | Default | Description |
|---|---|---|---|
name | string | required | Human-readable name (e.g., "My Amazon Account") |
domain | string | required | Domain (e.g., "amazon.com") |
consent | boolean | required | Must be true: explicit GDPR consent to store the cookies (the API rejects creation otherwise) |
cookies | Record<string,string> | cookie objects[] | — | Cookies as key-value pairs or {name, value, domain, path, ...} objects |
headers | Record<string,string> | — | Custom headers (e.g. a User-Agent) |
expires_at, notes | string | — | Expiry (ISO 8601) and notes |
auto_refresh_enabled, notify_before_expiry, notify_on_failure | boolean | true | Health checks and notifications |
organization_id, shared | UUID, boolean | — | Organization sharing |
alterlab_validate_session — Validate a SessionCheck whether a stored session is still active and its cookies are valid.
"Is my Amazon session still valid?"| Parameter | Type | Default | Description |
|---|---|---|---|
session_id | string (UUID) | required | Session ID to validate |
alterlab_delete_session — Delete a SessionPermanently delete a stored session and its cookies.
"Delete session abc-123-def"| Parameter | Type | Default | Description |
|---|---|---|---|
session_id | string (UUID) | required | Session ID to delete |
AlterLab MCP supports scraping pages that require authentication. This enables AI agents to access user-specific content like order histories, account dashboards, and member-only pricing.
alterlab_create_sessionsession_id to alterlab_scrapeUser: "What's my Prime member price for this product?"
Claude: [calls alterlab_list_sessions → finds Amazon session]
Claude: [calls alterlab_scrape with session_id for authenticated pricing]
Claude: "The Prime member price is $24.99 (public price: $34.99)"session_id): Best for repeated access to the same domain. Create once, reuse across requests.cookies): Best for one-off authenticated requests where you don't need to save the session.Ask Claude to scrape and analyze websites in real-time:
Let Cursor or Windsurf fetch live data while building:
Use Claude to analyze content at scale:
Build agentic workflows that watch the web:
No subscriptions. No monthly minimums. Add balance and use it whenever you need it.
| Tier | Method | Cost per Request | Use Case |
|---|---|---|---|
| Curl | Direct HTTP | $0.0002 | Static pages, RSS feeds, public APIs |
| HTTP | TLS fingerprinting | $0.0003 | Sites with basic bot detection |
| Stealth | Browser impersonation | $0.002 | Cloudflare, DataDome, PerimeterX protected sites |
| Light JS | JSON extraction | $0.0025 | Server-rendered pages needing structured data |
| Browser | Headless Chromium | $0.004 | Full JavaScript SPAs (React, Angular, Vue) |
| Add-On | Extra Cost | Description |
|---|---|---|
| JavaScript Rendering | forces Browser tier | No separate add-on: render_js bills the Browser tier ($0.004) |
| PDF Generation | +$0.0004 | PDF of the rendered page |
| LLM Extraction / Embeddings | +$0.001 | extraction_schema / extraction_prompt, embeddings |
| POST requests | x1.5 | method: "POST" costs 1.5x the tier price |
| Own proxy (BYOP) | -20% | use_own_proxy discount on the tier price |
| Search | $0.001 / $0.004 | duckduckgo / google and bing engines |
| Screenshot Capture | +$0.0002 | Full-page PNG screenshot |
| Premium Proxy | +$0.0002 | Geo-targeted residential proxy (195+ countries) |
| OCR Text Extraction | +$0.001 | Extract text from images on the page |
$1 = 5,000 light scrapes. New accounts get $1 free balance on signup.
| Variable | Required | Default | Description |
|---|---|---|---|
ALTERLAB_API_KEY | Yes | — | Your API key (get one free) |
ALTERLAB_API_URL | No | https://api.alterlab.io | API base URL (for self-hosted or development) |
Install the AlterLab MCP server. For Claude Code, run claude mcp add alterlab -- npx -y alterlab-mcp-server@latest and set your ALTERLAB_API_KEY. For Claude Desktop, Cursor, or Windsurf, add the JSON config block to your MCP settings file. Once configured, your AI assistant can scrape any URL, extract structured data, and take screenshots directly in conversation.
Yes. AlterLab automatically handles Cloudflare, DataDome, PerimeterX, Akamai, and other anti-bot systems. It uses a multi-tier approach that starts with the cheapest method and escalates only when blocked. You don't need to configure anything — anti-bot bypass is fully automatic.
MCP (Model Context Protocol) is Anthropic's open standard for connecting AI assistants to external tools and data sources. An MCP server is a small program that exposes tools — like web scraping — that Claude, Cursor, or Windsurf can call during a conversation. The AlterLab MCP server gives your AI assistant 23 tools: scrape, extract, screenshot, crawl, search, map, batch scraping, session management, beta features, and more.
AlterLab starts at $0.0002 per request — 5-20x cheaper than most scraping APIs — because it only uses expensive browser rendering when a site actually requires it. Smart tier escalation means you pay for what each site needs, not the maximum. AlterLab also includes built-in structured data extraction with pre-built profiles (product, article, job posting, etc.).
Yes. AlterLab handles all major e-commerce anti-bot protection. Use the alterlab_extract tool with extraction_profile: "product" to get structured JSON: product name, price, currency, rating, review count, availability, and images — ready for analysis, comparison, or data pipelines.
Yes. With AlterLab MCP installed in Cursor, you can ask it to scrape API documentation, library docs, or any reference page and generate TypeScript types, API clients, or component code from the live content. This is more reliable than relying on the LLM's training data, which may be outdated.
Yes. Use render_js: true or set mode: "js" to enable full headless Chromium rendering. AlterLab renders the complete page including all JavaScript, waits for dynamic content to load, then extracts content from the fully rendered DOM. This works for React, Angular, Vue, Next.js, and any other JavaScript framework.
Use markdown (the default). It preserves document structure — headings, tables, lists, links — while being 60-80% smaller than raw HTML. Claude, GPT-4, and other LLMs process markdown significantly better than HTML. AlterLab's markdown output is specifically optimized for LLM context windows.
Free-tier accounts have rate limits. Adding any balance removes rate limits. The MCP server includes automatic retry with exponential backoff for transient rate limit errors (429).
Yes. For parallel scraping, use alterlab_batch to scrape up to 100 URLs in a single request — much faster than sequential calls. For crawling entire domains, use alterlab_crawl. You can also build agentic workflows that scrape many URLs sequentially, or use the n8n integration for workflow automation.
The MCP server returns helpful error messages with suggested next actions:
| Error | What Happens | Suggested Action |
|---|---|---|
| 401 Unauthorized | Invalid API key | Check ALTERLAB_API_KEY is set correctly |
| 402 Insufficient Credits | Balance too low | Run alterlab_check_balance, add funds |
| 403 Forbidden | Site blocked the request | Try render_js: true + use_proxy: true |
| 429 Rate Limited | Too many requests | Automatic retry with backoff |
| 504 Gateway Timeout | Scrape took too long | Increase timeout, simplify request |
AlterLab MCP turns any AI agent into a web-capable agent. Instead of relying on stale training data, your agent can fetch live information from any website during execution.
Works with any tool that supports MCP (Model Context Protocol):
git clone https://github.com/RapierCraft/alterlab-mcp-server.git
cd alterlab-mcp-server
npm install
npm run buildPick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add alterlab -- npx -y alterlab-mcp-server@latest{
"mcpServers": {
"alterlab": {
"env": {
"ALTERLAB_API_KEY": ""
},
"args": [
"-y",
"alterlab-mcp-server@latest"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"alterlab","env":{"ALTERLAB_API_KEY":""},"args":["-y","alterlab-mcp-server@latest"],"command":"npx"}'[mcp_servers.alterlab]
command = "npx"
args = ["-y", "alterlab-mcp-server@latest"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/alterlab-mcp-server to learn what the "Alterlab Mcp Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add alterlab -- npx -y alterlab-mcp-server@latestnpx -y @smithery/cli install alterlab-mcp-server --client claude| Name | What it does |
|---|---|
alterlab_scrape | Scrape any website with anti-bot bypass and proxy rotation. Returns clean text, HTML, markdown, or JSON. |
alterlab_extract | Extract structured data from HTML, text or markdown you already have, using profiles, a JSON schema or a prompt. |
alterlab_screenshot | Take a full-page screenshot of any webpage, with optional proxy, session and wait controls. |
alterlab_get_job | Fetch the status and result of an asynchronous scrape job by job_id. |
alterlab_estimate_cost | Estimate the credit cost of a scrape before running it. |
alterlab_check_balance | Check your current account balance and credit usage. |
alterlab_get_usage | Get account usage for the current billing period: balance, credits used, tier and entitlement source. |
alterlab_crawl | Start a full website crawl for RAG indexing or knowledge base building. Returns a crawl_id for async polling. |
alterlab_crawl_status | Poll the status and results of an ongoing or completed crawl. |
alterlab_crawl_cancel | Cancel an ongoing crawl and refund unused credits. |
alterlab_search | Search the web across Google/Bing/DuckDuckGo. Returns URLs, titles, and snippets. |
alterlab_map | Discover all URLs on a website without scraping content. Returns a URL map for planning crawls. |
alterlab_batch | Submit a batch of URLs to scrape asynchronously. Returns a batch_id for polling. |
alterlab_batch_status | Poll the status and results of an asynchronous batch scrape job. |
alterlab_list_sessions | List all active authenticated browser sessions. |
alterlab_create_session | Create a new authenticated browser session with cookies for logged-in scraping. |
alterlab_get_session | Get details of a specific authenticated session. |
alterlab_update_session | Update cookies or settings on an existing session. |
alterlab_refresh_session | Refresh an authenticated session to extend its lifetime. |
alterlab_validate_session | Validate that a session's cookies are still active and working. |
alterlab_delete_session | Delete an authenticated browser session. |
alterlab_list_beta_features | List all available beta features with their opt-in status. |
alterlab_list_my_beta_features | List beta features you have opted into. |
alterlab_enable_beta_feature | Enable a beta feature by its slug. |
alterlab_disable_beta_feature | Disable a beta feature by its slug. |
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/alterlab-mcp-server)Nothing comparable is listed yet.
v1.13.26Release notesv1.13.25Release notesv1.13.24Release notesv1.13.23Release notesv1.13.22Release notesv1.13.21Release notesv1.13.20Release notesv1.13.19Release notesv1.13.18Release notesv1.13.17Release notesv1.13.16Release notesv1.13.15Release notesv1.13.14Release notesv1.13.13Release notesv1.13.12Release notesv1.13.11Release notesv1.13.10Release notesv1.13.9Release notesv1.13.8Release notesv1.13.7Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "alterlab-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.