ClearFetch - Unblocked Web & Anti-Bot MCP Server
ClearFetch — Model Context Protocol (MCP) & SDKs for AI Agents
The Official Model Context Protocol (MCP) Server & Client SDKs for ClearFetch.
Bypass Cloudflare Turnstile, DataDome, and anti-bot challenges to deliver clean, token-optimized Markdown and structured JSON directly into your AI workflows.
Website • API Documentation • PyPI SDK • npm MCP Server
🚀 Quick Install & Distribution Packages
1. Model Context Protocol (MCP) Server for Cursor & Claude Desktop
Run instantly without cloning or local installation:
npx -y clearfetchClaude Desktop Configuration (claude_desktop_config.json)
{
"mcpServers": {
"clearfetch": {
"command": "npx",
"args": ["-y", "clearfetch"],
"env": {
"CLEARFETCH_API_KEY": "cf_live_your_api_key_here"
}
}
}
}Cursor IDE Configuration (.cursor/mcp.json)
{
"mcpServers": {
"clearfetch": {
"command": "npx",
"args": ["-y", "clearfetch"],
"env": {
"CLEARFETCH_API_KEY": "cf_live_your_api_key_here"
}
}
}
}Available MCP Tools
clearfetch_read: Fetches any protected URL and returns token-optimized, clean Markdown.clearfetch_extract: Extracts strictly-typed JSON matching your provided JSON schema.clearfetch_search: Performs concurrent web search and scrapes top results into a single context object.
2. Python SDK (clearfetch)
Install from PyPI:
pip install clearfetchBasic Usage
from clearfetch import ClearFetch
client = ClearFetch(api_key="cf_live_your_api_key_here")
# 1. Read protected webpage as clean Markdown
doc = client.read("https://www.bloomberg.com/markets", stealth="auto")
print(doc.title)
print(doc.markdown)
# 2. Extract structured JSON using JSON Schema
schema = {
"type": "object",
"properties": {
"market_indices": {"type": "array", "items": {"type": "string"}},
"top_stories": {"type": "array", "items": {"type": "string"}}
},
"required": ["market_indices"]
}
data = client.extract("https://www.bloomberg.com/markets", schema=schema)
print(data.data)LangChain Integration
from clearfetch.integrations.langchain import ClearFetchTool
tool = ClearFetchTool(api_key="cf_live_your_api_key_here")
response = tool.run("https://news.ycombinator.com")
print(response)LlamaIndex Integration
from clearfetch.integrations.llamaindex import ClearFetchReader
reader = ClearFetchReader(api_key="cf_live_your_api_key_here")
documents = reader.load_data(urls=["https://en.wikipedia.org/wiki/Artificial_intelligence"])3. n8n Community Node (n8n-nodes-clearfetch)
In your n8n instance:
Navigate to Settings → Community Nodes.
Click Install a community node.
Enter
n8n-nodes-clearfetchand confirm.
Related MCP server: Firecrawl MCP Server
📡 REST API Reference
All requests authenticate using standard Bearer authorization: Authorization: Bearer cf_live_....
Read Webpage (POST https://api.clearfetch.dev/v1/read)
curl -X POST https://api.clearfetch.dev/v1/read \
-H "Authorization: Bearer cf_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/protected-page",
"stealth": "auto",
"only_main_content": true
}'Extract Structured Data (POST https://api.clearfetch.dev/v1/extract)
curl -X POST https://api.clearfetch.dev/v1/extract \
-H "Authorization: Bearer cf_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"url": "https://store.example.com/item/123",
"json_schema": {
"type": "object",
"properties": {
"product_name": { "type": "string" },
"price_usd": { "type": "number" }
},
"required": ["product_name", "price_usd"]
}
}'Search & Scrape (POST https://api.clearfetch.dev/v1/search)
curl -X POST https://api.clearfetch.dev/v1/search \
-H "Authorization: Bearer cf_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"query": "Model Context Protocol servers 2026",
"limit": 3,
"scrape_results": true
}'📦 Packages in this Repository
packages/mcp-server: Model Context Protocol server published to npm asclearfetch.packages/python-sdk: Python SDK with LangChain/LlamaIndex support published to PyPI asclearfetch.packages/n8n-nodes-clearfetch: Official n8n community node.
🔑 Getting an API Key
Create a free account and get your API key at clearfetch.dev.
📄 License
MIT License. See LICENSE for details.
Available Tools
3 toolsextract_structured_dataA
Extract strongly-typed JSON matching a strict schema from any webpage, even behind heavy anti-bot protections.
Inputs: url (required), json_schema (required), prompt, stealth.
read_urlA
Read any URL as clean, token-optimized Markdown. Reliably bypasses Cloudflare Turnstile, DataDome, PerimeterX, and anti-bot systems where other scrapers fail with 403 Forbidden.
Inputs: url (required), max_age, stealth, include_links, +1 more.
search_and_readA
Search the live web and return clean Markdown content bundles of top results in a single step for AI agent context / RAG.
Inputs: query (required), limit, scrape_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct input signature and output shape: read_url takes a URL and returns Markdown, extract_structured_data takes a URL plus schema and returns typed JSON, and search_and_read takes a query and returns bundled results. An agent can pick unambiguously based on whether it has a URL or a query and whether it needs Markdown or schema-conforming JSON.
All three names are snake_case and lead with a clear verb (read_, extract_, search_) followed by the object of the action. The pattern is predictable and consistent throughout.
Three tools is on the lean side, but each maps to a genuinely different workflow (raw fetch, schema extraction, discovery+fetch) and none feels redundant. A focused anti-bot fetching server can justify a minimal surface, though one or two more convenience tools would not be out of place.
The fetch/extract/search triad covers the core content-acquisition lifecycle for agent context and RAG. The main gap is batch or multi-URL reading (and any crawl/site-traversal capability), which agents must work around by calling the tools repeatedly.
Maintenance
Related MCP Connectors
Web scraping for AI agents. Converts URLs to clean, LLM-ready Markdown with anti-bot bypass.
Stealth scraping & search. Bypasses Cloudflare, DataDome & LinkedIn via Cyborg HITL approach.
Cloud scraping & crawling API for AI agents. Turn any URL into clean, LLM-ready markdown.
Cloudflare Solver: Scraping API designed to bypass Cloudflare protection.
Related MCP Servers
- MIT
- AlicenseAqualityDmaintenanceIntegrates Firecrawl for web scraping, crawling, search, and content extraction capabilities. Supports single/batch scraping, URL discovery, structured data extraction, deep research, and AI-powered web analysis with automatic retries and rate limiting.8201,139 npmMIT
- AlicenseAqualityDmaintenanceIntegrates Firecrawl web scraping capabilities, enabling web content extraction, crawling, site mapping, search, and structured data extraction with automatic rate limiting and retry handling.6201,139 npm2MIT
- AlicenseAqualityDmaintenanceA minimal MCP server that enables HTTP requests with any method, headers, and body types, supporting large responses through chunked transfers with disk-backed caching.2MIT