mcpscraper-cli 0.42.0 → 0.44.0

package/README.md

@@ -4,7 +4,7 @@ Command-line interface for the unified [mcpscraper.dev](https://mcpscraper.dev)
 
 [Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/blob/main/CHANGELOG.md)
 
-The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 376 unified MCP tools, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
+The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 378 unified MCP tools, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
 
 ## Install
 
@@ -41,7 +41,7 @@ mcpscraper tools call gmail_prepare_selection --args '{"connectionId":"gmail_con
 mcpscraper tools call gmail_import_status --args '{"ingestId":"opaque_ingest_id"}' --json
 ```
 
-`tools list` contains exactly 376 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
+`tools list` contains exactly 378 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
 
 Integration connections are included with an active Starter plan or higher and have no extra connection-operation debit in this release. Scheduled occurrences cost 75 Credits; agent-mode runs also add 1.5 times OpenRouter's actual reported cost. Inspect the live policy with `mcpscraper tools call get-schedule-status --args '{}'`.
 
@@ -139,4 +139,4 @@ $ mcpscraper map https://example.com --json
 
 [Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-sdk`](../scraper) · [`mcpscraper-memory-sdk`](../memory) · Python: [`mcpscraper-sdk`](../scraper-python) · [`mcpscraper-memory-sdk`](../memory-python)
 
-Release changes: [SDK 0.43.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.43.0).
+Release changes: [SDK 0.44.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.44.0).

package/dist/bin/cli.js

@@ -10,7 +10,7 @@ import { randomUUID } from "crypto";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 
 // src/version.ts
-var CLI_VERSION = "0.42.0";
+var CLI_VERSION = "0.44.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -11987,10 +11987,10 @@ var MCP_TOOL_CATALOG = [
           "type": "boolean"
         },
         "timeout_seconds": {
-          "description": "Session lifetime before auto-termination. Defaults to 600.",
+          "description": "Session lifetime before auto-termination. Defaults to 600 and cannot exceed 600.",
           "type": "integer",
           "minimum": 60,
-          "maximum": 259200
+          "maximum": 600
         },
         "extension_names": {
           "description": "Names of extensions previously added with browser_extension_import (see browser_extension_list for what's available) to load into this session. Loading extensions restarts the browser, adding a few seconds to startup.",
@@ -12084,10 +12084,10 @@ var MCP_TOOL_CATALOG = [
           "type": "string"
         },
         "timeout_seconds": {
-          "description": "Sign-in session lifetime before auto-termination. Defaults to 600.",
+          "description": "Sign-in session lifetime before auto-termination. Defaults to 600 and cannot exceed 600.",
           "type": "integer",
           "minimum": 60,
-          "maximum": 259200
+          "maximum": 600
         }
       },
       "$schema": "https://json-schema.org/draft/2020-12/schema"
@@ -20252,7 +20252,7 @@ var MCP_TOOL_CATALOG = [
     "name": "extract_url",
     "category": "web",
     "title": "Single URL Extract",
-    "description": "Extract structured data from one public URL: content, schema, headings, metadata, screenshots, branding, featured image, or media assets. Tries a plain HTTP fetch first and only opens a stealth browser when that fetch is blocked, hits a bot check, or returns unusably thin content \u2014 most calls never need the browser, and a bot_check_unresolved error means the browser already tried and failed, not that a retry will help. Wayback replay URLs automatically return the archived page copy without playback chrome. Use delivery:auto for bounded inline results with automatic artifact offload, delivery:artifact for a durable owner-scoped report, or delivery:memory to save the full page into hosted MCP Memory. preserveMedia is the preferred media-retention flag; depositToVault and downloadMedia remain temporary compatibility aliases.",
+    "description": "Start a durable extraction of one public URL and return a job receipt before ordinary MCP client deadlines. Poll jobId with extract_url_status; replaying the same idempotencyKey recovers the same extraction without another charge. Extracts content, schema, headings, metadata, screenshots, branding, featured image, or media assets. Tries plain HTTP first and opens a stealth browser only for blocked, challenged, or unusably thin content. Wayback replay URLs return archived copy without playback chrome. Use delivery:auto for bounded output, artifact for an owner-scoped report, or memory to retain the full page.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -20363,10 +20363,38 @@ var MCP_TOOL_CATALOG = [
       "title": "Single URL Extract",
       "readOnlyHint": false,
       "destructiveHint": false,
-      "idempotentHint": false,
+      "idempotentHint": true,
       "openWorldHint": true
     }
   },
