DeepSFetch MCP server
Commit Oct 16, 2026Lets an AI client scrape web content, extract structured HTML data, and perform automated web searches using a hosted collection engine.
Also known as ermultimidia/deepsfetch-developer-kit, deepsfetch-developer-kit
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.0.1
- Last commit
- Oct 16, 2026
- License
- —
What is DeepSFetch MCP?
DeepSFetch lets an AI client scrape web content, extract structured HTML data, and perform automated web searches using a hosted collection engine.
Summary generated from the project's README
About DeepSFetch MCP server
DeepSFetch provides a toolkit for developers to scrape web content and extract structured HTML data for use in AI agents and automation pipelines. It connects to a hosted collection engine that manages the browser infrastructure and scraping tasks. Users interact with the service through various interfaces including a JavaScript SDK, a Python SDK, a command line interface, and an n8n community node.
To use these tools, you must have a DeepSFetch account and an API key. The service operates on a credit system where collections consume workspace credits based on the complexity of the task. While this repository contains the client-side code and integration guides, the actual collection engine and billing management are handled by the hosted DeepSFetch service. Developers can set up a remote connection to the MCP endpoint to integrate these scraping capabilities directly into their AI clients.
What you can do with it
- 1Automated Price MonitoringTrack changes in product pricing by extracting validated name, price, and currency data from web pages.
- 2Product Catalog ExtractionPull structured arrays of up to 100 items from a single listing page for inventory or research.
- 3RAG Documentation FeedingGather clean documentation, source metadata, and content hashes to populate vector stores for LLMs.
Written from the project's README. Every use case is checked against a quote from it.
How to install DeepSFetch MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall DeepSFetch MCP in Claude Code
$ claude mcp add --transport http deepsfetch-developer-kit https://mcp.deepsfetch.com/mcpInstall DeepSFetch MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"deepsfetch-developer-kit": {
"url": "https://mcp.deepsfetch.com/mcp"
}
}
}Install DeepSFetch MCP in VS Code
.vscode/mcp.json
{
"servers": {
"deepsfetch-developer-kit": {
"type": "http",
"url": "https://mcp.deepsfetch.com/mcp"
}
}
}Install DeepSFetch MCP in VS Code CLI
$ code --add-mcp '{"name":"deepsfetch-developer-kit","type":"http","url":"https://mcp.deepsfetch.com/mcp"}'Install DeepSFetch MCP in Codex
$ codex mcp add deepsfetch-developer-kit --url https://mcp.deepsfetch.com/mcpInstall DeepSFetch MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.deepsfetch-developer-kit] url = "https://mcp.deepsfetch.com/mcp"
Install DeepSFetch MCP in Gemini CLI
$ gemini mcp add -s user --transport http deepsfetch-developer-kit https://mcp.deepsfetch.com/mcpInstall DeepSFetch MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"deepsfetch-developer-kit": {
"url": "https://mcp.deepsfetch.com/mcp",
"type": "http"
}
}
}Configuration
DEEPSFETCH_API_KEY
| Name | Description | |
|---|---|---|
| DEEPSFETCH_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableermultimidia/deepsfetch-developer-kit is public and reachablegithub.com/ermultimidia/deepsfetch-developer-kit ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-16github.com/ermultimidia/deepsfetch-developer-kit ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubDeepSFetch Developer Kit
⭐ If these n8n workflows, SDKs, or MCP tools save you time, please give this repository a Star on GitHub! It helps other automation builders discover the toolkit.

Complete manual: 33 step-by-step guides — API, MCP, SDKs, CLI, collections, monitors, files, integrations and billing.
Collect web content for AI agents and automation with explicit credit limits.
Open-source JavaScript and Python clients, a CLI, and n8n integration code for the hosted DeepSFetch API. Start with one public HTML page, inspect the result, and build from there.
This repository contains client-side tools. The collection engine and hosted service are not included. Running the examples requires a DeepSFetch account and API key; collection consumes workspace credits. See current plans.
Ready-to-use n8n Workflows & Community Node
Automate structured HTML extraction in n8n with explicit credit caps, idempotency keys, and field validation before sending data to your alerts, spreadsheets, or AI/RAG pipelines.
| Ready Template | Use Case | What It Extracts & Delivers | Setup & Download |
|---|---|---|---|
| Price Monitoring | Track product price changes on a schedule | Validated name, price, and currency (JSON-LD / CSS) with baseline comparison |
Configure & Download JSON · n8n Guide |
| Product Catalog | Extract up to 100 items from a listing page | Structured item arrays with per-item field validation (no pagination) | Configure & Download JSON · n8n Guide |
| AI / RAG Documentation | Feed clean documentation into vector stores or LLMs | Source metadata, stable document IDs, content hash (change detection), and chunks | Configure & Download JSON · n8n Guide |
Install the n8n Community Node (n8n-nodes-deepsfetch)
For self-hosted n8n, install via the UI (Settings → Community Nodes → Install → n8n-nodes-deepsfetch) or manually in your community nodes folder:
npm install n8n-nodes-deepsfetch
(Using n8n Cloud? You can download the standard HTTP Request workflow templates directly from Guided Setup without installing a community node.)
1. Starting a Collection (Start Collection operation with payload & language selection):

