mcpscraper-sdk 0.23.0 → 0.24.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 175-tool MCP surface. It includes 85 MCP Scraper tools and all 90 mirrored Memory tools from `contracts/mcp.tools.json`.
+`client.tools` is the generated, typed 188-tool MCP surface. It includes 87 MCP Scraper tools and all 101 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.
 
@@ -57,6 +57,8 @@ await client.tools.connections.exportConnectedServiceData({
   dataset: 'resend_data',
   lastDays: 7,
 })
+const inbox = await client.tools.schedule.listScheduledRuns({ view: 'inbox' })
+const templates = await client.tools.schedule.listArtifactTemplates({ status: 'active' })
 ```
 
 The connected-data export performs bounded Gmail, Calendar, Google Search Console, Zoom, Meta Marketing, or Resend pagination server-side and returns small results inline or a private seven-day JSONL artifact. Use `exportConnectedServiceData({ dataset: 'search_console_performance' })` for a fresh Search Console API extract. A scheduled `connection_sync` maintains a typed `gsc_performance_*` table exposed as `listServiceConnections().tableName`; use `exportSearchConsoleTableData` for a server-filtered download from that persisted table. Use `meta_ads_insights` for daily account, campaign, ad-set, and ad reporting across connected Meta ad accounts. Resend can aggregate sent/received mail, logs, contacts, broadcasts, and templates with `resend_data`. Resume partial exports with the returned `continuation` object; renew an expired signed URL with `client.tools.connections.renewConnectedDataDownload({ artifactId })`. Use `listServiceConnections` for verified grants and per-tool permission blockers, then `describeServiceConnectionTool` for the exact provider-native schema before calling through the generic connection bridges.
@@ -115,4 +117,4 @@ npm run generate
 
 ## See also
 
-[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 92-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)
+[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 102-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)

package/dist/index.cjs

@@ -38,16 +38,29 @@ function readString(body, key) {
   }
   return void 0;
 }
+var PUBLIC_SERVICE_UNAVAILABLE_MESSAGE = "This operation is temporarily unavailable. Please retry later.";
+function publicErrorBody(status, body) {
+  if (status < 500) return body;
+  return {
+    error: "service_unavailable",
+    error_code: "service_unavailable",
+    error_type: "service_unavailable",
+    retryable: true,
+    status,
+    message: PUBLIC_SERVICE_UNAVAILABLE_MESSAGE
+  };
+}
 var ScraperApiError = class extends Error {
   status;
   code;
   body;
   constructor(status, body) {
-    super(readString(body, "message") ?? `mcpscraper.dev API request failed with status ${status}`);
+    const safeBody = publicErrorBody(status, body);
+    super(readString(safeBody, "message") ?? `mcpscraper.dev API request failed with status ${status}`);
     this.name = "ScraperApiError";
     this.status = status;
-    this.code = readString(body, "error_code") ?? readString(body, "error");
-    this.body = body;
+    this.code = readString(safeBody, "error_code") ?? readString(safeBody, "error");
+    this.body = safeBody;
   }
   isInsufficientBalance() {
     return this.code === "insufficient_balance";

package/dist/index.js

@@ -6,16 +6,29 @@ function readString(body, key) {
   }
   return void 0;
 }
+var PUBLIC_SERVICE_UNAVAILABLE_MESSAGE = "This operation is temporarily unavailable. Please retry later.";
+function publicErrorBody(status, body) {
+  if (status < 500) return body;
+  return {
+    error: "service_unavailable",
+    error_code: "service_unavailable",
+    error_type: "service_unavailable",
+    retryable: true,
+    status,
+    message: PUBLIC_SERVICE_UNAVAILABLE_MESSAGE
+  };
+}
 var ScraperApiError = class extends Error {
   status;
   code;
   body;
   constructor(status, body) {
-    super(readString(body, "message") ?? `mcpscraper.dev API request failed with status ${status}`);
+    const safeBody = publicErrorBody(status, body);
+    super(readString(safeBody, "message") ?? `mcpscraper.dev API request failed with status ${status}`);
     this.name = "ScraperApiError";
     this.status = status;
-    this.code = readString(body, "error_code") ?? readString(body, "error");
-    this.body = body;
+    this.code = readString(safeBody, "error_code") ?? readString(safeBody, "error");
+    this.body = safeBody;
   }
   isInsufficientBalance() {
     return this.code === "insufficient_balance";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.23.0",
-  "description": "Official Node.js client for all 175 mcpscraper.dev MCP tools and the REST API",
+  "version": "0.24.0",
+  "description": "Official Node.js client for all 188 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -32,7 +32,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.24.0"
+    "mcpscraper-memory-sdk": "^0.25.0"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"