mcpscraper-cli 0.31.0 → 0.32.0

package/README.md

@@ -4,7 +4,7 @@ Command-line interface for [mcpscraper.dev](https://mcpscraper.dev) and [memory.
 
 [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 330 unified MCP tools (229 MCP Scraper plus 101 mirrored Memory tools).
+The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 331 unified MCP tools (230 MCP Scraper plus 101 mirrored Memory tools).
 
 ## 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 330 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
+`tools list` contains exactly 331 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
 
 Keep a Gmail selection's ID, SHA-256, and count together. `gmail_import_status` only observes work; resume through `gmail_import_to_memory` with the original plan and idempotency key. Permanent deletion is a separate irreversible command requiring both `confirmPermanentDelete:true` and `--yes`; it is intentionally not shown as a copy/paste example.
 

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.31.0";
+var CLI_VERSION = "0.32.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -6483,7 +6483,7 @@ var MCP_TOOL_CATALOG = [
     "name": "analytics_get_person_journey",
     "category": "analytics",
     "title": "Get Person Journey",
-    "description": "Read one identified person timeline across sessions, immutable touches, calls, CRM stages, conversions, and ad-delivery receipts.",
+    "description": "Read CRM-oriented identified-person history: touches, calls, CRM stages, conversions, and delivery receipts. For analytics chronology use analytics_get_visitor_journey.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -6560,7 +6560,7 @@ var MCP_TOOL_CATALOG = [
     "name": "analytics_get_session_timeline",
     "category": "analytics",
     "title": "Get Session Timeline",
-    "description": "Read one safe chronological session timeline by opaque Site-scoped reference.",
+    "description": "Read confirmed session summary, pages, events, acquisition, session rollups, and chronology. Use visitor journey for cross-session history.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -6575,6 +6575,18 @@ var MCP_TOOL_CATALOG = [
           "minLength": 8,
           "maxLength": 240,
           "description": "Opaque Site-scoped reference returned by an X-Ray read. Raw visitor, session, device, email, phone, IP, and identity hashes are never accepted."
+        },
+        "from": {
+          "description": "Inclusive ISO time. Defaults to 90 days before to; max window 366 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+        },
+        "to": {
+          "description": "Exclusive ISO time. Defaults to now; max window 366 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
         }
       },
       "required": [
@@ -6836,7 +6848,7 @@ var MCP_TOOL_CATALOG = [
     "name": "analytics_get_visitor_journey",
     "category": "analytics",
     "title": "Get Visitor Journey",
-    "description": "Read one safe visitor journey by opaque Site-scoped reference. Candidate evidence is labeled and never treated as confirmed identity.",
+    "description": "Read one confirmed cross-session visitor/person journey: summary, pages, events, acquisition, session rollups, and chronology. Candidate evidence is excluded.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -6851,6 +6863,18 @@ var MCP_TOOL_CATALOG = [
           "minLength": 8,
           "maxLength": 240,
           "description": "Opaque Site-scoped reference returned by an X-Ray read. Raw visitor, session, device, email, phone, IP, and identity hashes are never accepted."
+        },
+        "from": {
+          "description": "Inclusive ISO time. Defaults to 90 days before to; max window 366 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+        },
+        "to": {
+          "description": "Exclusive ISO time. Defaults to now; max window 366 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
         }
       },
       "required": [
@@ -7939,7 +7963,7 @@ var MCP_TOOL_CATALOG = [
     "name": "analytics_list_visitors",
     "category": "analytics",
     "title": "List X-Ray Visitors",
-    "description": "Read bounded visitor summaries using opaque references and separately labeled confirmed or candidate-assisted tiers.",
+    "description": "Read bounded visitor summaries with opaque references, visit counts, returning status, and confirmed conversion status.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -9975,6 +9999,12 @@ var MCP_TOOL_CATALOG = [
           "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": "Analytics Site id returned by analytics_list_sites."
         },
+        "journeyTier": {
+          "default": "confirmed",
+          "description": "External activation is confirmed-only. Best-guess and candidate-assisted journey evidence is schema-invalid.",
+          "type": "string",
+          "const": "confirmed"
+        },
         "platform": {
           "type": "string",
           "enum": [
@@ -26303,6 +26333,56 @@ var MCP_TOOL_CATALOG = [
       "idempotentHint": true,
       "openWorldHint": false
     }
+  },
+  {
+    "name": "analytics_list_journeys",
+    "category": "analytics",
+    "title": "List X-Ray Journeys",
+    "description": "List confirmed cross-session paths, separately labeled best-guess paths, or both. Candidate-assisted evidence cannot drive CRM or advertising actions.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "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": "Analytics Site id returned by analytics_list_sites."
+        },
+        "journeyTier": {
+          "default": "confirmed",
+          "description": "Select confirmed journeys, separately labeled best-guess journeys, or both branches. Confirmed is the default; best-guess evidence can never drive CRM or advertising actions.",
+          "type": "string",
+          "enum": [
+            "confirmed",
+            "best_guess",
+            "all"
+          ]
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum rows returned in each selected journey branch.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "cursor": {
+          "description": "Opaque keyset cursor returned in a selected branch pageInfo.nextCursor.",
+          "type": "string",
+          "maxLength": 1e3
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List X-Ray Journeys",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
   }
 ];
 var MCP_TOOL_NAMES = MCP_TOOL_CATALOG.map((tool) => tool.name);

package/package.json

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