mcpscraper-cli 0.41.0 → 0.43.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 375 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 375 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 '{}'`.
 
@@ -138,3 +138,5 @@ $ mcpscraper map https://example.com --json
 ## See also
 
 [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.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.41.0";
+var CLI_VERSION = "0.43.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",
@@ -20480,6 +20508,80 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "facebook_reels_inventory",
+    "category": "facebook",
+    "title": "Facebook Profile Reel URL Inventory",
+    "description": "Discover public Reel URLs before choosing individual videos for facebook_video_transcribe. Collect canonical Reel URLs from a Facebook profile or Page without opening individual Reels. Logged-out scans are capped at 60 URLs. Pass a saved Facebook browser profile to continue toward a larger maxUrls request. Progress is preserved: if Facebook interrupts pagination after URLs were found, the tool returns them as a partial result with an explicit stopping reason; pass those URLs back in resumeUrls to retain and deduplicate them during a new scan. This is live browser collection, not an exhaustive history or a stored cursor. Scans cost 4 credits and are refunded if no new URLs are added.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Public Facebook profile or Page URL whose Reel URLs should be collected. Do not pass an individual Reel, video, post, share, group, or event URL."
+        },
+        "maxUrls": {
+          "default": 60,
+          "description": "Maximum Reel URLs requested. Logged-out collection is capped at 60 even when this is higher; a valid saved Facebook browser profile can continue toward the requested maximum.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2e3
+        },
+        "profile": {
+          "description": "Optional saved hosted browser profile name containing a Facebook login. Set one up with browser_profile_connect first. An expired or logged-out profile falls back to the anonymous 60-URL cap.",
+          "type": "string",
+          "minLength": 1
+        },
+        "saveProfileChanges": {
+          "description": "Save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved Facebook login.",
+          "type": "boolean"
+        },
+        "resumeUrls": {
+          "default": [],
+          "description": "Previously returned Reel URLs to retain and deduplicate while continuing an interrupted collection.",
+          "maxItems": 2e3,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "maxScrolls": {
+          "default": 250,
+          "description": "Safety ceiling for pagination attempts. Default 250; collection normally stops earlier at maxUrls or a Facebook access boundary.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 250
+        },
+        "scrollDelayMs": {
+          "default": 1200,
+          "description": "Delay after each scroll before collecting the next DOM batch.",
+          "type": "integer",
+          "minimum": 250,
+          "maximum": 5e3
+        },
+        "stableScrollLimit": {
+          "default": 4,
+          "description": "Stop after this many consecutive pagination attempts add no Reel URLs.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Facebook Profile Reel URL Inventory",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
   {
     "name": "facebook_video_transcribe",
     "category": "facebook",
@@ -21857,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",
@@ -21964,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",
@@ -27210,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": "Start a durable Google SERP lookup without PAA expansion and return a job receipt before ordinary MCP client deadlines. Poll the returned jobId with search_serp_status; replaying the same idempotencyKey recovers the same search without another charge. 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": {
@@ -27316,6 +27418,34 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "search_serp_status",
+    "category": "other",
+    "title": "Check Durable Google SERP Lookup",
+    "description": "Poll the owner-scoped job returned by search_serp. Polling never starts or bills another search. Terminal success returns the same organic, local, AI, and entity output fields as the completed lookup.",
+    "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.41.0",
+  "version": "0.43.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.42.0"
+    "mcpscraper-sdk": "^0.44.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"