mcpscraper-sdk 0.29.0 → 0.30.1

package/README.md

@@ -45,7 +45,7 @@ Current Google search pricing is 60 Credits per SERP search and 400 Credits plus
 
 ## API surface
 
-`client.tools` is the generated, typed 254-tool MCP surface. It includes 153 MCP Scraper tools and all 101 mirrored Memory tools from `contracts/mcp.tools.json`.
+`client.tools` is the generated, typed 259-tool MCP surface. It includes 158 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.
 
@@ -66,6 +66,21 @@ const inbox = await client.tools.schedule.listScheduledRuns({ view: 'inbox' })
 const templates = await client.tools.schedule.listArtifactTemplates({ status: 'active' })
 ```
 
+Lead enrichment is available through the same generated surface. Supply mapped rows directly, or call `client.tools.leads.import(...)` first for CSV/TSV/XLSX input:
+
+```ts
+const job = await client.tools.leads.enrich({
+  idempotencyKey: crypto.randomUUID(),
+  source: { kind: 'rows', rows: [{ Business: 'White Rock Roofing', City: 'Dallas', Website: 'https://roofwhiterock.com' }] },
+  columnMap: { name: 'Business', city: 'City', websiteUrl: 'Website' },
+  defaultEntityType: 'business',
+  emailSearchFallback: 'serp_snippets',
+  peopleDiscovery: 'owners',
+  peopleQueryTemplates: ['{business} owner of company {city}', '{business} founder {city}'],
+  outputFormats: ['csv', 'xlsx'],
+})
+```
+
 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.
 
 Search Console also provides six API-only batches through those connection bridges: reads `inspect-urls` and `query-search-analytics-batch`, and gated actions `add-sites-batch`, `submit-sitemaps-batch`, `delete-sites-batch`, and `delete-sitemaps-batch`. They require no database, return per-item receipts, and can be bound to scheduled agent runs. Delete batches default to dry-run and require the live schema's exact confirmation token for execution; all actions require the connection's action switch.

package/dist/index.cjs

@@ -189,7 +189,7 @@ var Requester = class {
           error: "mcp_request_timeout",
           error_code: "mcp_request_timeout",
           error_type: "timeout",
-          message: `MCP Scraper request exceeded ${Math.round(this.timeoutMs / 1e3)}s and was cancelled client-side. The operation may still be running; use the same Idempotency-Key or poll a returned job before starting a new paid run.`,
+          message: `The client stopped waiting after ${Math.round(this.timeoutMs / 1e3)}s. This does not prove server-side work stopped; use the same Idempotency-Key or poll a returned job before starting a new paid run.`,
           retryable: true
         });
       }
@@ -457,7 +457,7 @@ var ScraperClient = class {
   memoryTools;
   tools;
   constructor(options) {
-    const requestTimeoutMs = options.requestTimeoutMs ?? 3e5;
+    const requestTimeoutMs = options.requestTimeoutMs ?? 59e4;
     if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) throw new TypeError("requestTimeoutMs must be a positive number");
     this.r = new Requester(options.apiKey, options.baseUrl ?? "https://mcpscraper.dev", options.fetch ?? globalThis.fetch, requestTimeoutMs);
     this.youtube = new YoutubeNamespace(this.r);

package/dist/index.d.cts

@@ -3484,7 +3484,7 @@ interface ScraperClientOptions {
     apiKey: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;
-    /** Bounded HTTP deadline for every request. Defaults to 300 seconds. */
+    /** Bounded HTTP wait window for every request. Defaults to 590 seconds. */
     requestTimeoutMs?: number;
 }
 interface IdempotentRequestOptions {

package/dist/index.d.ts

@@ -3484,7 +3484,7 @@ interface ScraperClientOptions {
     apiKey: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;
-    /** Bounded HTTP deadline for every request. Defaults to 300 seconds. */
+    /** Bounded HTTP wait window for every request. Defaults to 590 seconds. */
     requestTimeoutMs?: number;
 }
 interface IdempotentRequestOptions {

package/dist/index.js

@@ -174,7 +174,7 @@ var Requester = class {
           error: "mcp_request_timeout",
           error_code: "mcp_request_timeout",
           error_type: "timeout",
-          message: `MCP Scraper request exceeded ${Math.round(this.timeoutMs / 1e3)}s and was cancelled client-side. The operation may still be running; use the same Idempotency-Key or poll a returned job before starting a new paid run.`,
+          message: `The client stopped waiting after ${Math.round(this.timeoutMs / 1e3)}s. This does not prove server-side work stopped; use the same Idempotency-Key or poll a returned job before starting a new paid run.`,
           retryable: true
         });
       }
@@ -442,7 +442,7 @@ var ScraperClient = class {
   memoryTools;
   tools;
   constructor(options) {
-    const requestTimeoutMs = options.requestTimeoutMs ?? 3e5;
+    const requestTimeoutMs = options.requestTimeoutMs ?? 59e4;
     if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) throw new TypeError("requestTimeoutMs must be a positive number");
     this.r = new Requester(options.apiKey, options.baseUrl ?? "https://mcpscraper.dev", options.fetch ?? globalThis.fetch, requestTimeoutMs);
     this.youtube = new YoutubeNamespace(this.r);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.29.0",
-  "description": "Official Node.js client for all 254 mcpscraper.dev MCP tools and the REST API",
+  "version": "0.30.1",
+  "description": "Official Node.js client for all 259 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.30.0"
+    "mcpscraper-memory-sdk": "^0.31.1"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"