mcpscraper-sdk 0.17.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +1 -1
  2. package/dist/index.d.cts +11 -15
  3. package/dist/index.d.ts +11 -15
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -40,7 +40,7 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
40
40
 
41
41
  ## API surface
42
42
 
43
- `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`.
43
+ `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`.
44
44
 
45
45
  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.
46
46
 
package/dist/index.d.cts CHANGED
@@ -885,8 +885,8 @@ interface components {
885
885
  * @default none
886
886
  * @enum {string}
887
887
  */
888
- proxyMode: "location" | "configured" | "none";
889
- /** @description US ZIP to localize the proxy egress to. */
888
+ proxyMode: "configured" | "none";
889
+ /** @description Optional US ZIP override. */
890
890
  proxyZip?: string;
891
891
  /**
892
892
  * @description Organic result pages to fetch.
@@ -1014,8 +1014,6 @@ interface components {
1014
1014
  * @default false
1015
1015
  */
1016
1016
  browserFallback: boolean;
1017
- /** @default false */
1018
- kernelFallback: boolean;
1019
1017
  };
1020
1018
  MapUrlsResponse: {
1021
1019
  urls?: string[];
@@ -1043,8 +1041,6 @@ interface components {
1043
1041
  rotateProxyEvery: number;
1044
1042
  /** @default false */
1045
1043
  browserFallback: boolean;
1046
- /** @default false */
1047
- kernelFallback: boolean;
1048
1044
  /**
1049
1045
  * @description Output formats to produce. `issues` runs a site-wide SEO audit over the crawl and
1050
1046
  * returns `seoAudit` (in background mode, writes the `seo-audit.json` artifact).
@@ -1227,7 +1223,7 @@ interface components {
1227
1223
  * @default none
1228
1224
  * @enum {string}
1229
1225
  */
1230
- proxyMode: "location" | "configured" | "none";
1226
+ proxyMode: "configured" | "none";
1231
1227
  proxyZip?: string;
1232
1228
  /** @default false */
1233
1229
  debug: boolean;
@@ -1260,7 +1256,7 @@ interface components {
1260
1256
  * @default none
1261
1257
  * @enum {string}
1262
1258
  */
1263
- proxyMode: "location" | "configured" | "none";
1259
+ proxyMode: "configured" | "none";
1264
1260
  proxyZip?: string;
1265
1261
  /** @default 1 */
1266
1262
  pages: number;
@@ -1409,7 +1405,7 @@ interface components {
1409
1405
  durationMs?: number;
1410
1406
  problemCode?: string;
1411
1407
  message?: string;
1412
- kernelSessionId?: string | null;
1408
+ browserSessionId?: string | null;
1413
1409
  cleanupSucceeded?: boolean | null;
1414
1410
  };
1415
1411
  SerpIntelligenceCaptureResponse: {
@@ -1854,7 +1850,7 @@ interface operations {
1854
1850
  402: components["responses"]["InsufficientBalance"];
1855
1851
  429: components["responses"]["ConcurrencyLimitExceeded"];
1856
1852
  500: components["responses"]["ServerError"];
1857
- /** @description YouTube blocked the request (CAPTCHA) — billed amount was refunded. */
1853
+ /** @description YouTube blocked the request — billed amount was refunded. */
1858
1854
  503: {
1859
1855
  headers: {
1860
1856
  [name: string]: unknown;
@@ -1975,7 +1971,7 @@ interface operations {
1975
1971
  402: components["responses"]["InsufficientBalance"];
1976
1972
  429: components["responses"]["ConcurrencyLimitExceeded"];
1977
1973
  500: components["responses"]["ServerError"];
1978
- /** @description Facebook blocked the request (CAPTCHA/soft-block) — billed amount was refunded. */
1974
+ /** @description Facebook blocked the request — billed amount was refunded. */
1979
1975
  503: {
1980
1976
  headers: {
1981
1977
  [name: string]: unknown;
@@ -2349,7 +2345,7 @@ interface operations {
2349
2345
  402: components["responses"]["InsufficientBalance"];
2350
2346
  429: components["responses"]["ConcurrencyLimitExceeded"];
2351
2347
  500: components["responses"]["ServerError"];
2352
- /** @description Blocked/CAPTCHA. */
2348
+ /** @description Blocked. */
2353
2349
  503: {
2354
2350
  headers: {
2355
2351
  [name: string]: unknown;
@@ -2408,7 +2404,7 @@ interface operations {
2408
2404
  402: components["responses"]["InsufficientBalance"];
2409
2405
  429: components["responses"]["ConcurrencyLimitExceeded"];
2410
2406
  500: components["responses"]["ServerError"];
2411
- /** @description Blocked/CAPTCHA. */
2407
+ /** @description Blocked. */
2412
2408
  503: {
2413
2409
  headers: {
2414
2410
  [name: string]: unknown;
@@ -2616,7 +2612,7 @@ interface operations {
2616
2612
  402: components["responses"]["InsufficientBalance"];
2617
2613
  429: components["responses"]["ConcurrencyLimitExceeded"];
2618
2614
  500: components["responses"]["ServerError"];
2619
- /** @description CAPTCHA/blocked — retryable. */
2615
+ /** @description Temporarily blocked — retryable. */
2620
2616
  503: {
2621
2617
  headers: {
2622
2618
  [name: string]: unknown;
@@ -2653,7 +2649,7 @@ interface operations {
2653
2649
  402: components["responses"]["InsufficientBalance"];
2654
2650
  429: components["responses"]["ConcurrencyLimitExceeded"];
2655
2651
  500: components["responses"]["ServerError"];
2656
- /** @description CAPTCHA/blocked — retryable. */
2652
+ /** @description Temporarily blocked — retryable. */
2657
2653
  503: {
2658
2654
  headers: {
2659
2655
  [name: string]: unknown;
package/dist/index.d.ts CHANGED
@@ -885,8 +885,8 @@ interface components {
885
885
  * @default none
886
886
  * @enum {string}
887
887
  */
888
- proxyMode: "location" | "configured" | "none";
889
- /** @description US ZIP to localize the proxy egress to. */
888
+ proxyMode: "configured" | "none";
889
+ /** @description Optional US ZIP override. */
890
890
  proxyZip?: string;
891
891
  /**
892
892
  * @description Organic result pages to fetch.
@@ -1014,8 +1014,6 @@ interface components {
1014
1014
  * @default false
1015
1015
  */
1016
1016
  browserFallback: boolean;
1017
- /** @default false */
1018
- kernelFallback: boolean;
1019
1017
  };
1020
1018
  MapUrlsResponse: {
1021
1019
  urls?: string[];
@@ -1043,8 +1041,6 @@ interface components {
1043
1041
  rotateProxyEvery: number;
1044
1042
  /** @default false */
1045
1043
  browserFallback: boolean;
1046
- /** @default false */
1047
- kernelFallback: boolean;
1048
1044
  /**
1049
1045
  * @description Output formats to produce. `issues` runs a site-wide SEO audit over the crawl and
1050
1046
  * returns `seoAudit` (in background mode, writes the `seo-audit.json` artifact).
@@ -1227,7 +1223,7 @@ interface components {
1227
1223
  * @default none
1228
1224
  * @enum {string}
1229
1225
  */
1230
- proxyMode: "location" | "configured" | "none";
1226
+ proxyMode: "configured" | "none";
1231
1227
  proxyZip?: string;
1232
1228
  /** @default false */
1233
1229
  debug: boolean;
@@ -1260,7 +1256,7 @@ interface components {
1260
1256
  * @default none
1261
1257
  * @enum {string}
1262
1258
  */
1263
- proxyMode: "location" | "configured" | "none";
1259
+ proxyMode: "configured" | "none";
1264
1260
  proxyZip?: string;
1265
1261
  /** @default 1 */
1266
1262
  pages: number;
@@ -1409,7 +1405,7 @@ interface components {
1409
1405
  durationMs?: number;
1410
1406
  problemCode?: string;
1411
1407
  message?: string;
1412
- kernelSessionId?: string | null;
1408
+ browserSessionId?: string | null;
1413
1409
  cleanupSucceeded?: boolean | null;
1414
1410
  };
1415
1411
  SerpIntelligenceCaptureResponse: {
@@ -1854,7 +1850,7 @@ interface operations {
1854
1850
  402: components["responses"]["InsufficientBalance"];
1855
1851
  429: components["responses"]["ConcurrencyLimitExceeded"];
1856
1852
  500: components["responses"]["ServerError"];
1857
- /** @description YouTube blocked the request (CAPTCHA) — billed amount was refunded. */
1853
+ /** @description YouTube blocked the request — billed amount was refunded. */
1858
1854
  503: {
1859
1855
  headers: {
1860
1856
  [name: string]: unknown;
@@ -1975,7 +1971,7 @@ interface operations {
1975
1971
  402: components["responses"]["InsufficientBalance"];
1976
1972
  429: components["responses"]["ConcurrencyLimitExceeded"];
1977
1973
  500: components["responses"]["ServerError"];
1978
- /** @description Facebook blocked the request (CAPTCHA/soft-block) — billed amount was refunded. */
1974
+ /** @description Facebook blocked the request — billed amount was refunded. */
1979
1975
  503: {
1980
1976
  headers: {
1981
1977
  [name: string]: unknown;
@@ -2349,7 +2345,7 @@ interface operations {
2349
2345
  402: components["responses"]["InsufficientBalance"];
2350
2346
  429: components["responses"]["ConcurrencyLimitExceeded"];
2351
2347
  500: components["responses"]["ServerError"];
2352
- /** @description Blocked/CAPTCHA. */
2348
+ /** @description Blocked. */
2353
2349
  503: {
2354
2350
  headers: {
2355
2351
  [name: string]: unknown;
@@ -2408,7 +2404,7 @@ interface operations {
2408
2404
  402: components["responses"]["InsufficientBalance"];
2409
2405
  429: components["responses"]["ConcurrencyLimitExceeded"];
2410
2406
  500: components["responses"]["ServerError"];
2411
- /** @description Blocked/CAPTCHA. */
2407
+ /** @description Blocked. */
2412
2408
  503: {
2413
2409
  headers: {
2414
2410
  [name: string]: unknown;
@@ -2616,7 +2612,7 @@ interface operations {
2616
2612
  402: components["responses"]["InsufficientBalance"];
2617
2613
  429: components["responses"]["ConcurrencyLimitExceeded"];
2618
2614
  500: components["responses"]["ServerError"];
2619
- /** @description CAPTCHA/blocked — retryable. */
2615
+ /** @description Temporarily blocked — retryable. */
2620
2616
  503: {
2621
2617
  headers: {
2622
2618
  [name: string]: unknown;
@@ -2653,7 +2649,7 @@ interface operations {
2653
2649
  402: components["responses"]["InsufficientBalance"];
2654
2650
  429: components["responses"]["ConcurrencyLimitExceeded"];
2655
2651
  500: components["responses"]["ServerError"];
2656
- /** @description CAPTCHA/blocked — retryable. */
2652
+ /** @description Temporarily blocked — retryable. */
2657
2653
  503: {
2658
2654
  headers: {
2659
2655
  [name: string]: unknown;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcpscraper-sdk",
3
- "version": "0.17.0",
3
+ "version": "0.18.0",
4
4
  "description": "Official Node.js client for all 165 mcpscraper.dev MCP tools and the REST API",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -32,7 +32,7 @@
32
32
  "seo-api"
33
33
  ],
34
34
  "dependencies": {
35
- "mcpscraper-memory-sdk": "^0.15.0"
35
+ "mcpscraper-memory-sdk": "^0.18.0"
36
36
  },
37
37
  "devDependencies": {
38
38
  "openapi-typescript": "^7.13.0"