@zenrows/mcp 2.1.2 → 2.2.2

package/dist/tools/browser.js

@@ -1,10 +1,14 @@
 import { z } from "zod";
+import { appendClaimHint } from "../auth/claim-hint.js";
 import { browserFetch, browserError } from "./browser-fetch.js";
 function ok() {
     return { content: [{ type: "text", text: JSON.stringify({ ok: true }) }] };
 }
 function err(msg) {
-    return { content: [{ type: "text", text: msg }], isError: true };
+    return {
+        content: [{ type: "text", text: appendClaimHint(msg, { body: msg, message: msg }) }],
+        isError: true,
+    };
 }
 function json(data) {
     return { content: [{ type: "text", text: JSON.stringify(data) }] };
@@ -14,7 +18,11 @@ export function registerBrowserTools(server, apiKey, browserUrl, getClientName)
     const tfetch = (toolName) => (method, path, body) => browserFetch(method, path, apiKey, browserUrl, body, getClientName(), toolName);
     // ─── Session ─────────────────────────────────────────────────────────────
     server.registerTool("browser_navigate", {
-        annotations: { title: "Open Browser & Navigate", readOnlyHint: false, destructiveHint: false },
+        annotations: {
+            title: "Open Browser & Navigate",
+            readOnlyHint: false,
+            destructiveHint: false,
+        },
         description: `Open a Zenrows Browser Sessions session and navigate to a URL.
 
 This is the entry point for all browser automation. It creates a new session backed by
@@ -32,7 +40,10 @@ When to use options:
                 .string()
                 .optional()
                 .describe("ISO 3166-1 alpha-2 country code for geo-targeted proxy (e.g. 'US', 'GB', 'DE')"),
-            proxy_region: z.string().optional().describe("World region code for geo-targeted proxy (eu=Europe, na=North America, ap=Asia Pacific, sa=South America, af=Africa, me=Middle East)"),
+            proxy_region: z
+                .string()
+                .optional()
+                .describe("World region code for geo-targeted proxy (eu=Europe, na=North America, ap=Asia Pacific, sa=South America, af=Africa, me=Middle East)"),
         },
     }, async (params) => {
         const fetch = tfetch("browser_navigate");
@@ -51,7 +62,9 @@ When to use options:
         const session = result.data;
         let navResult;
         try {
-            navResult = await fetch("POST", `/browser/sessions/${session.session_id}/navigate`, { url: params.url });
+            navResult = await fetch("POST", `/browser/sessions/${session.session_id}/navigate`, {
+                url: params.url,
+            });
         }
         catch (e) {
             // Best-effort cleanup — session was created but navigation failed, free the slot.
@@ -63,7 +76,12 @@ When to use options:
             return err(`Navigation failed: ${browserError(navResult)}`);
         }
         const nav = navResult.data;
-        return json({ session_id: session.session_id, url: nav.url, title: nav.title, expires_at: session.expires_at });
+        return json({
+            session_id: session.session_id,
+            url: nav.url,
+            title: nav.title,
+            expires_at: session.expires_at,
+        });
     });
     server.registerTool("browser_close", {
         annotations: { title: "Close Browser Session", readOnlyHint: false, destructiveHint: false },
@@ -181,7 +199,11 @@ When to use options:
     }, async ({ session_id, selector, text, clear_first }) => {
         const fetch = tfetch("browser_type");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/type`, { selector, text, clear_first });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/type`, {
+                selector,
+                text,
+                clear_first,
+            });
             if (!result.ok)
                 return err(`Type failed: ${browserError(result)}`);
             return ok();
@@ -201,7 +223,10 @@ When to use options:
     }, async ({ session_id, selector, value }) => {
         const fetch = tfetch("browser_fill");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/fill`, { selector, value });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/fill`, {
+                selector,
+                value,
+            });
             if (!result.ok)
                 return err(`Fill failed: ${browserError(result)}`);
             return ok();
@@ -221,7 +246,10 @@ When to use options:
     }, async ({ session_id, selector, value }) => {
         const fetch = tfetch("browser_select_option");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/select`, { selector, value });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/select`, {
+                selector,
+                value,
+            });
             if (!result.ok)
                 return err(`Select failed: ${browserError(result)}`);
             return ok();
@@ -317,7 +345,10 @@ When to use options:
     }, async ({ session_id, direction, distance }) => {
         const fetch = tfetch("browser_scroll");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/scroll`, { direction, distance });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/scroll`, {
+                direction,
+                distance,
+            });
             if (!result.ok)
                 return err(`Scroll failed: ${browserError(result)}`);
             return ok();
@@ -416,7 +447,9 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, selector }) => {
         const fetch = tfetch("browser_get_text");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/get_text`, { selector });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/get_text`, {
+                selector,
+            });
             if (!result.ok)
                 return err(`Failed to get text: ${browserError(result)}`);
             const data = result.data;
@@ -437,7 +470,10 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, selector, attribute }) => {
         const fetch = tfetch("browser_get_attribute");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/get_attribute`, { selector, attribute });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/get_attribute`, {
+                selector,
+                attribute,
+            });
             if (!result.ok)
                 return err(`Failed to get attribute: ${browserError(result)}`);
             return json(result.data);
@@ -456,7 +492,9 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, selector }) => {
         const fetch = tfetch("browser_get_html");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/get_html`, { selector });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/get_html`, {
+                selector,
+            });
             if (!result.ok)
                 return err(`Failed to get HTML: ${browserError(result)}`);
             const data = result.data;
@@ -467,7 +505,11 @@ labels, and states — everything needed to drive browser interactions.`,
         }
     });
     server.registerTool("browser_query_selector_all", {
-        annotations: { title: "Query All Matching Elements", readOnlyHint: true, destructiveHint: false },
+        annotations: {
+            title: "Query All Matching Elements",
+            readOnlyHint: true,
+            destructiveHint: false,
+        },
         description: "Find all elements matching a CSS selector and return their text, HTML, and attributes.",
         inputSchema: {
             session_id: sessionId,
@@ -476,7 +518,9 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, selector }) => {
         const fetch = tfetch("browser_query_selector_all");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/query_selector_all`, { selector });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/query_selector_all`, {
+                selector,
+            });
             if (!result.ok)
                 return err(`Query failed: ${browserError(result)}`);
             return json(result.data);
@@ -491,7 +535,10 @@ labels, and states — everything needed to drive browser interactions.`,
         description: "Take a screenshot of the current page or a specific element. Use for visual verification or when the accessibility tree is not sufficient.",
         inputSchema: {
             session_id: sessionId,
-            full_page: z.boolean().optional().describe("Capture full page including content below the fold (default false)"),
+            full_page: z
+                .boolean()
+                .optional()
+                .describe("Capture full page including content below the fold (default false)"),
             selector: z
                 .string()
                 .optional()
@@ -500,7 +547,10 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, full_page, selector }) => {
         const fetch = tfetch("browser_screenshot");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/screenshot`, { full_page, selector });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/screenshot`, {
+                full_page,
+                selector,
+            });
             if (!result.ok)
                 return err(`Screenshot failed: ${browserError(result)}`);
             const data = result.data;
@@ -530,7 +580,11 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, print_background, landscape, scale }) => {
         const fetch = tfetch("browser_generate_pdf");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/generate_pdf`, { print_background, landscape, scale });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/generate_pdf`, {
+                print_background,
+                landscape,
+                scale,
+            });
             if (!result.ok)
                 return err(`PDF generation failed: ${browserError(result)}`);
             const data = result.data;
@@ -558,12 +612,18 @@ labels, and states — everything needed to drive browser interactions.`,
         inputSchema: {
             session_id: sessionId,
             selector: z.string().describe("CSS selector to wait for"),
-            visible: z.boolean().optional().describe("Also require the element to be visible, not just present in the DOM (default false)"),
+            visible: z
+                .boolean()
+                .optional()
+                .describe("Also require the element to be visible, not just present in the DOM (default false)"),
         },
     }, async ({ session_id, selector, visible }) => {
         const fetch = tfetch("browser_wait_for_selector");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/wait_for_selector`, { selector, visible });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/wait_for_selector`, {
+                selector,
+                visible,
+            });
             if (!result.ok)
                 return err(`Wait for selector failed: ${browserError(result)}`);
             return ok();
