mcpscraper-cli 0.54.0 → 0.56.0

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for the unified [mcpscraper.dev](https://mcpscraper.dev) MCP and REST APIs.
 
-[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/blob/main/CHANGELOG.md)
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.58.0)
 
 The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every unified MCP tool, including retained-file readers, provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
 
@@ -191,3 +191,7 @@ shows both paths.
 ## Saved Maps reviews
 
 Server 0.100.1 improves Maps discovery, review text and list collection through the existing interfaces. Use the exact name and location returned by discovery. Read the saved run and its review pages before considering a new acquisition. An explicit resume uses a fresh browser and reopens the profile and reviews; it retains saved review IDs. A new resume key authorizes a separately billed attempt, while repeating that key reads the same run.
+
+## Consistent hosted MCP protocol
+
+This release targets MCP Scraper 0.102.0 with 349 tools. Calls use protocol `2026-07-28` with matching routing headers and request metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.

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.54.0";
+var CLI_VERSION = "0.56.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -10387,8 +10387,8 @@ var MCP_TOOL_CATALOG = [
         "templateId",
         "archived"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Archive Template",
@@ -11597,6 +11597,221 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "bug_reporting",
+    "category": "support",
+    "title": "Bug Reporting",
+    "description": "Capture repeated errors or a user-requested MCP Scraper bug report. First prepare a plain-language draft from observed calls: goal, exact arguments, call order, errors, retries, request/job IDs and client version. Mark unknowns; never invent evidence or include credentials or unrelated conversation. Review the returned redacted draft, then submit its reportId and reviewToken only when the user requests or approves submission. status reads your receipt. Free; drafts expire after one day, submitted reports after 365 days. Submission shares the report and verified account email with private MCP Scraper support; it does not post a public issue or promise a fix.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "default": "prepare",
+          "description": "prepare saves a private one-day draft for review; submit sends that exact draft to support; status reads your report receipt.",
+          "type": "string",
+          "enum": [
+            "prepare",
+            "submit",
+            "status"
+          ]
+        },
+        "report": {
+          "description": "Required for prepare. Collect known evidence from the conversation before asking the user for missing details.",
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 160,
+              "description": "Short description of the problem in plain language."
+            },
+            "goal": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2e3,
+              "description": "What the user was trying to accomplish, using their words."
+            },
+            "expected": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2e3,
+              "description": "What should have happened."
+            },
+            "actual": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4e3,
+              "description": "What actually happened. Separate observations from suspected causes."
+            },
+            "steps": {
+              "minItems": 1,
+              "maxItems": 30,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 1e3
+              },
+              "description": "Ordered reproduction steps, including retries and what changed."
+            },
+            "attempts": {
+              "minItems": 1,
+              "maxItems": 20,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "tool": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Exact tool name or REST method and path."
+                  },
+                  "submittedAt": {
+                    "description": "Observed call time with timezone; omit if unknown.",
+                    "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)))$"
+                  },
+                  "arguments": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 8e3,
+                    "description": "Exact submitted arguments as JSON or text. Remove credentials, cookies and unrelated private content first. Do not reconstruct unknown arguments."
+                  },
+                  "result": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 8e3,
+                    "description": "Observed response or error text, including error codes and retry outcome. Remove secrets."
+                  },
+                  "requestId": {
+                    "description": "Returned request ID, when available.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                  },
+                  "jobId": {
+                    "description": "Returned job or run ID, when available.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                  }
+                },
+                "required": [
+                  "tool",
+                  "arguments",
+                  "result"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Calls in the order made. Include successful calls that explain the failure."
+            },
+            "client": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120,
+                  "description": "Observed application or SDK name."
+                },
+                "version": {
+                  "description": "Observed application or package version; omit if unknown.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                },
+                "transport": {
+                  "type": "string",
+                  "enum": [
+                    "oauth",
+                    "api-key",
+                    "npx",
+                    "npm",
+                    "sdk",
+                    "mcpb",
+                    "rest",
+                    "unknown"
+                  ],
+                  "description": "Connection or install route used for the failed calls."
+                },
+                "operatingSystem": {
+                  "description": "Observed operating system; omit if unknown.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                },
+                "model": {
+                  "description": "Observed AI model; omit if unknown.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              },
+              "required": [
+                "name",
+                "transport"
+              ],
+              "additionalProperties": false,
+              "description": "Observed client environment; use unknown rather than guessing."
+            },
+            "context": {
+              "description": "Impact, frequency, useful prior context, and suspected cause clearly labeled as a guess. No full conversation dump.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4e3
+            },
+            "missing": {
+              "default": [],
+              "description": "Evidence that is unknown or unavailable; do not invent it.",
+              "maxItems": 20,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 500
+              }
+            }
+          },
+          "required": [
+            "title",
+            "goal",
+            "expected",
+            "actual",
+            "steps",
+            "attempts",
+            "client"
+          ],
+          "additionalProperties": false
+        },
+        "reportId": {
+          "description": "ID returned by prepare; required for submit or status.",
+          "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)$"
+        },
+        "reviewToken": {
+          "description": "Exact token returned by prepare; required for submit. A changed report requires a new prepare.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "userApproved": {
+          "description": "Set true only when the user has asked to submit this bug or approved the reviewed draft. Repeated errors alone do not authorize submission.",
+          "type": "boolean"
+        }
+      },
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Bug Reporting",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "bulk-delete-notes",
     "category": "memory",
