Scrapi Mcp Server

What is Scrapi Mcp Server about?

Scrapi Mcp Server offers a Model Context Protocol (MCP) endpoint that forwards scrape requests to the ScrAPI service. It abstracts away bot‑detection, captchas, and geolocation restrictions, delivering the raw HTML or a Markdown representation of the target page.

How to use Scrapi Mcp Server?

1. Deploy the server via Docker, NPX, or use the hosted cloud instance at https://api.scrapi.dev/sse.
2. Configure an optional API key (environment variable SCRAPI_API_KEY) to increase concurrency limits.
3. Call the two available tools:
   • scrape_url_html – pass a url string and receive the page’s HTML.
   • scrape_url_markdown – pass a url string and receive the page’s content formatted as Markdown.
4. Integrate the MCP endpoint into your application or Claude Desktop configuration as shown in the README.

Key features of Scrapi Mcp Server

• Two scraping modes – HTML for structural parsing, Markdown for pure text extraction.
• Rate‑limit handling – Free tier allows 1 concurrent call and 20 calls/day; adding an API key unlocks higher limits.
• Easy deployment – Docker image (deventerprisesoftware/scrapi-mcp) and one‑line NPX command.
• Cloud option – SSE‑based server available without self‑hosting.
• Claude Desktop integration – Pre‑built config snippets for seamless use.

Use cases of Scrapi Mcp Server

• Extracting product listings from e‑commerce sites that employ anti‑bot measures.
• Gathering article content for summarisation or sentiment analysis.
• Pulling location‑specific data where geolocation restrictions apply.
• Providing raw HTML to downstream parsers that need DOM manipulation.
• Supplying Markdown to LLM pipelines that prefer plain text.

FAQ from the Scrapi Mcp Server

Q: Do I need an API key? A: No, the server works without one but is limited to one concurrent call and 20 free calls per day.

Q: Can I run the server locally? A: Yes, using Docker (docker run -i --rm -e SCRAPI_API_KEY=<YOUR_API_KEY> deventerprisesoftware/scrapi-mcp) or NPX (npx -y @deventerprisesoftware/scrapi-mcp).

Q: How do I pass my API key? A: Set the environment variable SCRAPI_API_KEY when launching the server.

Q: Is there a hosted version? A: A cloud MCP server is accessible via SSE at https://api.scrapi.dev/sse (no API‑key forwarding supported).

Q: What formats are returned? A: scrape_url_html returns raw HTML; scrape_url_markdown returns Markdown.

ScrAPI MCP Server

MCP server for using ScrAPI to scrape web pages.

ScrAPI is your ultimate web scraping solution, offering powerful, reliable, and easy-to-use features to extract data from any website effortlessly.

Tools

1. scrape_url_html

   • Use a URL to scrape a website using the ScrAPI service and retrieve the result as HTML. Use this for scraping website content that is difficult to access because of bot detection, captchas or even geolocation restrictions. The result will be in HTML which is preferable if advanced parsing is required.
   • Input: url (string)
   • Returns: HTML content of the URL

2. scrape_url_markdown

   • Use a URL to scrape a website using the ScrAPI service and retrieve the result as Markdown. Use this for scraping website content that is difficult to access because of bot detection, captchas or even geolocation restrictions. The result will be in Markdown which is preferable if the text content of the webpage is important and not the structural information of the page.
   • Input: url (string)
   • Returns: Markdown content of the URL

Setup

API Key (optional)

Optionally get an API key from the ScrAPI website.

Without an API key you will be limited to one concurrent call and twenty free calls per day with minimal queuing capabilities.

Cloud Server

The ScrAPI MCP Server is also available in the cloud over SSE at https://api.scrapi.dev/sse

Cloud MCP servers are not widely supported yet but you can access this directly from your own custom clients or use MCP Inspector to test it. There is currently no facility to pass through your API key when connecting to the cloud MCP server.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "scrapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SCRAPI_API_KEY",
        "deventerprisesoftware/scrapi-mcp"
      ],
      "env": {
        "SCRAPI_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "scrapi": {
      "command": "npx",
      "args": [
        "-y",
        "@deventerprisesoftware/scrapi-mcp"
      ],
      "env": {
        "SCRAPI_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Build

Docker build:

docker build -t deventerprisesoftware/scrapi-mcp -f Dockerfile .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.