@@ -577,7 +637,13 @@ labels, and states — everything needed to drive browser interactions.`,
         description: "Wait for the page to navigate to a new URL. IMPORTANT: call this BEFORE the action that triggers navigation (e.g. before browser_click on a submit button), not after — the navigation event may already have fired and this will hang until timeout. If the page stays on the same URL (AJAX/SPA), skip this tool entirely. Optional timeout_ms (default 30000ms).",
         inputSchema: {
             session_id: sessionId,
-            timeout_ms: z.number().int().min(1000).max(60000).optional().describe("How long to wait in milliseconds (default 30000, max 60000)"),
+            timeout_ms: z
+                .number()
+                .int()
+                .min(1000)
+                .max(60000)
+                .optional()
+                .describe("How long to wait in milliseconds (default 30000, max 60000)"),
         },
     }, async ({ session_id, timeout_ms }) => {
         const fetch = tfetch("browser_wait_for_navigation");
@@ -669,7 +735,9 @@ labels, and states — everything needed to drive browser interactions.`,
         try {
             // Remap http_only → httpOnly to match Chrome DevTools Protocol / Rod's JSON field names.
             const mapped = cookies.map(({ http_only, ...rest }) => ({ ...rest, httpOnly: http_only }));
-            const result = await fetch("POST", `/browser/sessions/${session_id}/cookies`, { cookies: mapped });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/cookies`, {
+                cookies: mapped,
+            });
             if (!result.ok)
                 return err(`Failed to set cookies: ${browserError(result)}`);
             return ok();
@@ -707,7 +775,11 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, action, key, value }) => {
         const fetch = tfetch("browser_local_storage");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/local_storage`, { action, key, value });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/local_storage`, {
+                action,
+                key,
+                value,
+            });
             if (!result.ok)
                 return err(`Local storage operation failed: ${browserError(result)}`);
             return json(result.data);
@@ -746,7 +818,9 @@ labels, and states — everything needed to drive browser interactions.`,
     }, async ({ session_id, tab_id }) => {
         const fetch = tfetch("browser_switch_tab");
         try {
-            const result = await fetch("POST", `/browser/sessions/${session_id}/switch_tab`, { tab_id });
+            const result = await fetch("POST", `/browser/sessions/${session_id}/switch_tab`, {
+                tab_id,
+            });
             if (!result.ok)
                 return err(`Failed to switch tab: ${browserError(result)}`);
             return ok();
@@ -763,14 +837,23 @@ labels, and states — everything needed to drive browser interactions.`,
         z.object({ type: z.literal("reload") }),
         z.object({ type: z.literal("click"), selector: z.string() }),
         z.object({ type: z.literal("hover"), selector: z.string() }),
-        z.object({ type: z.literal("type"), selector: z.string(), text: z.string(), clear_first: z.boolean().optional() }),
+        z.object({
+            type: z.literal("type"),
+            selector: z.string(),
+            text: z.string(),
+            clear_first: z.boolean().optional(),
+        }),
         z.object({ type: z.literal("fill"), selector: z.string(), value: z.string() }),
         z.object({ type: z.literal("select"), selector: z.string(), value: z.string() }),
         z.object({ type: z.literal("check"), selector: z.string() }),
         z.object({ type: z.literal("uncheck"), selector: z.string() }),
         z.object({ type: z.literal("focus"), selector: z.string() }),
         z.object({ type: z.literal("press_key"), key: z.string() }),
-        z.object({ type: z.literal("scroll"), direction: z.enum(["up", "down", "left", "right"]), distance: z.number().optional() }),
+        z.object({
+            type: z.literal("scroll"),
+            direction: z.enum(["up", "down", "left", "right"]),
+            distance: z.number().optional(),
+        }),
         z.object({ type: z.literal("drag"), source_selector: z.string(), target_selector: z.string() }),
         z.object({ type: z.literal("get_accessibility_tree") }),
         z.object({ type: z.literal("get_url") }),
@@ -779,8 +862,16 @@ labels, and states — everything needed to drive browser interactions.`,
         z.object({ type: z.literal("get_attribute"), selector: z.string(), attribute: z.string() }),
         z.object({ type: z.literal("get_html"), selector: z.string().optional() }),
         z.object({ type: z.literal("query_selector_all"), selector: z.string() }),
-        z.object({ type: z.literal("screenshot"), full_page: z.boolean().optional(), selector: z.string().optional() }),
-        z.object({ type: z.literal("wait_for_selector"), selector: z.string(), visible: z.boolean().optional() }),
+        z.object({
+            type: z.literal("screenshot"),
+            full_page: z.boolean().optional(),
+            selector: z.string().optional(),
+        }),
+        z.object({
+            type: z.literal("wait_for_selector"),
+            selector: z.string(),
+            visible: z.boolean().optional(),
+        }),
         z.object({ type: z.literal("wait_for_navigation") }),
         z.object({ type: z.literal("wait"), ms: z.number().int().min(0).max(30000) }),
         z.object({ type: z.literal("evaluate"), script: z.string() }),
@@ -813,49 +904,69 @@ labels, and states — everything needed to drive browser interactions.`,
                 return r.data;
             }
             case "click": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/click`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/click`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "hover": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/hover`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/hover`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "type": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/type`, { selector: action.selector, text: action.text, clear_first: action.clear_first });
+                const r = await fetch("POST", `/browser/sessions/${sid}/type`, {
+                    selector: action.selector,
+                    text: action.text,
+                    clear_first: action.clear_first,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "fill": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/fill`, { selector: action.selector, value: action.value });
+                const r = await fetch("POST", `/browser/sessions/${sid}/fill`, {
+                    selector: action.selector,
+                    value: action.value,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "select": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/select`, { selector: action.selector, value: action.value });
+                const r = await fetch("POST", `/browser/sessions/${sid}/select`, {
+                    selector: action.selector,
+                    value: action.value,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "check": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/check`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/check`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "uncheck": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/uncheck`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/uncheck`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "focus": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/focus`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/focus`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
@@ -867,13 +978,19 @@ labels, and states — everything needed to drive browser interactions.`,
                 return { ok: true };
             }
             case "scroll": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/scroll`, { direction: action.direction, distance: action.distance });
+                const r = await fetch("POST", `/browser/sessions/${sid}/scroll`, {
+                    direction: action.direction,
+                    distance: action.distance,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
             }
             case "drag": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/drag`, { source_selector: action.source_selector, target_selector: action.target_selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/drag`, {
+                    source_selector: action.source_selector,
+                    target_selector: action.target_selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
@@ -897,31 +1014,43 @@ labels, and states — everything needed to drive browser interactions.`,
                 return r.data;
             }
             case "get_text": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/get_text`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/get_text`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return r.data.text;
             }
             case "get_attribute": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/get_attribute`, { selector: action.selector, attribute: action.attribute });
+                const r = await fetch("POST", `/browser/sessions/${sid}/get_attribute`, {
+                    selector: action.selector,
+                    attribute: action.attribute,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return r.data;
             }
             case "get_html": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/get_html`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/get_html`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return r.data.html;
             }
             case "query_selector_all": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/query_selector_all`, { selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/query_selector_all`, {
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return r.data;
             }
             case "screenshot": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/screenshot`, { full_page: action.full_page, selector: action.selector });
+                const r = await fetch("POST", `/browser/sessions/${sid}/screenshot`, {
+                    full_page: action.full_page,
+                    selector: action.selector,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 // Return as data URI string so it fits in the JSON result array.
@@ -930,7 +1059,10 @@ labels, and states — everything needed to drive browser interactions.`,
                 return { mime_type: d.mime_type, data: d.data };
             }
             case "wait_for_selector": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/wait_for_selector`, { selector: action.selector, visible: action.visible });
+                const r = await fetch("POST", `/browser/sessions/${sid}/wait_for_selector`, {
+                    selector: action.selector,
+                    visible: action.visible,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return { ok: true };
@@ -948,7 +1080,9 @@ labels, and states — everything needed to drive browser interactions.`,
                 return { ok: true };
             }
             case "evaluate": {
-                const r = await fetch("POST", `/browser/sessions/${sid}/evaluate`, { script: action.script });
+                const r = await fetch("POST", `/browser/sessions/${sid}/evaluate`, {
+                    script: action.script,
+                });
                 if (!r.ok)
                     throw new Error(browserError(r));
                 return r.data;
@@ -956,7 +1090,11 @@ labels, and states — everything needed to drive browser interactions.`,
         }
     }
     server.registerTool("browser_batch", {
-        annotations: { title: "Run Batch of Browser Actions", readOnlyHint: false, destructiveHint: false },
+        annotations: {
+            title: "Run Batch of Browser Actions",
+            readOnlyHint: false,
+            destructiveHint: false,
+        },
         description: `Execute a sequence of browser actions in a single call against an existing session.
 
 Use this when you already know the full sequence of steps — it reduces round trips and
@@ -969,7 +1107,11 @@ Note: screenshots in batch results are returned as base64 strings inside the JSO
 For proper image rendering, use browser_screenshot directly.`,
         inputSchema: {
             session_id: sessionId,
-            actions: z.array(batchAction).min(1).max(50).describe("Ordered list of actions to perform. Each action has a 'type' field plus type-specific parameters."),
+            actions: z
+                .array(batchAction)
+                .min(1)
+                .max(50)
+                .describe("Ordered list of actions to perform. Each action has a 'type' field plus type-specific parameters."),
             stop_on_error: z.boolean().optional().describe("Stop executing on the first failed action (default true)"),
         },
     }, async ({ session_id, actions, stop_on_error = true }) => {
@@ -986,7 +1128,12 @@ For proper image rendering, use browser_screenshot directly.`,
                 results.push({ step: i, type: action.type, error: msg });
                 if (stop_on_error) {
                     return {
-                        content: [{ type: "text", text: JSON.stringify({ completed: i, total: actions.length, results }) }],
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ completed: i, total: actions.length, results }),
+                            },
+                        ],
                         isError: true,
                     };
                 }

