mcpscraper-sdk 0.16.0 → 0.18.0

package/README.md

@@ -40,7 +40,7 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
 
 ## API surface
 
-`client.tools` is the generated, typed 165-tool MCP surface. It includes 76 MCP Scraper tools and all 89 mirrored memory tools from `contracts/mcp.tools.json`.
+`client.tools` is the generated, typed 166-tool MCP surface. It includes 77 MCP Scraper tools and all 89 mirrored memory tools from `contracts/mcp.tools.json`.
 
 For multimodal results such as `meta_ad_creative_media`, call `client.tools.callToolResult(...)` to preserve native MCP image/audio/resource blocks. `callTool(...)` remains backward-compatible and returns the parsed structured or text value.
 
@@ -110,4 +110,4 @@ npm run generate
 
 ## See also
 
-[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 89-tool typed surface) · [`mcpscraper-sdk` Python source package](../scraper-python) · [`mcpscraper-cli`](../cli)
+[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 89-tool typed surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)

package/dist/index.d.cts

@@ -885,8 +885,8 @@ interface components {
              * @default none
              * @enum {string}
              */
-            proxyMode: "location" | "configured" | "none";
-            /** @description US ZIP to localize the proxy egress to. */
+            proxyMode: "configured" | "none";
+            /** @description Optional US ZIP override. */
             proxyZip?: string;
             /**
              * @description Organic result pages to fetch.
@@ -1014,8 +1014,6 @@ interface components {
              * @default false
              */
             browserFallback: boolean;
-            /** @default false */
-            kernelFallback: boolean;
         };
         MapUrlsResponse: {
             urls?: string[];
@@ -1043,8 +1041,6 @@ interface components {
             rotateProxyEvery: number;
             /** @default false */
             browserFallback: boolean;
-            /** @default false */
-            kernelFallback: boolean;
             /**
              * @description Output formats to produce. `issues` runs a site-wide SEO audit over the crawl and
              *     returns `seoAudit` (in background mode, writes the `seo-audit.json` artifact).
@@ -1221,11 +1217,13 @@ interface components {
             hl: string;
             /** @default 10 */
             maxResults: number;
+            /** @default false */
+            includeServices: boolean;
             /**
-             * @default location
+             * @default none
              * @enum {string}
              */
-            proxyMode: "location" | "configured" | "none";
+            proxyMode: "configured" | "none";
             proxyZip?: string;
             /** @default false */
             debug: boolean;
@@ -1258,7 +1256,7 @@ interface components {
              * @default none
              * @enum {string}
              */
-            proxyMode: "location" | "configured" | "none";
+            proxyMode: "configured" | "none";
             proxyZip?: string;
             /** @default 1 */
             pages: number;
@@ -1407,7 +1405,7 @@ interface components {
             durationMs?: number;
             problemCode?: string;
             message?: string;
-            kernelSessionId?: string | null;
+            browserSessionId?: string | null;
             cleanupSucceeded?: boolean | null;
         };
         SerpIntelligenceCaptureResponse: {
@@ -1852,7 +1850,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description YouTube blocked the request (CAPTCHA) — billed amount was refunded. */
+            /** @description YouTube blocked the request — billed amount was refunded. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -1973,7 +1971,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Facebook blocked the request (CAPTCHA/soft-block) — billed amount was refunded. */
+            /** @description Facebook blocked the request — billed amount was refunded. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2347,7 +2345,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Blocked/CAPTCHA. */
+            /** @description Blocked. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2406,7 +2404,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Blocked/CAPTCHA. */
+            /** @description Blocked. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2614,7 +2612,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description CAPTCHA/blocked — retryable. */
+            /** @description Temporarily blocked — retryable. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2651,7 +2649,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description CAPTCHA/blocked — retryable. */
+            /** @description Temporarily blocked — retryable. */
             503: {
                 headers: {
                     [name: string]: unknown;

package/dist/index.d.ts

@@ -885,8 +885,8 @@ interface components {
              * @default none
              * @enum {string}
              */
-            proxyMode: "location" | "configured" | "none";
-            /** @description US ZIP to localize the proxy egress to. */
+            proxyMode: "configured" | "none";
+            /** @description Optional US ZIP override. */
             proxyZip?: string;
             /**
              * @description Organic result pages to fetch.
@@ -1014,8 +1014,6 @@ interface components {
              * @default false
              */
             browserFallback: boolean;
-            /** @default false */
-            kernelFallback: boolean;
         };
         MapUrlsResponse: {
             urls?: string[];
@@ -1043,8 +1041,6 @@ interface components {
             rotateProxyEvery: number;
             /** @default false */
             browserFallback: boolean;
-            /** @default false */
-            kernelFallback: boolean;
             /**
              * @description Output formats to produce. `issues` runs a site-wide SEO audit over the crawl and
              *     returns `seoAudit` (in background mode, writes the `seo-audit.json` artifact).
@@ -1221,11 +1217,13 @@ interface components {
             hl: string;
             /** @default 10 */
             maxResults: number;
+            /** @default false */
+            includeServices: boolean;
             /**
-             * @default location
+             * @default none
              * @enum {string}
              */
-            proxyMode: "location" | "configured" | "none";
+            proxyMode: "configured" | "none";
             proxyZip?: string;
             /** @default false */
             debug: boolean;
@@ -1258,7 +1256,7 @@ interface components {
              * @default none
              * @enum {string}
              */
-            proxyMode: "location" | "configured" | "none";
+            proxyMode: "configured" | "none";
             proxyZip?: string;
             /** @default 1 */
             pages: number;
@@ -1407,7 +1405,7 @@ interface components {
             durationMs?: number;
             problemCode?: string;
             message?: string;
-            kernelSessionId?: string | null;
+            browserSessionId?: string | null;
             cleanupSucceeded?: boolean | null;
         };
         SerpIntelligenceCaptureResponse: {
@@ -1852,7 +1850,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description YouTube blocked the request (CAPTCHA) — billed amount was refunded. */
+            /** @description YouTube blocked the request — billed amount was refunded. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -1973,7 +1971,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Facebook blocked the request (CAPTCHA/soft-block) — billed amount was refunded. */
+            /** @description Facebook blocked the request — billed amount was refunded. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2347,7 +2345,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Blocked/CAPTCHA. */
+            /** @description Blocked. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2406,7 +2404,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description Blocked/CAPTCHA. */
+            /** @description Blocked. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2614,7 +2612,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description CAPTCHA/blocked — retryable. */
+            /** @description Temporarily blocked — retryable. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -2651,7 +2649,7 @@ interface operations {
             402: components["responses"]["InsufficientBalance"];
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
-            /** @description CAPTCHA/blocked — retryable. */
+            /** @description Temporarily blocked — retryable. */
             503: {
                 headers: {
                     [name: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Official Node.js client for all 165 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.15.0"
+    "mcpscraper-memory-sdk": "^0.18.0"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"