Scrapling Fetch MCP

What is Scrapling Fetch MCP about?

Scrapling Fetch MCP provides an MCP server that enables AI assistants to retrieve text‑only content (HTML or markdown) from sites that employ anti‑automation measures. It bridges the gap between what a human sees in a browser and what an AI can access, focusing on low‑volume documentation and reference material.

How to use Scrapling Fetch MCP?

Install the tool using the uv package manager:

uv tool install scrapling
scrapling install
uv tool install scrapling-fetch-mcp

Configure your Claude client (or any MCP‑compatible client) by adding the server entry:

{
  "mcpServers": {
    "Cyber-Chitta": {
      "command": "uvx",
      "args": ["scrapling-fetch-mcp"]
    }
  }
}

Invoke one of the two provided tools via MCP function calls:
- s-fetch-page – retrieve full pages with optional pagination.
- s-fetch-pattern – extract snippets matching a regex pattern with surrounding context.

Key Features of Scrapling Fetch MCP

Protection Levels: basic, stealth, and max‑stealth allow trade‑offs between speed and success on heavily protected sites.
Two Toolsets:
- s-fetch-page supports pagination (start_index, max_length).
- s-fetch-pattern returns matches with position data for follow‑up calls.
Optimized for Text: Designed for documentation, articles, and reference material (no binary assets).
Low‑Volume Focus: Not intended for large‑scale scraping or data harvesting.
Automatic Mode Adjustment: AI can escalate protection level if initial attempts fail.

Use Cases of Scrapling Fetch MCP

Documentation Retrieval: Pull API docs or technical guides behind Cloudflare or similar protections for summarization.
Targeted Information Extraction: Find specific terms (e.g., "API keys") on a protected page without downloading the entire document.
Conversation‑Driven Research: Enable LLMs to fetch and cite up‑to‑date web content during a chat session.
Knowledge Base Augmentation: Populate internal knowledge bases with the latest publicly available reference material.

FAQ for Scrapling Fetch MCP

Q: What sites can it handle? A: Sites that rely on JavaScript challenges, rate‑limiting, or basic bot detection. It may not work with sites requiring authentication or CAPTCHAs.

Q: How fast is the retrieval? A: basic mode returns in 1‑2 seconds, stealth in 3‑8 seconds, and max‑stealth may take 10+ seconds depending on protection.

Q: Can I scrape large documents? A: Yes, use the pagination parameters of s-fetch-page to fetch in chunks.

Q: Is this tool suitable for high‑volume scraping? A: No. It is engineered for low‑volume, on‑demand retrieval to support AI assistants.

Q: Do I need an API key? A: No external API key is required; the tool works directly against the target website.

An MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.

Intended Use

This tool is optimized for low-volume retrieval of documentation and reference materials (text/HTML only) from websites that implement bot detection. It has not been designed or tested for general-purpose site scraping or data harvesting.

Note: This project was developed in collaboration with Claude Sonnet 3.7, using LLM Context.

Installation

Requirements:
- Python 3.10+
- uv package manager
Install dependencies and the tool:

uv tool install scrapling
scrapling install
uv tool install scrapling-fetch-mcp

Setup with Claude

Add this configuration to your Claude client's MCP server configuration:

{
  "mcpServers": {
    "Cyber-Chitta": {
      "command": "uvx",
      "args": ["scrapling-fetch-mcp"]
    }
  }
}

Available Tools

This package provides two distinct tools:

s-fetch-page: Retrieves complete web pages with pagination support
s-fetch-pattern: Extracts content matching regex patterns with surrounding context

Example Usage

Fetching a Complete Page

Human: Please fetch and summarize the documentation at https://example.com/docs

Claude: I'll help you with that. Let me fetch the documentation.

<mcp:function_calls>
<mcp:invoke name="s-fetch-page">
<mcp:parameter name="url">https://example.com/docs</mcp:parameter>
<mcp:parameter name="mode">basic</mcp:parameter>
</mcp:invoke>
</mcp:function_calls>

Based on the documentation I retrieved, here's a summary...

Extracting Specific Content with Pattern Matching

Human: Please find all mentions of "API keys" on the documentation page.

Claude: I'll search for that specific information.

<mcp:function_calls>
<mcp:invoke name="s-fetch-pattern">
<mcp:parameter name="url">https://example.com/docs</mcp:parameter>
<mcp:parameter name="mode">basic</mcp:parameter>
<mcp:parameter name="search_pattern">API\s+keys?</mcp:parameter>
<mcp:parameter name="context_chars">150</mcp:parameter>
</mcp:invoke>
</mcp:function_calls>

I found several mentions of API keys in the documentation:
...

Functionality Options

Protection Levels:
- basic: Fast retrieval (1-2 seconds) but lower success with heavily protected sites
- stealth: Balanced protection (3-8 seconds) that works with most sites
- max-stealth: Maximum protection (10+ seconds) for heavily protected sites
Content Targeting Options:
- s-fetch-page: Retrieve entire pages with pagination support (using start_index and max_length)
- s-fetch-pattern: Extract specific content using regular expressions (with search_pattern and context_chars)
  - Results include position information for follow-up queries with s-fetch-page

Tips for Best Results

Start with basic mode and only escalate to higher protection levels if needed
For large documents, use the pagination parameters with s-fetch-page
Use s-fetch-pattern when looking for specific information on large pages
The AI will automatically adjust its approach based on the site's protection level

Limitations

Designed only for text content: Specifically for documentation, articles, and reference materials
Not designed for high-volume scraping or data harvesting
May not work with sites requiring authentication
Performance varies by site complexity

License

Apache 2

Scrapling Fetch MCP