package/dist/tools/extract.d.ts

@@ -0,0 +1,40 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function zrErrorCode(body: string): string | undefined;
+export type ExtractMode = "auto" | "autoparse" | "css";
+export type ExtractStealthOpts = {
+    css_extractor?: string;
+    js_render?: boolean;
+    premium_proxy?: boolean;
+    proxy_country?: string;
+    mode_auto?: boolean;
+    wait_for?: string;
+    wait?: number;
+};
+export type ExtractInput = ExtractStealthOpts & {
+    url: string;
+    mode?: ExtractMode;
+    fallback_autoparse?: boolean;
+};
+export type ExtractSuccess = {
+    ok: true;
+    mode: ExtractMode;
+    fellBackToAutoparse: boolean;
+    empty: boolean;
+    data: unknown;
+    html?: string;
+    raw?: string;
+};
+export type ExtractFailure = {
+    ok: false;
+    errorText: string;
+};
+export declare function buildExtractParams(apiKey: string, url: string, mode: ExtractMode, opts: ExtractStealthOpts): URLSearchParams;
+/**
+ * Core extract logic (testable). AUTH010 on mode=auto retries once with autoparse
+ * unless fallback_autoparse is false — same behavior as the CLI extract adapter.
+ */
+export declare function runExtract(apiKey: string, params: ExtractInput, options?: {
+    getClientName?: () => string | undefined;
+    fetchImpl?: typeof fetch;
+}): Promise<ExtractSuccess | ExtractFailure>;
+export declare function registerExtractTool(server: McpServer, apiKey: string, getClientName: () => string | undefined): void;