ScrAPI

The ScrAPI MCP Server lets you use ScrAPI to scrape web pages via a managed MCP interface. It provides convenient endpoints to fetch page content as HTML or Markdown, handling bot-detection, captchas, and geolocation challenges so you can reliably extract data for your applications.

How to use

Connect to one or more MCP servers from your MCP client and start scraping pages with either HTML or Markdown output. You can pass an optional set of browser commands to interact with the page before scraping, such as clicking buttons, filling forms, or scrolling to load dynamic content.

Two primary actions are available: scrape a URL and receive HTML content suitable for parsing, or scrape a URL and receive Markdown content for text-focused extraction. Each action accepts a target URL and an optional JSON array of browser commands to execute prior to scraping. If you need dynamic interactions, prepare a commands array that matches your page behavior.

Cloud MCP endpoints are available for testing and integration. You can use the HTTP MCP URL to connect from any MCP-compatible client, or run local MCP servers via Docker or NPX for development and testing.

How to install

Prerequisites you need: a modern Docker installation or Node.js with npm for NPX usage. You may also want an API key if you plan to use the cloud MCP endpoint.

Option A — Run ScrAPI MCP Server with Docker

:```
docker run -i --rm -e SCRAPI_API_KEY=YOUR_API_KEY deventerprisesoftware/scrapi-mcp

Option B — Run ScrAPI MCP Server with NPX

:```
npx -y @deventerprisesoftware/scrapi-mcp

Option C — Use the cloud MCP endpoints for testing and integration. You can connect to the HTTP MCP URL from your MCP client to use ScrAPI without running a local server. The cloud endpoints are suitable for quick experiments and integration checks.

Configuration and notes

Environment variable you will commonly provide when running locally or via the cloud: SCRAPI_API_KEY. This key authenticates requests to the ScrAPI MCP services and should be kept secure.

For local runs, include your API key in the environment where you start the server. For example, when using Docker, set SCRAPI_API_KEY or provide it through your orchestration environment.

Available tools

scrape_url_html

Use a URL to scrape a website via ScrAPI and retrieve the result as HTML. Useful when bot detection, captchas, or geolocation restrict content access. Returns HTML content.

scrape_url_markdown

Use a URL to scrape a website via ScrAPI and retrieve the result as Markdown. Useful when the page content is important but structural HTML is less critical. Returns Markdown content.