mcpscraper-cli 0.14.0 → 0.16.0

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for [mcpscraper.dev](https://mcpscraper.dev) and [memory.mcpscraper.dev](https://memory.mcpscraper.dev).
 
-The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 165 unified MCP tools (76 MCP Scraper plus 89 mirrored memory tools).
+The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 166 unified MCP tools (77 MCP Scraper plus 89 mirrored memory tools).
 
 ## Install
 
@@ -33,7 +33,7 @@ mcpscraper tools call describe_service_connection_tool --args '{"connectionId":"
 mcpscraper tools call renew_connected_data_download --args '{"artifactId":"artifact_123"}' --json
 ```
 
-`tools list` contains exactly 165 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
+`tools list` contains exactly 166 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

@@ -9,7 +9,7 @@ import { join } from "path";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 
 // src/version.ts
-var CLI_VERSION = "0.13.0";
+var CLI_VERSION = "0.16.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -61,22 +61,21 @@ var MCP_TOOL_CATALOG = [
         "proxyMode": {
           "type": "string",
           "enum": [
-            "location",
             "configured",
             "none"
           ],
           "default": "none",
-          "description": 'Leave unset (clean egress). Do NOT set "location" just because a city was named \u2014 that comes from city-in-query wording. "location" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures.'
+          "description": "Leave unset for the default route. Country/region localization comes from gl/hl plus the city or region in the query."
         },
         "proxyZip": {
           "type": "string",
           "pattern": "^\\d{5}$",
-          "description": 'US ZIP for residential geo-IP targeting. Only meaningful with proxyMode "location".'
+          "description": "Optional US ZIP override."
         },
         "debug": {
           "type": "boolean",
           "default": false,
-          "description": "Include sanitized diagnostics for debugging localization, CAPTCHA, or proxy behavior."
+          "description": "Include sanitized diagnostics for debugging."
         }
       },
       "required": [
@@ -134,22 +133,21 @@ var MCP_TOOL_CATALOG = [
         "proxyMode": {
           "type": "string",
           "enum": [
-            "location",
             "configured",
             "none"
           ],
           "default": "none",
-          "description": 'Leave unset (clean egress). Do NOT set "location" just because a city was named \u2014 that comes from city-in-query wording. "location" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures.'
+          "description": "Leave unset for the default route. Country/region localization comes from gl/hl plus the city or region in the query."
         },
         "proxyZip": {
           "type": "string",
           "pattern": "^\\d{5}$",
-          "description": 'US ZIP for residential geo-IP targeting. Only meaningful with proxyMode "location".'
+          "description": "Optional US ZIP override."
         },
         "debug": {
           "type": "boolean",
           "default": false,
-          "description": "Include sanitized diagnostics for debugging localization, CAPTCHA, or proxy behavior."
+          "description": "Include sanitized diagnostics for debugging."
         },
         "pages": {
           "type": "integer",
@@ -351,7 +349,7 @@ var MCP_TOOL_CATALOG = [
         },
         "rotateProxies": {
           "type": "boolean",
-          "description": "Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks (403/429). Slower and pricier \u2014 use only when a site blocks normal crawling."
+          "description": "Use extra measures to get past sites that block normal crawling (403/429). Slower and pricier \u2014 use only when a site blocks normal crawling."
         },
         "rotateProxyEvery": {
           "type": "integer",
@@ -419,7 +417,7 @@ var MCP_TOOL_CATALOG = [
         },
         "rotateProxies": {
           "type": "boolean",
-          "description": "Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks. Slower/pricier \u2014 use only when a site blocks normal crawling."
+          "description": "Use extra measures to get past sites that block normal crawling. Slower/pricier \u2014 use only when a site blocks normal crawling."
         },
         "rotateProxyEvery": {
           "type": "integer",
@@ -1148,7 +1146,7 @@ var MCP_TOOL_CATALOG = [
     "name": "maps_search",
     "category": "maps",
     "title": "Google Maps Business Search",
-    "description": "Search Google local results for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. It paginates the rendered local-results list, opens each exact business card, then closes the profile dialog before continuing. Set includeServices for services and areas served; review cards are never collected by this tool.",
+    "description": "Search Google local results for multiple businesses by category, niche, or local market \u2014 leads, prospects, competitors, or beyond the 3-pack. Reaches the local-results list from the organic page and paginates it, returning up to 50 candidates (default 10) with names, place URLs, CIDs, and ratings. Leave proxyMode unset. Set includeServices to also open each business profile for its services and areas served; review cards are never collected by this tool.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1185,22 +1183,21 @@ var MCP_TOOL_CATALOG = [
         "includeServices": {
           "type": "boolean",
           "default": false,
-          "description": "Open each returned Google Business Profile and include configured services and areas served when available. Does not collect review cards."
+          "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."
         },
         "proxyMode": {
           "type": "string",
           "enum": [
-            "location",
             "configured",
             "none"
           ],
           "default": "none",
-          "description": "Leave unset for the default direct browser route. Google localization comes from the city in the query plus UULE, gl, and hl. location is an explicit residential-proxy override."
+          "description": "Leave unset for the default route. Country/region localization comes from the city or region in the query plus gl/hl."
         },
         "proxyZip": {
           "type": "string",
           "pattern": "^\\d{5}$",
-          "description": "Optional US ZIP override when proxyMode is location."
+          "description": "Optional US ZIP override."
         },
         "debug": {
           "type": "boolean",
@@ -1362,17 +1359,16 @@ var MCP_TOOL_CATALOG = [
         "proxyMode": {
           "type": "string",
           "enum": [
-            "location",
             "configured",
             "none"
           ],
           "default": "none",
-          "description": "Proxy behavior per city search. Leave unset for the direct localized Google route; location is an explicit residential-proxy override."
+          "description": "Proxy behavior per city search. Leave unset for the default route. Country/region localization comes from the city or region in the query plus gl/hl."
         },
         "proxyZip": {
           "type": "string",
           "pattern": "^\\d{5}$",
-          "description": "Optional ZIP override for proxy targeting; normally omitted."
+          "description": "Optional US ZIP override."
         },
         "debug": {
           "type": "boolean",
@@ -2753,17 +2749,16 @@ var MCP_TOOL_CATALOG = [
         "proxyMode": {
           "type": "string",
           "enum": [
-            "location",
             "configured",
             "none"
           ],
           "default": "none",
-          "description": 'Leave unset (clean egress). Do NOT set "location" just because a city was named \u2014 that comes from city-in-query wording. "location" forces residential geo-IP, is frequently CAPTCHA-blocked, and accepts failures.'
+          "description": "Leave unset for the default route. Country/region localization comes from gl/hl plus the city or region in the query."
         },
         "proxyZip": {
           "type": "string",
           "pattern": "^\\d{5}$",
-          "description": 'US ZIP for residential geo-IP targeting. Only meaningful with proxyMode "location".'
+          "description": "Optional US ZIP override."
         },
         "pages": {
           "type": "integer",
@@ -7648,6 +7643,52 @@ var MCP_TOOL_CATALOG = [
       "idempotentHint": true,
       "openWorldHint": false
     }
+  },
+  {
+    "name": "gmail_search_contacts",
+    "category": "connections",
+    "title": "Search Gmail Contacts",
+    "description": 'Search Gmail with standard Gmail query syntax (e.g. "from:acme.com after:2026/03/22") and get back deduplicated sender contacts (email, name, domain, message count, first/last seen, sample subjects) instead of raw messages. Read-only \u2014 works on any connected Gmail connection from list_service_connections, no actionsEnabled required. Use this instead of looping list-messages/get-message yourself: those return bare message IDs and full raw MIME per message, which does not scale past a handful of messages. Reports totalMatches and truncated so incomplete coverage from a large result set is never silent \u2014 pass the returned nextPageToken to continue.',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "connectionId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "A Gmail connectionId from list_service_connections. Read-only \u2014 does not require actionsEnabled."
+        },
+        "query": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": 'Gmail search syntax, e.g. "from:brandnorth.com after:2026/03/22" or "brandnorth.com".'
+        },
+        "maxMessages": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 150,
+          "default": 50,
+          "description": "Max messages to fetch and aggregate in this call. Paginate with pageToken for more; the response reports totalMatches and truncated so undercoverage is never silent."
+        },
+        "pageToken": {
+          "type": "string",
+          "description": "Continuation token from a prior response to fetch the next page."
+        }
+      },
+      "required": [
+        "connectionId",
+        "query"
+      ],
+      "additionalProperties": false,
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "annotations": {
+      "title": "Search Gmail Contacts",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
   }
 ];
 var MCP_TOOL_NAMES = MCP_TOOL_CATALOG.map((tool) => tool.name);
@@ -7853,8 +7894,7 @@ Vault deposit: ${page.memory.deposited ? `saved to ${page.memory.vault}` : "fail
         downloadImages: false,
         rotateProxies: false,
         rotateProxyEvery: 30,
-        browserFallback: false,
-        kernelFallback: false
+        browserFallback: false
       });
       printResult(result, Boolean(opts.json), (r) => {
         const pages = r.pages ?? [];
@@ -7868,8 +7908,7 @@ Vault deposit: ${page.memory.deposited ? `saved to ${page.memory.vault}` : "fail
         url,
         maxUrls: 500,
         concurrency: 12,
-        browserFallback: false,
-        kernelFallback: false
+        browserFallback: false
       });
       printResult(result, Boolean(opts.json), (r) => {
         const urls = r.urls ?? [];
@@ -7885,7 +7924,8 @@ Vault deposit: ${page.memory.deposited ? `saved to ${page.memory.vault}` : "fail
         gl: "us",
         hl: "en",
         maxResults: 10,
-        proxyMode: "location",
+        includeServices: false,
+        proxyMode: "none",
         debug: false
       });
       printResult(result, Boolean(opts.json), (r) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Command-line interface for mcpscraper.dev and memory.mcpscraper.dev",
   "license": "MIT",
   "type": "module",