@stealth-scraper/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stealth Scraper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @stealth-scraper/mcp
+
+Model Context Protocol (MCP) server for [Stealth Scraper](https://stealthscraper.dev). Plugs the anti-bot-resistant web scraping API directly into Claude Desktop, Cursor, Cline, and any other MCP-aware agent.
+
+> **Status:** beta. Public API is stable; we follow semver from `1.0.0` onward.
+
+## What it does
+
+Exposes four tools to the agent:
+
+| Tool                 | What it does                                                                 |
+| -------------------- | ---------------------------------------------------------------------------- |
+| `scrape_url`         | Stealth-scrape a URL, with optional natural-language hints about what to extract. |
+| `extract_structured` | Run a one-shot extract with an inline schema (list of fields + CSS selectors). |
+| `list_templates`     | List the user's saved extraction recipes.                                     |
+| `run_template`       | Run a saved template against a target URL.                                    |
+
+## Claude Desktop setup
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "stealth-scraper": {
+      "command": "npx",
+      "args": ["@stealth-scraper/mcp"],
+      "env": {
+        "STEALTH_SCRAPER_API_KEY": "ssk_..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You should see a hammer/tools icon in the input area listing the four tools.
+
+## Cursor / Cline / generic stdio
+
+Any client that supports an MCP stdio server can use:
+
+```jsonc
+{
+  "command": "npx",
+  "args": ["@stealth-scraper/mcp"],
+  "env": { "STEALTH_SCRAPER_API_KEY": "ssk_..." }
+}
+```
+
+For a custom backend (self-hosted), also set `STEALTH_SCRAPER_BASE_URL=https://your-host`.
+
+## Example agent prompts
+
+> Use stealth-scraper to grab the top 20 stories from Hacker News with titles, scores, and links.
+
+> List my saved scraper templates, then run the "Amazon product price" one against `https://www.amazon.com/dp/B08N5WRWNW`.
+
+## Local install
+
+```bash
+npm install -g @stealth-scraper/mcp
+stealth-scraper-mcp     # runs the server on stdio
+```
+
+## Development
+
+```bash
+npm install
+npm run build           # produces dist/index.js (the bin)
+STEALTH_SCRAPER_API_KEY=ssk_test node dist/index.js
+```
+
+Smoke test against the local backend with an MCP inspector:
+
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## RUN THIS TO PUBLISH
+
+```bash
+npm install
+npm run build
+npm publish --access public   # under the @stealth-scraper org
+```
+
+> First-time only: create the npm org at `https://www.npmjs.com/org/create` with name `stealth-scraper`.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point for Stealth Scraper.
+ *
+ * Connects via stdio (the transport Claude Desktop / Cursor use by default).
+ * The API key comes from the `STEALTH_SCRAPER_API_KEY` env var — we fail
+ * fast with a clear message if it's missing so misconfiguration shows up
+ * before the model issues the first tool call.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point for Stealth Scraper.
+ *
+ * Connects via stdio (the transport Claude Desktop / Cursor use by default).
+ * The API key comes from the `STEALTH_SCRAPER_API_KEY` env var — we fail
+ * fast with a clear message if it's missing so misconfiguration shows up
+ * before the model issues the first tool call.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { StealthClient } from "stealth-scraper";
+import { TOOL_DEFS, dispatch } from "./tools.js";
+const SERVER_NAME = "stealth-scraper";
+const SERVER_VERSION = "0.1.0";
+async function main() {
+    const apiKey = process.env.STEALTH_SCRAPER_API_KEY;
+    if (!apiKey) {
+        // stderr is the only safe channel for diagnostics on stdio transport —
+        // stdout is reserved for the MCP wire protocol.
+        process.stderr.write("[stealth-scraper-mcp] STEALTH_SCRAPER_API_KEY env var is required.\n" +
+            "Add it to your MCP client config, e.g. Claude Desktop:\n" +
+            '  { "env": { "STEALTH_SCRAPER_API_KEY": "ssk_..." } }\n');
+        process.exit(1);
+    }
+    const baseUrl = process.env.STEALTH_SCRAPER_BASE_URL;
+    const client = new StealthClient({
+        apiKey,
+        ...(baseUrl ? { baseUrl } : {}),
+    });
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    // ListTools: return the static catalogue. The schemas are JSON Schema
+    // objects so MCP clients can validate args before they hit the wire.
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DEFS,
+    }));
+    // CallTool: route to the dispatcher in tools.ts.
+    // Cast to `any` so a future MCP SDK refactor of the ServerResult union
+    // (Nov-2025 spec introduced an optional `task` field for streaming
+    // progress notifications) doesn't break our build. Our ToolResult
+    // shape is a strict subset of the accepted union.
+    server.setRequestHandler(CallToolRequestSchema, (async (request) => {
+        const name = request.params.name;
+        const args = (request.params.arguments ?? {});
+        return dispatch(client, name, args);
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[stealth-scraper-mcp] connected via stdio (v${SERVER_VERSION})\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[stealth-scraper-mcp] fatal: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,GAAG,iBAAiB,CAAC;AACtC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,uEAAuE;QACvE,gDAAgD;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sEAAsE;YACpE,0DAA0D;YAC1D,yDAAyD,CAC5D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,sEAAsE;IACtE,qEAAqE;IACrE,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC,CAAC;IAEJ,iDAAiD;IACjD,uEAAuE;IACvE,mEAAmE;IACnE,kEAAkE;IAClE,kDAAkD;IAClD,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,OAAY,EAAE,EAAE;QACtE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC;QACzE,OAAO,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,CAAQ,CAAC,CAAC;IAEX,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+CAA+C,cAAc,KAAK,CACnE,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tool implementations for the Stealth Scraper MCP server.
+ *
+ * Each tool wraps a method on `StealthClient` and returns a MCP-compliant
+ * `{ content: [{ type: 'text', text: ... }] }` envelope. Errors from the
+ * SDK are caught at the dispatcher boundary and surfaced as MCP `isError`
+ * responses so the calling agent sees a clear failure mode instead of a
+ * raw stack trace.
+ *
+ * The schemas below are plain JSON Schema (the format the MCP SDK expects
+ * for `inputSchema`). We keep them minimal — the SDK enforces the rest.
+ */
+import { StealthClient } from "stealth-scraper";
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+}
+export declare const TOOL_DEFS: ToolDef[];
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Dispatch a single tool call. The MCP runtime hands us the tool name plus
+ * its arguments — we look up the handler and return a result envelope.
+ *
+ * All errors are caught and converted to MCP error envelopes so the agent
+ * model sees a structured failure response instead of a crashed server.
+ */
+export declare function dispatch(client: StealthClient, name: string, args: Record<string, unknown>): Promise<ToolResult>;

package/dist/tools.js

@@ -0,0 +1,176 @@
+/**
+ * Tool implementations for the Stealth Scraper MCP server.
+ *
+ * Each tool wraps a method on `StealthClient` and returns a MCP-compliant
+ * `{ content: [{ type: 'text', text: ... }] }` envelope. Errors from the
+ * SDK are caught at the dispatcher boundary and surfaced as MCP `isError`
+ * responses so the calling agent sees a clear failure mode instead of a
+ * raw stack trace.
+ *
+ * The schemas below are plain JSON Schema (the format the MCP SDK expects
+ * for `inputSchema`). We keep them minimal — the SDK enforces the rest.
+ */
+export const TOOL_DEFS = [
+    {
+        name: "scrape_url",
+        description: "Stealth-scrape a URL with optional natural-language field hints. Uses Stealth Scraper's anti-bot-resistant browser pool. Returns extracted structured data plus the page title.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "URL to scrape (https://...)" },
+                fields: {
+                    type: "string",
+                    description: "Optional natural-language description of what to extract, e.g. 'top 20 story titles, scores, and links'. If omitted, returns the raw page element catalog.",
+                },
+            },
+            required: ["url"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "extract_structured",
+        description: "Run a one-shot structured extraction against a URL using an inline schema (list of fields with CSS selectors).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string" },
+                schema: {
+                    type: "array",
+                    description: "Array of field objects, e.g. [{ name: 'title', selector: 'h1' }, { name: 'price', selector: '.price', attribute: 'data-price' }]",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            selector: { type: "string" },
+                            attribute: { type: "string" },
+                        },
+                        required: ["name"],
+                    },
+                },
+            },
+            required: ["url", "schema"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "list_templates",
+        description: "List the authenticated user's saved extraction templates / recipes. Returns id, name, and source URL for each.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "run_template",
+        description: "Run a saved Stealth Scraper template by id against a target URL.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                template_id: { type: "string" },
+                url: { type: "string" },
+            },
+            required: ["template_id", "url"],
+            additionalProperties: false,
+        },
+    },
+];
+function ok(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    };
+}
+function err(message, extras) {
+    const body = extras ? { error: message, ...extras } : { error: message };
+    return {
+        isError: true,
+        content: [{ type: "text", text: JSON.stringify(body, null, 2) }],
+    };
+}
+/**
+ * Dispatch a single tool call. The MCP runtime hands us the tool name plus
+ * its arguments — we look up the handler and return a result envelope.
+ *
+ * All errors are caught and converted to MCP error envelopes so the agent
+ * model sees a structured failure response instead of a crashed server.
+ */
+export async function dispatch(client, name, args) {
+    try {
+        switch (name) {
+            case "scrape_url": {
+                const url = String(args.url ?? "");
+                const fields = typeof args.fields === "string" ? args.fields : "";
+                if (!url)
+                    return err("missing required arg: url");
+                if (fields) {
+                    const r = await client.assistExtract({ url, description: fields });
+                    return ok({
+                        url: r.url,
+                        title: r.title,
+                        template: r.template,
+                        fields: r.fields,
+                    });
+                }
+                const snap = await client.snapshot(url);
+                return ok({
+                    url: snap.url,
+                    title: snap.title,
+                    element_count: snap.elementCount,
+                    elements: snap.elements.slice(0, 50), // cap to keep response small
+                });
+            }
+            case "extract_structured": {
+                const url = String(args.url ?? "");
+                const schema = (args.schema ?? []);
+                if (!url)
+                    return err("missing required arg: url");
+                if (!Array.isArray(schema) || schema.length === 0)
+                    return err("missing required arg: schema (non-empty array)");
+                const r = await client.extract({ url, template: schema });
+                return ok({ url: r.url, title: r.title, fields: r.fields, errors: r.errors });
+            }
+            case "list_templates": {
+                const templates = await client.listTemplates();
+                return ok({
+                    count: templates.length,
+                    templates: templates.map((t) => ({
+                        id: t.id,
+                        name: t.name,
+                        source_url: t.sourceUrl,
+                        field_count: t.fields.length,
+                    })),
+                });
+            }
+            case "run_template": {
+                const templateId = String(args.template_id ?? "");
+                const url = String(args.url ?? "");
+                if (!templateId)
+                    return err("missing required arg: template_id");
+                if (!url)
+                    return err("missing required arg: url");
+                const r = await client.runTemplate(templateId, url);
+                return ok({ url: r.url, title: r.title, fields: r.fields, errors: r.errors });
+            }
+            default:
+                return err(`unknown tool: ${name}`);
+        }
+    }
+    catch (e) {
+        // Surface typed SDK errors with their structured fields so the model can
+        // explain to the user *why* the scrape failed (anti-bot vendor, plan
+        // cap, etc.). Falls back to message + name for everything else.
+        const anyErr = e;
+        return err(anyErr.message ?? String(e), {
+            type: anyErr.name,
+            kind: anyErr.kind,
+            vendor: anyErr.vendor,
+            suggestion: anyErr.suggestion,
+            used: anyErr.used,
+            limit: anyErr.limit,
+            upgrade_url: anyErr.upgradeUrl,
+            retry_after_s: anyErr.retryAfterS,
+            status_code: anyErr.statusCode,
+        });
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@stealth-scraper/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Stealth Scraper — gives Claude, Cursor, and other MCP-aware agents direct access to anti-bot-resistant web scraping.",
+  "license": "MIT",
+  "author": "Stealth Scraper <hello@stealthscraper.dev>",
+  "homepage": "https://stealthscraper.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rusheesonu/Stealth-Scraper.git",
+    "directory": "sdks/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/Rusheesonu/Stealth-Scraper/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai-agents",
+    "scraping",
+    "anti-bot",
+    "stealth-scraper"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "stealth-scraper": "file:../typescript"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.6.0"
+  }
+}