@@ -15311,7 +15526,6 @@ var MCP_TOOL_CATALOG = [
     "description": "Save a user-owned template version 1 from a registered preset after inspecting search results and, when useful, get_artifact_template_example. Customize supported flags and presentation guidance; arbitrary HTML, CSS, JavaScript, executable code, and tool-selecting prompts are not accepted.",
     "inputSchema": {
       "type": "object",
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
       "oneOf": [
         {
           "type": "object",
@@ -15904,7 +16118,8 @@ var MCP_TOOL_CATALOG = [
           ],
           "additionalProperties": false
         }
-      ]
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Save Template",
@@ -19490,8 +19705,8 @@ var MCP_TOOL_CATALOG = [
       "required": [
         "templateId"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Get Template",
@@ -19524,8 +19739,8 @@ var MCP_TOOL_CATALOG = [
       "required": [
         "presetKey"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Preview Template Example",
@@ -20660,7 +20875,7 @@ var MCP_TOOL_CATALOG = [
     "name": "harvest_paa",
     "category": "search",
     "title": "Google PAA + SERP Harvest",
-    "description": "Expand one Google People Also Ask SERP into full captured answers, every source with available titles/descriptions, organic snippets, AI Overview evidence, ranking URLs, and entity IDs. Unfinished answer expansion is partial. Set pages to 2 for a second organic page when available; PAA expands once on page one, and pagination reports captured coverage. maxQuestions is a target count, not traversal depth. Results distinguish target_reached, proven frontier_exhausted, interruption, and recovery_exhausted; failed clicks and timeouts never prove exhaustion. This tool waits; use harvest_paa_start and harvest_paa_status for long runs. Wait at least 20 seconds before the first durable job or Task check and each later check. Optional SERP modules require include flags. Use gl and location for regional context. Costs 400 Credits per harvest plus 10 Credits per question actually returned; unused hold is refunded. After a timeout or unknown response, reuse the same idempotencyKey. Call credits_info for current pricing and balance.",
+    "description": "Expand one Google People Also Ask SERP into full captured answers, every source with available titles/descriptions, organic snippets, AI Overview evidence, ranking URLs, and entity IDs. Unfinished answer expansion is partial. Set pages to 2 for a second organic page when available; PAA expands once on page one, and pagination reports captured coverage. maxQuestions is a target count, not traversal depth. Results distinguish target_reached, proven frontier_exhausted, interruption, and recovery_exhausted; failed clicks and timeouts never prove exhaustion. This tool waits; use harvest_paa_start and harvest_paa_status for long runs. Wait at least 20 seconds before the first durable job check and each later check. Optional SERP modules require include flags. Use gl and location for regional context. Costs 400 Credits per harvest plus 10 Credits per question actually returned; unused hold is refunded. After a timeout or unknown response, reuse the same idempotencyKey. Call credits_info for current pricing and balance.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -21680,7 +21895,7 @@ var MCP_TOOL_CATALOG = [
     "name": "lead_list_enrich",
     "category": "leads",
     "title": "Enrich a Lead List",
-    "description": "Enrich 1\u2013250 mapped business or person rows, supplied inline or by leadListId, with matched public website, phone, email, social, contact-form, and optional associated-person evidence. Use when the list already exists; to inspect a file first use lead_list_import, to discover businesses from a niche plus city use workflow_run with get-leads, and for candidate-only Maps discovery use maps_search. Starts an owner-scoped durable Task, bills underlying Maps/page/SERP attempts with unused hold refunded, and retains requested CSV/XLSX results seven days. Opt-in email snippet recovery costs at most one SERP search per unresolved row. For peopleDiscovery, author one-to-three focused peopleQueryTemplates with one role intent per query; each role query reads AI Overview plus organic results, then at most maxPeoplePerLead company-matched LinkedIn result searches run without opening LinkedIn pages. Public email occurrence is not deliverability or consent verification and is not permission to contact. A public role or LinkedIn occurrence is not verified current employment. Reuse idempotencyKey only to retry the same intended job.",
+    "description": "Enrich 1\u2013250 mapped business or person rows, supplied inline or by leadListId, with matched public website, phone, email, social, contact-form, and optional associated-person evidence. Use when the list already exists; to inspect a file first use lead_list_import, to discover businesses from a niche plus city use workflow_run with get-leads, and for candidate-only Maps discovery use maps_search. Starts an owner-scoped durable job. Poll lead_list_enrich_status with its jobId. Underlying Maps/page/SERP attempts are billed with unused hold refunded; requested CSV/XLSX results are retained seven days. Opt-in email snippet recovery costs at most one SERP search per unresolved row. For peopleDiscovery, author one-to-three focused peopleQueryTemplates with one role intent per query; each role query reads AI Overview plus organic results, then at most maxPeoplePerLead company-matched LinkedIn result searches run without opening LinkedIn pages. Public email occurrence is not deliverability or consent verification and is not permission to contact. A public role or LinkedIn occurrence is not verified current employment. Reuse idempotencyKey only to retry the same intended job.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -21927,6 +22142,33 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "lead_list_enrich_cancel",
+    "category": "leadLists",
+    "title": "Cancel Lead List Enrichment",
+    "description": "Request cancellation of the original jobId returned by lead_list_enrich. Stops rows that have not started; an in-flight acquisition may finish and retain its cost. Returns current progress and billing; use lead_list_enrich_status to confirm the terminal state. Repeating cancellation does not start or bill another enrichment.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The jobId returned by lead_list_enrich. Poll until status is complete, partial, empty, failed, or cancelled."
+        }
+      },
+      "required": [
+        "jobId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Cancel Lead List Enrichment",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "lead_list_enrich_status",
     "category": "leads",
@@ -22240,8 +22482,8 @@ var MCP_TOOL_CATALOG = [
           ]
         }
       },
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Search Templates",
@@ -27236,8 +27478,8 @@ var MCP_TOOL_CATALOG = [
       "required": [
         "templateId"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Update Template",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.54.0",
+  "version": "0.56.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.56.0"
+    "mcpscraper-sdk": "^0.58.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"