2. Validated Output & Price Comparison (Compare price step with structured JSON result):

Get your first result
Requires Node.js 22+. Create a key in API keys. From the repository root, set it for the current terminal session and run the dependency-free example:
PowerShell:
$env:DEEPSFETCH_API_KEY = 'YOUR_DEEPSFETCH_API_KEY'
node examples/scrape.mjs https://example.com
macOS / Linux:
export DEEPSFETCH_API_KEY='YOUR_DEEPSFETCH_API_KEY'
node examples/scrape.mjs https://example.com
The example submits one HTTP-only collection with a maximum of 3 DeepSFetch credits and browser fallback disabled, then polls the same job. It prints the completed job as JSON. This cap is not a promise of a free or successful collection. JavaScript-dependent pages need another configuration. See getting started for failure handling and resuming a job.
Choose your integration
| Tool | Install or guide | What is included |
|---|---|---|
| JavaScript SDK | npm install @deepsfetch/sdk |
API v2 client and job polling |
| CLI | npm install -g @deepsfetch/cli |
Commands for collection, jobs and estimates |
| Python SDK | python -m pip install ./packages/deepsfetch-sdk-python |
Source installation; PyPI release pending |
| MCP | Remote connection guide | Configuration for the hosted MCP endpoint |
| n8n | npm install n8n-nodes-deepsfetch · Guide |
Source for the npm-published community node |
The remote MCP server implementation is not included here. The n8n node is not verified by n8n. The remote MCP is listed in the official registry. Native partnerships and a self-hosted collection engine are not claimed by this repository.
CLI quickstart
After installing the CLI and setting the environment variable above:
deepsfetch scrape --file examples/scrape-request.json --wait
The CLI writes its idempotency key to stderr. If a submission's outcome is unknown, retry the same request with --idempotency-key THE_SAME_KEY. Once you have a job ID, use deepsfetch job JOB_ID --wait instead of submitting another collection.
Open tools and hosted service
| Capability | In this repository | Hosted DeepSFetch |
|---|---|---|
| JavaScript SDK, Python SDK, CLI | Source and tests | Connect to API v2 |
| n8n community node | Source distributed as JavaScript | Calls collection integration endpoints |
| MCP | Connection guide | Remote server |
| Collection engine, browser infrastructure | Not included | Managed by DeepSFetch |
| Accounts, credits, billing and dashboard | Not included | Managed by DeepSFetch |
Develop locally
npm install --ignore-scripts
npm test
npm run check
Run Python tests from the repository root:
python -m pip install ./packages/deepsfetch-sdk-python
python -m unittest discover -s packages/deepsfetch-sdk-python/tests
Tests use fixtures and a local HTTP server; they do not submit paid collections. See contributing, security, and the roadmap.
Resources
MIT license applies to the tools in this repository. Using the hosted service is subject to its own terms and credit limits.
Try it and share feedback
Read the first-collection tutorial, run the operational smoke test, and share your first-run experience.
The authenticated Firecrawl comparison includes results, limitations and reproducible code. The published DEV tutorial walks through signup, first collection and MCP. Also see the Smithery listing, with instructions and limits in the MCP guide.
DeepSFetch MCP questions
How do I add DeepSFetch MCP to Claude Code?
Run claude mcp add --transport http deepsfetch-developer-kit https://mcp.deepsfetch.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add DeepSFetch MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this repository include the collection engine?
No, the repository contains client-side tools like SDKs and a CLI, but the collection engine and hosted service are managed by DeepSFetch.
What is required to run the provided examples?
Running the examples requires a DeepSFetch account and an API key, and collection usage consumes workspace credits.