Skip to main content

Helps AI assistants access text content from bot-protected websites. MCP server that fetches HTML/markdown from sites with anti-automation measures using Scrapling.

Project description

scrapling-fetch-mcp

License PyPI version

Helps AI assistants fetch content from bot-protected websites. Uses Scrapling (patchright + curl-cffi) to bypass anti-automation measures, returning clean HTML or Markdown.

Optimized for low-volume retrieval of documentation and reference materials. Not designed for high-volume scraping or data harvesting.

Requirements: Python 3.10+, uv

Claude Code Skill

The easiest way to use this is as a Claude Code skill. Once installed, Claude will automatically fetch bot-protected URLs when you ask — no manual commands needed.

Install into your project (recommended — only loads in this project's context):

git clone --depth=1 https://github.com/cyberchitta/scrapling-fetch-mcp /tmp/scrapling-fetch-mcp
cp -r /tmp/scrapling-fetch-mcp/skills/s-fetch .claude/skills/
rm -rf /tmp/scrapling-fetch-mcp

Or install for all projects (loads into context everywhere):

git clone --depth=1 https://github.com/cyberchitta/scrapling-fetch-mcp /tmp/scrapling-fetch-mcp
cp -r /tmp/scrapling-fetch-mcp/skills/s-fetch ~/.claude/skills/
rm -rf /tmp/scrapling-fetch-mcp

The first time you invoke /s-fetch, Claude will read skills/s-fetch/references/install.md and run the one-time setup (installs the tool and downloads browser binaries). After that, just ask naturally:

"Fetch the docs at https://example.com/api"
"Find all mentions of 'authentication' on that page"
"Get me the installation instructions from their homepage"

Claude Desktop (MCP Server)

If the /s-fetch skill has already installed the tool, skip to the config below.

Otherwise install first:

uv tool install git+https://github.com/cyberchitta/scrapling-fetch-mcp
uvx --from git+https://github.com/cyberchitta/scrapling-fetch-mcp scrapling install

Note: Browser installation downloads hundreds of MB and must complete before first use. If the server times out initially, wait a few minutes and try again.

Add this to your Claude Desktop MCP settings and restart:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

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

How It Works

Two tools, used automatically by Claude:

  • Page fetching — retrieves complete pages with pagination support
  • Pattern extraction — finds content matching a regex

Three protection levels, escalated automatically:

  • basic — fast (1-2s), works for most sites
  • stealth — moderate (3-8s), headless Chromium
  • max-stealth — thorough (10s+), full browser fingerprint

Limitations

  • Text content only (documentation, articles, references)
  • Not for high-volume scraping or sites requiring authentication
  • Performance varies by site complexity and protection level

License

Apache 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scrapling_fetch_mcp-0.2.4.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scrapling_fetch_mcp-0.2.4-py3-none-any.whl (15.7 kB view details)

Uploaded Python 3

File details

Details for the file scrapling_fetch_mcp-0.2.4.tar.gz.

File metadata

  • Download URL: scrapling_fetch_mcp-0.2.4.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for scrapling_fetch_mcp-0.2.4.tar.gz
Algorithm Hash digest
SHA256 0e19f4aa5fd572b1b6832fcdaa637d1151ce55cb9d33157eb637638ce119213d
MD5 861491d03a68c6f35dd16f3e9406828a
BLAKE2b-256 4bfb7dae5073528ac793e597bef059e14271c62edefd4b8b144339cf292d8a92

See more details on using hashes here.

File details

Details for the file scrapling_fetch_mcp-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: scrapling_fetch_mcp-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 15.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for scrapling_fetch_mcp-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 9ad240d78f41db8e96217e9f1c2d4635253d4aa979700d9340256f723e07e643
MD5 a5b53ca503358d6d7aa9896b605ea1b9
BLAKE2b-256 119876fae5c38d4fdf20ca5af6da304c4fb37031a87c4c75fb8a3b07aaaffa12

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page