+  {
+    "name": "extract_url_status",
+    "category": "other",
+    "title": "Check Durable Single URL Extract",
+    "description": "Poll the owner-scoped job returned by extract_url. Polling never starts or bills another extraction. Terminal success returns the extracted page result; terminal failure returns the settled public error and billing state.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "description": "The jobId returned by extract_url. Polling never starts or bills another extraction."
+        }
+      },
+      "required": [
+        "jobId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Check Durable Single URL Extract",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "facebook_ad_search",
     "category": "facebook",
@@ -21931,10 +21959,10 @@ var MCP_TOOL_CATALOG = [
         },
         "maxQuestions": {
           "default": 30,
-          "description": "PAA questions to extract. Default 30, maximum 200. Use 10 for quick probes, 100-200 for deep research. Billed per extracted question; unused hold refunded.",
+          "description": "PAA questions to extract. Default 30, maximum 100. Use 10 for quick probes and 100 for deep research. Billed per extracted question; unused hold refunded.",
           "type": "integer",
           "minimum": 1,
-          "maximum": 200
+          "maximum": 100
         },
         "gl": {
           "default": "us",
@@ -22038,10 +22066,10 @@ var MCP_TOOL_CATALOG = [
         },
         "maxQuestions": {
           "default": 30,
-          "description": "PAA questions to extract. Default 30, maximum 200. Use 10 for quick probes, 100-200 for deep research. Billed per extracted question; unused hold refunded.",
+          "description": "PAA questions to extract. Default 30, maximum 100. Use 10 for quick probes and 100 for deep research. Billed per extracted question; unused hold refunded.",
           "type": "integer",
           "minimum": 1,
-          "maximum": 200
+          "maximum": 100
         },
         "gl": {
           "default": "us",
@@ -27284,7 +27312,7 @@ var MCP_TOOL_CATALOG = [
     "name": "search_serp",
     "category": "search",
     "title": "Google SERP Lookup",
-    "description": "Google SERP lookup without PAA expansion. Defaults to organic rankings and Google entity IDs; request local pack, forums, videos, AI surfaces, and What People Are Saying with individual include flags or includeAllSerpFeatures at the same product price. Use gl for country and location only when city or regional context matters. Costs 60 Credits per search. Call credits_info for current pricing and balance.",
+    "description": "Run one bounded Google SERP lookup without PAA expansion. The server sends query exactly as supplied, returns directly instead of creating a background Task, and stops within its short server deadline. Reuse the same idempotencyKey after an unknown response to recover the same billed operation. Defaults to organic rankings and Google entity IDs; request local pack, forums, videos, AI surfaces, and What People Are Saying with individual include flags or includeAllSerpFeatures at the same product price. Use gl for country and location only when city or regional context matters. Costs 60 Credits per search. Call credits_info for current pricing and balance.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -27390,6 +27418,34 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "search_serp_status",
+    "category": "other",
+    "title": "Check Durable Google SERP Lookup",
+    "description": "Read an existing durable SERP job created through the legacy HTTP job API. Ordinary search_serp calls now return directly and do not create a job to poll. Reading status never starts or bills another search.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "description": "The jobId returned by search_serp."
+        }
+      },
+      "required": [
+        "jobId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Check Durable Google SERP Lookup",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "serp_identity_create",
     "category": "search",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.42.0",
+  "version": "0.44.0",
   "description": "Command-line interface for the unified mcpscraper.dev MCP and REST APIs",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "mcpscraper-sdk": "^0.43.0"
+    "mcpscraper-sdk": "^0.45.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"