mcpscraper-cli 0.19.0 → 0.21.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 166 unified MCP tools (77 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 172 unified MCP tools (82 MCP Scraper plus 90 mirrored Memory tools).
 
 ## Install
 
@@ -31,9 +31,10 @@ mcpscraper tools call export_connected_service_data --args '{"connectionId":"met
 mcpscraper tools call export_connected_service_data --args '{"connectionId":"gsc_conn_123","dataset":"search_console_performance","lastDays":28}' --json
 mcpscraper tools call describe_service_connection_tool --args '{"connectionId":"conn_123","tool":"provider-tool-name"}' --json
 mcpscraper tools call renew_connected_data_download --args '{"artifactId":"artifact_123"}' --json
+mcpscraper tools call archive_read --args '{"url":"https://github.com/octocat/Hello-World/archive/refs/heads/master.zip"}' --json
 ```
 
-`tools list` contains exactly 166 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
+`tools list` contains exactly 172 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.19.0";
+var CLI_VERSION = "0.21.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -5018,6 +5018,10 @@ var MCP_TOOL_CATALOG = [
               },
               "description": {
                 "type": "string"
+              },
+              "acceptCanonical": {
+                "type": "string",
+                "description": "Reuse this existing tag instead of the proposed one, confirming a candidate returned by an earlier review. The proposed spelling is recorded as its alias."
               }
             },
             "required": [
@@ -5028,7 +5032,7 @@ var MCP_TOOL_CATALOG = [
             "additionalProperties": false
           },
           "maxItems": 8,
-          "description": "Required justification for any tag that does not already exist. Existing exact/alias/near tags are canonicalized automatically; a new tag is accepted only when its matching decision has central=true and reusable=true."
+          "description": "Required justification for any tag that does not already exist. Tags resolve against the account's existing vocabulary; new tags require a one-line description."
         }
       },
       "required": [
@@ -5952,7 +5956,14 @@ var MCP_TOOL_CATALOG = [
             "type": "string"
           },
           "maxItems": 8,
-          "description": "Reviewed canonical tags. Existing tags should be resolved first; when omitted, deterministic source/topic tags are generated."
+          "description": "Reviewed canonical tags. Tags resolve against the account's existing vocabulary; new tags require a one-line description. When omitted, only deterministic source-provenance tags are recorded."
+        },
+        "tagDescriptions": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "One-line meaning for any supplied tag that is new to the account, keyed by tag."
         },
         "related": {
           "type": "array",
@@ -6339,6 +6350,13 @@ var MCP_TOOL_CATALOG = [
         "baseRevision": {
           "type": "number",
           "description": "Revision the edit is based on (from a prior get/put). When provided, the write only applies if the note is still at this revision; otherwise it is rejected as a conflict instead of silently overwriting a concurrent edit. Omit for last-write-wins (fine for solo notes)."
+        },
+        "tagDescriptions": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "One-line meaning for any tag in props.tags that is new to the account, keyed by tag. Tags resolve against the account's existing vocabulary; new tags require a one-line description."
         }
       },
       "required": [
@@ -7355,7 +7373,7 @@ var MCP_TOOL_CATALOG = [
     "name": "resolve-memory-tags",
     "category": "tags",
     "title": "Resolve Memory Tags",
-    "description": "Resolve proposed concepts against the live tag vocabulary. Always inspect the complete vocabulary with list-memory-tags first. Returns reuse, create, or omit; a new tag is appropriate only when no equivalent exists and the concept is central and reusable.",
+    "description": "Resolve proposed concepts against the live tag vocabulary. Always inspect the complete vocabulary with list-memory-tags first. Returns reuse, review, create, or omit: spelling and singular/plural variants resolve to the canonical tag silently, while close and semantically related tags come back as ranked candidates for you to choose from. A new tag is appropriate only when no equivalent exists and the concept is central and reusable.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -7385,6 +7403,13 @@ var MCP_TOOL_CATALOG = [
           },
           "minItems": 1,
           "maxItems": 20
+        },
+        "accept": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Confirm a candidate returned by an earlier review, as {proposedTag: canonicalTag}. The proposed spelling is recorded as an alias of the canonical tag so the same judgement is never re-litigated."
         }
       },
       "required": [
@@ -8107,6 +8132,99 @@ var MCP_TOOL_CATALOG = [
       "idempotentHint": false,
       "openWorldHint": true
     }
+  },
+  {
+    "name": "merge-memory-tags",
+    "category": "tags",
+    "title": "Merge Memory Tags",
+    "description": 'Collapse a duplicate tag into the canonical one across the whole account: every note using "from" is retagged to "into", "from" is recorded as an alias of "into", and the duplicate is removed from the vocabulary. Use when list-memory-tags shows two spellings of one concept. Irreversible; requires write scope.',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "from": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The duplicate tag to retire."
+        },
+        "into": {
+          "type": "string",
+          "minLength": 1,
+          "description": 'The canonical tag to keep. Every note using "from" is retagged to this.'
+        }
+      },
+      "required": [
+        "from",
+        "into"
+      ],
+      "additionalProperties": false,
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "annotations": {
+      "title": "Merge Memory Tags",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "archive_read",
+    "category": "web",
+    "title": "List or Read ZIP Archive",
+    "description": "Open any bounded public HTTPS ZIP, including a bundleUrl from check_site_export. Omit path to list files; pass an exact returned path to read a bounded UTF-8 text window. Set depositToLibrary true with a path to preserve the complete selected source file in the tenant Library vault. Rejects private-network URLs, unsafe paths, encrypted entries, symlinks, binary inline reads, and ZIP bombs.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Public HTTPS URL of a ZIP file, including a signed bundleUrl returned by check_site_export."
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2e3,
+          "description": "Exact ZIP entry path to read. Omit to list the archive. Use a path returned by a previous archive_read listing."
+        },
+        "offset": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Byte offset for a text-file read. Continue from nextOffset until it is null. Ignored when path is omitted."
+        },
+        "maxBytes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2e5,
+          "default": 5e4,
+          "description": "Maximum UTF-8 bytes to return from the selected text file. Default 50,000; maximum 200,000."
+        },
+        "maxEntries": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1e3,
+          "default": 200,
+          "description": "Maximum entry rows returned when listing. The server still validates the complete archive. Default 200; maximum 1,000."
+        },
+        "depositToLibrary": {
+          "type": "boolean",
+          "default": false,
+          "description": "Store the complete selected text file in the tenant Library vault through library-ingest. Requires path. Preserves the ZIP URL and entry path as source provenance."
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "additionalProperties": false,
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "annotations": {
+      "title": "List or Read ZIP Archive",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
   }
 ];
 var MCP_TOOL_NAMES = MCP_TOOL_CATALOG.map((tool) => tool.name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Command-line interface for mcpscraper.dev and memory.mcpscraper.dev",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "mcpscraper-sdk": "^0.21.0"
+    "mcpscraper-sdk": "^0.22.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"