mcpscraper-cli 0.15.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.15.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",
@@ -1190,17 +1188,16 @@ var MCP_TOOL_CATALOG = [
         "proxyMode": {
           "type": "string",
           "enum": [
-            "location",
             "configured",
             "none"
           ],
           "default": "none",
-          "description": "Leave unset for the default route (stealth browser on the managed ISP proxy, retried on a fresh session when Google blocks). Localization comes from the city in the query plus gl/hl. location forces an explicit residential proxy \u2014 not recommended for Google."
+          "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, only used 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 default route (stealth browser on the managed ISP proxy, retried fresh on a Google block). location forces an explicit residential proxy \u2014 not recommended for Google."
+          "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 ?? [];

package/package.json

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