mcpscraper-cli 0.48.1 → 0.49.1

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 '{}'`.
 
@@ -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.49.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.49.0).
+Release changes: [SDK 0.50.1 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.50.1).

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.1";
+var CLI_VERSION = "0.49.1";
 
 // 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": {
@@ -23249,14 +23249,14 @@ var MCP_TOOL_CATALOG = [
         },
         "maxReviews": {
           "default": 50,
-          "description": "Max review cards when includeReviews is true. Default 50, maximum 500.",
+          "description": "Max review cards when includeReviews is true. Default 50, maximum 1,000. Collection is resumable; actual availability depends on the profile.",
           "type": "integer",
           "minimum": 1,
-          "maximum": 500
+          "maximum": 1e3
         },
         "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"
         }
       },
@@ -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.1",
+  "version": "0.49.1",
   "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.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"