What can you do with this server?

The ScraperAPI MCP server enables web scraping, structured data extraction, site crawling, and AI-powered parsing — all bypassing anti-bot protections (CAPTCHAs, IP blocks). General Web Scraping * Fetch any web page or image with optional JavaScript rendering, geo-targeting, premium proxies, device emulation, and output formats (markdown, text, CSV, JSON) Structured Data Endpoints (SDEs) Pre-parsed, structured data from major platforms — no manual HTML parsing needed: * Google: Search (SERP), News, Jobs, Shopping, Maps * Amazon: Product details (by ASIN), search results, seller offers * Walmart: Search, product details (by ID), category browsing, customer reviews * eBay: Search, product details (by item ID) * Redfin: For-sale/rental property listings, search results, agent profiles Web Crawling * Start asynchronous crawl jobs from a seed URL, following links to a configurable depth or credit budget * Control URL inclusion/exclusion via regex, receive results via webhooks, and poll or cancel jobs AI-Powered Custom Parsing * Create reusable AI parsers from 1–3 example URLs to extract structured JSON from similar pages * Manage parsers: create, retrieve status/details, apply to new URLs, list, update fields, or delete Configuration * Behavior is customizable via environment variables: API key, request timeout, rate limits, and image size limits

Which integrations are available for this server?

Provides tools for retrieving structured product details, search results, and seller offers from Amazon, enabling programmatic product research and price monitoring. Provides tools for retrieving structured listing details and search results from eBay, useful for product discovery and market research. Provides tools for retrieving structured Google Search, Jobs, and Shopping results, enabling SERP analysis, job listing aggregation, and product price comparison. Provides a tool for retrieving structured local business/place results from Google Maps based on a query and geographic coordinates. Provides a tool for retrieving structured news article results from Google News, with support for date filtering and time windows. Provides tools for retrieving structured product details, search results, category browsing, and customer reviews from Walmart, enabling product research and sentiment analysis.

de en es ja ko ru zh

scraperapi-mcp-server

Official

by scraperapi

Overview Schema Related Servers Score Discussions

Python

Remote

ScraperAPI MCP server

The ScraperAPI MCP server enables LLM clients to retrieve and process web scraping requests using the ScraperAPI services.

This is the self-hosted (local) server. A hosted (remote) version is also available.

pypi package License

scraperapi-mcp-server MCP server

Related MCP server: ma-browser

Features

Full implementation of the Model Context Protocol specification
Seamless integration with ScraperAPI for web scraping
Simple setup with Python or Docker

Architecture

          ┌───────────────┐     ┌───────────────────────┐     ┌───────────────┐
          │  LLM Client   │────▶│  Scraper MCP Server   │────▶│    AI Model   │
          └───────────────┘     └───────────────────────┘     └───────────────┘
                                            │
                                            ▼
                                  ┌──────────────────┐
                                  │  ScraperAPI API  │
                                  └──────────────────┘

Installation

The ScraperAPI MCP Server is designed to run as a local server on your machine, your LLM client will launch it automatically when configured.

Prerequisites

Python 3.11+
Docker (optional)

Using Python

Install the package:

pip install scraperapi-mcp-server

Add this to your client configuration file:

{
  "mcpServers": {
    "ScraperAPI": {
      "command": "python",
      "args": ["-m", "scraperapi_mcp_server"],
      "env": {
        "API_KEY": "<YOUR_SCRAPERAPI_API_KEY>"
      }
    }
  }
}

Using Docker

Add this to your client configuration file:

{
  "mcpServers": {
    "ScraperAPI": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "API_KEY=${API_KEY}",
        "--rm",
        "scraperapi-mcp-server"]
    }
  }
}

TIP

If your command is not working (for example, you see a package not found error when trying to start the server), double-check the path you are using. To find the correct path, activate your virtual environment first, then run:

which <YOUR_COMMAND>

Available tools

API

Retrieve the content of a web page, or download an image, from a URL.

