mcpscraper-cli 0.48.0 → 0.49.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 362 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 364 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 362 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
+`tools list` contains exactly 364 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 '{}'`.
 

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.48.0";
+var CLI_VERSION = "0.49.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -23214,7 +23214,7 @@ var MCP_TOOL_CATALOG = [
     "name": "maps_place_intel",
     "category": "maps",
     "title": "Google Maps Business Profile Details",
-    "description": 'Deep-dive one known/named Google Business Profile: rating, reviews, category, address, phone, website, full hours, About attributes, entity IDs/CID, configured services/areas, and optional photos. Set includeImages:true for a provenance-aware manifest, bounded AI image blocks, and an owner-scoped ZIP; choose imageScope:"owner" for listing-owner photos only. Not for category searches or multi-business prospect lists; use maps_search for those. Split business name from location.',
+    "description": 'Deep-dive one known/named Google Business Profile: rating, reviews, category, address, phone, website, full hours, About attributes, entity IDs/CID, configured services/areas, and optional photos. Use include:["all"] for every supported field group, with maxReviews and maxImages as limits; existing includeReviews, includeServices, and includeImages flags also work. Set includeImages:true for a provenance-aware manifest, bounded AI image blocks, and an owner-scoped ZIP; choose imageScope:"owner" for listing-owner photos only. Not for category searches or multi-business prospect lists; use maps_search for those. Split business name from location.',
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -23256,7 +23256,7 @@ var MCP_TOOL_CATALOG = [
         },
         "includeServices": {
           "default": false,
-          "description": "Fetch the business's configured services list and areas-served list, when the profile has them. Adds one extra page visit; not present for every business.",
+          "description": "Collect the exact business's configured services and areas served when available. These fields are absent on some profiles.",
           "type": "boolean"
         },
         "includeImages": {
@@ -23264,6 +23264,22 @@ var MCP_TOOL_CATALOG = [
           "description": "Collect Google Maps listing photos, download them, and return an AI-readable manifest plus an owner-scoped ZIP artifact. The gallery is scrolled until quiescent or maxImages is reached.",
           "type": "boolean"
         },
+        "include": {
+          "description": "Requested place field groups. all requests every supported group while maxReviews and maxImages still cap collection. Existing includeReviews, includeServices, and includeImages flags remain valid.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "core",
+              "hours",
+              "services",
+              "areasServed",
+              "reviews",
+              "images",
+              "all"
+            ]
+          }
+        },
         "imageScope": {
           "default": "all",
           "description": "owner collects only the Google Maps By owner gallery. all collects the full gallery and labels exact owner matches versus other/unknown media.",
@@ -23302,21 +23318,99 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "maps_place_resume",
+    "category": "maps",
+    "title": "Resume Google Maps Place Run",
+    "description": "Explicitly resume a partial Maps place run using a fresh idempotency key. This may launch a new paid provider attempt and requires a new maximum credit authorization. Repeating the same key only reads its status.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Partial or reconciled interrupted Maps place run to resume."
+        },
+        "resumeIdempotencyKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "A new key for this explicit attempt; reuse the same key to read its status."
+        }
+      },
+      "required": [
+        "runId",
+        "resumeIdempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Resume Google Maps Place Run",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "maps_place_status",
+    "category": "maps",
+    "title": "Google Maps Place Run Status",
+    "description": "Read a saved Maps place run by ID, including partial results and paginated reviews or images. This read never starts a browser or creates a charge.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "runId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Maps place run ID returned by maps_place_intel."
+        },
+        "reviewsCursor": {
+          "description": "Opaque cursor for the next page of saved reviews.",
+          "type": "string"
+        },
+        "imagesCursor": {
+          "description": "Opaque cursor for the next page of saved images.",
+          "type": "string"
+        },
+        "limit": {
+          "default": 50,
+          "description": "Page size; reviews are capped at 50 and images at 100.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        }
+      },
+      "required": [
+        "runId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Google Maps Place Run Status",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
   {
     "name": "maps_search",
     "category": "maps",
     "title": "Google Maps Business Search",
-    "description": "Search Google Maps for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. Use gl for country and location only when city or regional context matters. Returns up to 50 candidates (default 10) with names, place URLs, CIDs, and ratings. Set includeServices:true to expand each selected profile and return its complete configured services and areas served when available.",
+    "description": "Search Google Maps for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. For ordinary searches, enter a US state in location to target that state; omit location for direct search. Returns up to 50 candidates (default 10) with names, place URLs, CIDs, and ratings. Set includeServices:true to open organic Businesses profiles for configured services and areas served when available.",
     "inputSchema": {
       "type": "object",
       "properties": {
         "query": {
           "type": "string",
           "minLength": 1,
-          "description": 'Business category, niche, or search term, e.g. "roofers". You may include the place here; Google Maps has no UULE, so the server appends location to the search text only when the query does not already name it.'
+          "description": 'Business category, niche, or search term, e.g. "roofers".'
         },
         "location": {
-          "description": 'City, region, country, or service area, e.g. "Denver, CO".',
+          "description": "Enter a US state name or code, e.g. Utah or UT, for a state-targeted search. Omit for direct search.",
           "type": "string"
         },
         "gl": {
@@ -23342,7 +23436,7 @@ var MCP_TOOL_CATALOG = [
         },
         "includeServices": {
           "default": false,
-          "description": "Open each returned business profile to include its configured services and areas served when available. Adds a page visit per business; does not collect review cards.",
+          "description": "Open organic Businesses profiles for configured services and areas served. For more than three requested results, first click More businesses. Does not collect review cards; plain searches use the Google Maps feed.",
           "type": "boolean"
         }
       },
@@ -26229,13 +26323,13 @@ var MCP_TOOL_CATALOG = [
     "name": "search_serp",
     "category": "search",
     "title": "Google SERP Lookup",
-    "description": "Search Google once. Light mode (default) returns organic position, URL, title, and description. Full mode returns those results plus available same-page SERP features: local pack, discussions/forums, videos, AI Overview, AI Mode, What People Are Saying, entity IDs, and on-page PAA preview when present. Feature status distinguishes present, absent, incomplete, unknown, and unsupported. Both modes default to one page; set pages:2 only when the user explicitly requests two pages. Full does not expand PAA, open Maps profiles, or scrape result sites. Light costs 20 Credits per delivered page, or 35 if the backup supplies it; full costs 35 Credits per delivered page. Reuse the same idempotencyKey after an unknown response to recover the same billed operation. A saved serpIdentity uses its browser context and retains its 60-Credit search rate; it cannot be combined with full mode. Call credits_info for current pricing and balance.",
+    "description": "Search Google once. Light mode (default) returns organic position, URL, title, and description. Full mode returns those results plus available same-page SERP features: local pack, discussions/forums, videos, AI Overview, AI Mode, What People Are Saying, entity IDs, and on-page PAA preview when present. Feature status distinguishes present, absent, incomplete, unknown, and unsupported. Both modes default to one page; set pages:2 only when the user explicitly requests two pages. Two-page requests use organic results only and mark rich features unsupported. If page 2 fails, an available page 1 is returned as partial and billed for one delivered page. Full does not expand PAA, open Maps profiles, or scrape result sites. Light costs 20 Credits per delivered page, or 35 if the backup supplies it; one-page full costs 35 Credits; explicit two-page full costs 40 Credits for organic results only. Reuse the same idempotencyKey after an unknown response to recover the same billed operation. A saved serpIdentity uses its browser context and retains its 60-Credit search rate; it cannot be combined with full mode. Call credits_info for current pricing and balance.",
     "inputSchema": {
       "type": "object",
       "properties": {
         "mode": {
           "default": "light",
-          "description": "Light returns organic results. Full returns available same-page SERP features. Both default to one page; full never implies two pages.",
+          "description": "Light returns organic results. Full adds available SERP features for one page. With an explicit two-page request, only organic results are available and feature status is unsupported. Both default to one page.",
           "type": "string",
           "enum": [
             "light",
@@ -26285,7 +26379,7 @@ var MCP_TOOL_CATALOG = [
         },
         "pages": {
           "default": 1,
-          "description": "One page by default in light and full modes. Set 2 only when the user explicitly requests two pages.",
+          "description": "One page by default. Set 2 only when the user explicitly requests two pages; two-page results include organic listings only; if page 2 is unavailable, page 1 is returned and billed when available.",
           "type": "integer",
           "minimum": 1,
           "maximum": 2
@@ -29113,6 +29207,7 @@ function createProgram(fetchImpl = globalThis.fetch) {
         device: "desktop",
         proxyMode: "none",
         pages: 1,
+        mode: "light",
         debug: false
       });
       printResult(result, Boolean(opts.json), (r) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.48.0",
+  "version": "0.49.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.48.1"
+    "mcpscraper-sdk": "^0.50.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"