Parameter	Type	Description	Required
`url`	string	Target URL to scrape	Yes
`render`	boolean	Enable JavaScript rendering for dynamic pages (default: `false`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No
`premium`	boolean	Use premium residential/mobile proxies (default: `false`)	No
`ultra_premium`	boolean	Advanced anti-bot bypass; incompatible with `premium` (default: `false`)	No
`device_type`	string	`mobile` or `desktop` user agent	No
`output_format`	string	`markdown` (default), `text`, `csv`, or `json`	No
`autoparse`	boolean	Auto-parse supported sites into structured data (default: `false`)	No

Returns: the scraped content as a string, or image data for image URLs.

SDEs

Structured Data Endpoints (SDEs) return pre-parsed JSON (or CSV) instead of raw HTML. Every SDE tool also accepts output_format (json by default, or csv), tld, and country_code, shown in each tool's table.

Google

Parameter	Type	Description	Required
`query`	string	Search query, as typed into Google	Yes
`num`	integer	Number of results to return on the page	No
`start`	integer	Zero-based result offset for pagination	No
`hl`	string	Interface/host language code (e.g. `en`, `es`)	No
`gl`	string	Country edition to search (2-letter code)	No
`uule`	string	Google `uule` geolocation string (advanced)	No
`date_range_start`	string	Start of a custom date range, `MM/DD/YYYY`	No
`date_range_end`	string	End of a custom date range, `MM/DD/YYYY`	No
`time_period`	string	Recent window: `1H`, `1D`, `1W`, `1M`, or `1Y`	No
`include_html`	boolean	Include raw HTML alongside parsed data (default: `false`)	No
`tbs`	string	Raw Google `tbs` filter parameter (advanced)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Top-level domain (e.g. `com`, `co.uk`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`query`	string	Search query	Yes
`num`	integer	Number of results to return on the page	No
`start`	integer	Zero-based result offset for pagination	No
`hl`	string	Interface/host language code	No
`gl`	string	Country edition to search (2-letter code)	No
`uule`	string	Google `uule` geolocation string (advanced)	No
`date_range_start`	string	Start of a custom date range, `MM/DD/YYYY`	No
`date_range_end`	string	End of a custom date range, `MM/DD/YYYY`	No
`time_period`	string	Recent window: `1H`, `1D`, `1W`, `1M`, or `1Y`	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Top-level domain (e.g. `com`, `co.uk`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`query`	string	Search query	Yes
`num`	integer	Number of results to return on the page	No
`start`	integer	Zero-based result offset for pagination	No
`hl`	string	Interface/host language code	No
`gl`	string	Country edition to search (2-letter code)	No
`uule`	string	Google `uule` geolocation string (advanced)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Top-level domain (e.g. `com`, `co.uk`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`query`	string	Search query	Yes
`num`	integer	Number of results to return on the page	No
`start`	integer	Zero-based result offset for pagination	No
`hl`	string	Interface/host language code	No
`gl`	string	Country edition to search (2-letter code)	No
`uule`	string	Google `uule` geolocation string (advanced)	No
`include_html`	boolean	Include raw HTML alongside parsed data (default: `false`)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Top-level domain (e.g. `com`, `co.uk`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`query`	string	Search query (e.g. `coffee shops in Austin`)	Yes
`latitude`	number	Latitude of the map center, in decimal degrees	Yes
`longitude`	number	Longitude of the map center, in decimal degrees	Yes
`zoom`	integer	Map zoom level (roughly 3=country, 10=city, 15=street)	No
`include_html`	boolean	Include raw HTML alongside parsed data (default: `false`)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Top-level domain (e.g. `com`, `co.uk`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Amazon

Parameter	Type	Description	Required
`asin`	string	10-character Amazon product identifier (e.g. `B08N5WRWNW`)	Yes
`language`	string	Language code for localized content (e.g. `en_US`)	No
`include_html`	boolean	Include raw HTML alongside parsed data (default: `false`)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Amazon TLD (e.g. `com`, `co.uk`, `de`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`query`	string	Search query, as typed into Amazon	Yes
`page`	integer	1-based results page number	No
`sort_by`	string	Sort order (e.g. `price-asc-rank`, `review-rank`)	No
`department`	string	Restrict search to a department/category (e.g. `electronics`)	No
`ref`	string	Amazon `ref` referral/context token (advanced)	No
`language`	string	Language code for localized content	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Amazon TLD (e.g. `com`, `co.uk`, `de`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`asin`	string	10-character Amazon product identifier	Yes
`condition`	string	Comma-separated condition filters (e.g. `f_new,f_usedlikenew,f_usedverygood,f_usedgood,f_usedacceptable`)	No
`f_new`	boolean	Include only New-condition offers	No
`f_used_like_new`	boolean	Include Used - Like New offers	No
`f_used_very_good`	boolean	Include Used - Very Good offers	No
`f_used_good`	boolean	Include Used - Good offers	No
`f_used_acceptable`	boolean	Include Used - Acceptable offers	No
`language`	string	Language code for localized content	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Amazon TLD (e.g. `com`, `co.uk`, `de`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Walmart

Parameter	Type	Description	Required
`query`	string	Product search query, as typed into Walmart	Yes
`page`	integer	1-based results page number	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Walmart TLD (e.g. `com`, `ca`, `com.mx`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`product_id`	string	Walmart product ID	Yes
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Walmart TLD (e.g. `com`, `ca`, `com.mx`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`category`	string	Walmart category ID	Yes
`page`	integer	1-based results page number	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Walmart TLD (e.g. `com`, `ca`, `com.mx`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`product_id`	string	Walmart product ID	Yes
`page`	integer	1-based results page number	No
`sort`	string	Sort order (e.g. `helpful`, `recent`)	No
`ratings`	string	Comma-separated star ratings to filter by (e.g. `4,5`)	No
`verified_purchase`	boolean	Include only reviews with a "Verified Purchase" badge (default: `false`)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Walmart TLD (e.g. `com`, `ca`, `com.mx`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

eBay

Parameter	Type	Description	Required
`query`	string	Search keywords	Yes
`page`	integer	1-based results page number	No
`items_per_page`	integer	Number of items per page	No
`seller_id`	string	Restrict results to a specific seller	No
`condition`	string	Comma-separated: `new`, `used`, `open_box`, `refurbished`, `for_parts`, `not_working`	No
`buying_format`	string	`buy_it_now`, `auction`, or `accepts_offers`	No
`show_only`	string	Comma-separated: `returns_accepted`, `authorized_seller`, `completed_items`, `sold_items`, `sale_items`, `listed_as_lots`, `search_in_description`, `benefits_charity`, `authenticity_guarantee`	No
`sort_by`	string	`best_match`, `ending_soonest`, `newly_listed`, `price_lowest`, `price_highest`, or `distance_nearest`	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	eBay TLD (e.g. `com`, `co.uk`, `de`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`product_id`	string	eBay item ID	Yes
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	eBay TLD (e.g. `com`, `co.uk`, `de`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Redfin

Every Redfin tool takes a full Redfin URL matching the tool (property, search, or agent page).

Parameter	Type	Description	Required
`url`	string	Full Redfin for-sale property URL	Yes
`raw`	boolean	Return raw extracted JSON instead of parsed data (default: `false`)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Redfin TLD (`com`, `ca`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`url`	string	Full Redfin rental property URL	Yes
`raw`	boolean	Return raw extracted JSON instead of parsed data (default: `false`)	No
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Redfin TLD (`com`, `ca`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`url`	string	Full Redfin search-results URL (with filters)	Yes
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Redfin TLD (`com`, `ca`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Parameter	Type	Description	Required
`url`	string	Full Redfin agent profile URL	Yes
`output_format`	string	`json` (default) or `csv`	No
`tld`	string	Redfin TLD (`com`, `ca`)	No
`country_code`	string	ISO 2-letter country code for geo-targeting	No

Crawler

The crawler is asynchronous: crawler_job_start returns a job id immediately, then you poll crawler_job_status until the crawl finishes. Per-page results can also be pushed to a callback_url webhook.

Parameter	Type	Description	Required
`start_url`	string	The URL where crawling begins (depth 0)	Yes
`url_regexp_include`	string	Regex selecting which links to follow. Use `.*` to crawl all links. Advanced: named groups `(?<full_url>...)` / `(?<relative_url>...)` target absolute vs relative URLs	Yes
`max_depth`	integer	Maximum crawl depth (start URL is depth 0). Provide `max_depth` or `crawl_budget`	No*
`crawl_budget`	integer	Maximum ScraperAPI credits the crawl may consume. Provide `max_depth` or `crawl_budget`	No*
`url_regexp_exclude`	string	Regex for URLs to exclude from crawling	No
`api_params`	object	Per-scrape controls applied to each page (e.g. `render`, `country_code`, `premium`, `device_type`, `output_format`)	No
`callback_url`	string	Webhook URL to receive per-page results and the final summary	No
`additional_data`	object	Arbitrary metadata to attach to the job	No
`schedule`	object	Recurring schedule: `{ name, interval (once/hourly/daily/weekly/monthly), cron }`	No
`enabled`	boolean	For scheduled projects, whether the schedule is enabled (default: `true`)	No

* Provide either max_depth or crawl_budget.

Returns: JSON with the job id and initial status (e.g. {"status": "initiated", "jobId": "..."}).

Parameter	Type	Description	Required
`job_id`	string	The job id returned by `crawler_job_start`	Yes

Returns: JSON with the job's page counts (done/failed/active).

Parameter	Type	Description	Required
`job_id`	string	The job id returned by `crawler_job_start`	Yes

AI Parser

Build a reusable parser from a few example URLs, then apply it to any similar page for structured extraction. Two-phase: ai_parser_create returns a parser id immediately and generation runs in the background — poll ai_parser_get_details until its status is FINISHED, then call ai_parser_parse_url.

Parameter	Type	Description	Required
`name`	string	A name for the parser	Yes
`urls`	array<string>	1–3 example URLs of the same page type (same structure)	Yes
`scraper_params`	object	ScraperAPI fetch options for the example pages: `render`, `country_code`, `premium`, `session_number`, `keep_headers`, `device_type`, `ultra_premium`, `follow_redirect`, `retry_404`	No
`fields`	array	Pre-declared fields to extract: `[{ name, description, type?, selector? }]` (`type` is `string`/`number`/`array`). If omitted, fields are inferred	No

Returns: JSON with the new parser's id and version. Generation is asynchronous — poll ai_parser_get_details until status is FINISHED.

Parameter	Type	Description	Required
`parser_id`	string	The parser id returned by `ai_parser_create`	Yes
`version`	integer	Specific parser version (default: latest)	No

Returns: JSON with the parser's status (GENERATING/FINISHED/FAILED), fields, and example results.

Parameter	Type	Description	Required
`parser_id`	string	The parser id to run	Yes
`url`	string	The URL to scrape and parse	Yes
`version`	integer	Specific parser version (default: latest)	No

Returns: JSON {"parser": ..., "version": ..., "result": {...}}. Costs 1 credit per call.

No parameters. Returns a JSON array of parser summaries (id, name, status, version, generation time).

Parameter	Type	Description	Required
`parser_id`	string	The parser id to delete	Yes

Parameter	Type	Description	Required
`parser_id`	string	The parser id to update	Yes
`version`	integer	Version to base the update on (default: latest)	No
`add_fields`	array	Fields to add: `[{ name, description, type?, selector? }]` (triggers async regeneration)	No
`modify_fields`	array	Fields to modify (triggers async regeneration)	No
`rename_fields`	array	Renames: `[{ name, new_name }]` (applied immediately)	No
`remove_fields`	array<string>	Field names to remove (applied immediately)	No

Prompt templates

Please scrape this URL <URL>. If you receive a 500 server error identify the website's geo-targeting and add the corresponding country_code to overcome geo-restrictions. If errors continues, upgrade the request to use premium proxies by adding premium=true. For persistent failures, activate ultra_premium=true to use enhanced anti-blocking measures.
Can you scrape URL <URL> to extract <SPECIFIC_DATA>? If the request returns missing/incomplete <SPECIFIC_DATA>, set render=true to enable JS Rendering.

Configuration

Settings

Configure the server through environment variables. Only API_KEY is required.

Variable	Default	Description
`API_KEY`	—	Required. Your ScraperAPI API key.
`API_TIMEOUT_SECONDS`	`70`	Per-request timeout, in seconds.
`RATE_LIMIT_MAX_CALLS`	`10`	Maximum tool calls allowed per rate-limit window.
`RATE_LIMIT_WINDOW_SECONDS`	`60`	Length of the rate-limit window, in seconds.
`IMAGE_SIZE_LIMIT_BYTES`	`700000`	Maximum size of an image the `scrape` tool returns inline.

Client Setup

Use the JSON configuration file from the Installation section. Below are steps for common clients.

Claude Desktop:

Open Claude Desktop and click the settings icon
Select the "Developer" tab
Click "Edit Config" and paste the JSON configuration file

Claude Code:

Add the server manually to your .claude/settings.json with the JSON configuration file, or run:

claude mcp add scraperapi -e API_KEY=<YOUR_SCRAPERAPI_API_KEY> -- python -m scraperapi_mcp_server

Open Cursor
Access the Settings Menu
Open Cursor Settings
Go to Tools & Integrations section
Click '+ Add MCP Server'
Choose Manual and paste the JSON configuration file

More here

Open Windsurf
Access the Settings Menu
Click on the Cascade settings
Click on the MCP server section
Click on the gear icon, the mcp_config.json file will open
Paste the JSON configuration file

More here

Open VS Code and click the Cline icon in the activity bar to open the Cline panel
Click the MCP Servers icon in the top navigation bar of the Cline pane
Select the "Configure" tab
Click "Configure MCP Servers" at the bottom of the pane — this opens cline_mcp_settings.json
Paste the JSON configuration file

More here

Development

Local setup

Clone the repository:

git clone https://github.com/scraperapi/scraperapi-mcp
cd scraperapi-mcp

Install dependencies:

Using Poetry:
```
poetry install
```

Using pip:

# Create virtual environment and activate it
python -m venv .venv
source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows

# Install the local package in editable mode
pip install -e .

Using Docker:

# Build the Docker image locally
docker build -t scraperapi-mcp-server .

Run the server

Using Python:
```
python -m scraperapi_mcp_server
```

Using Docker:

# Run the Docker container with your API key
docker run -e API_KEY=<YOUR_SCRAPERAPI_API_KEY> scraperapi-mcp-server

Debug

python3 -m scraperapi_mcp_server --debug

Testing

This project uses pytest for testing.

Install Test Dependencies

Using Poetry:
```
poetry install --with dev
```

Using pip:

pip install -e .
pip install pytest pytest-mock pytest-asyncio

Running Tests

# Run All Tests
pytest

# Run Specific Test
pytest <TEST_FILE_PATH>

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2moRelease cycle

3Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

ISIS MCP
RAG Systems Web Scraping Search
alucardeht
A
license
B
quality
D
maintenance
A local web scraping MCP server with RAG capabilities that provides intelligent web search, content extraction, and screenshot tools without requiring API keys.
Last updated 2026-02-25
4
28
MIT
ma-browser
Browser Automation Web Scraping
zzhan111
A
license
-
quality
D
maintenance
MCP server that lets AI agents use your real browser as an API, accessing any website with your login state, no keys or scrapers needed.
Last updated 2026-06-24
MIT
better-fetch
Browser Automation Web Scraping
dhruvparmar372
A
license
-
quality
D
maintenance
An MCP server that gives AI tools a reliable way to fetch content from the web, handling anti-bot protection and JavaScript-rendered pages.
Last updated 2026-02-10
836
MIT
freecrawl
Web Scraping Browser Automation Search
RistrixOP
F
license
-
quality
C
maintenance
Open-source web scraping MCP server with anti-bot bypass, enabling AI models to scrape, crawl, search, and extract data from any website without API keys or limits.
Last updated 2026-07-06

View all related MCP servers

Related MCP Connectors

driflyte-mcp-server
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Remote Desktop Commander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
gread
An MCP server that gives your AI access to the source code and docs of all public github repos

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/scraperapi/scraperapi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

ScraperAPI MCP server

Table of Contents

Features

Architecture

Installation

Prerequisites

Using Python

Using Docker

Available tools

API

SDEs

Google

Amazon

Walmart

eBay

Redfin

Crawler

AI Parser

Prompt templates

Configuration

Settings

Client Setup

Development

Local setup

Run the server

Debug

Testing

Install Test Dependencies

Running Tests

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

ISIS MCP

ma-browser

better-fetch

freecrawl

Related MCP Connectors

Latest Blog Posts

MCP directory API