mcpscraper-cli 0.56.1 → 0.57.1

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/releases/tag/v0.58.1)
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.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.
 
@@ -194,4 +194,8 @@ Server 0.100.1 improves Maps discovery, review text and list collection through
 
 ## Consistent hosted MCP protocol
 
-This release targets MCP Scraper 0.102.1 with 349 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity 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.
+This release targets MCP Scraper 0.103.0 with 352 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity 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.
+
+Publication management: list owned subdomains with `commons_list_publications`, select a name with `commons_get_publication`, and edit one article with `commons_update_editorial_article`. Publishing merges omitted articles by default; use `mode:replace` for a full replacement. Use the dedicated article or publication delete tool with its current revision and a stable retry key. See the [release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0).
+
+Reddit trending supports `window: "14d"`, verified publication dates, captured comment text and delivery quality fields. See the [0.59.2 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.2) for the compatible package versions.

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.56.1";
+var CLI_VERSION = "0.57.1";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -12130,7 +12130,7 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_claim_publication",
     "category": "commons",
     "title": "Claim Transparent Commons Publication",
-    "description": "Permanently claim one globally unique publication subdomain for the authenticated MCP Scraper account. Call commons_prepare_publication and commons_validate_publication first. This creates public identity state but does not publish an edition. Requires an idempotencyKey; retries with the same intended claim are safe.",
+    "description": "Claim another globally unique publication subdomain for the authenticated MCP Scraper account. Call commons_prepare_publication and commons_validate_publication first. This creates public identity state but does not publish an edition. Requires an idempotencyKey; retries with the same intended claim are safe.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -12138,7 +12138,7 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "minLength": 3,
           "maxLength": 50,
-          "description": "Requested publication name under transparent-commons.cc. The server normalizes spaces to hyphens, rejects reserved names, and enforces one globally unique name per account."
+          "description": "Requested publication name under transparent-commons.cc. The server normalizes spaces to hyphens, rejects reserved names, and keeps names globally unique; accounts may own multiple names."
         },
         "title": {
           "description": "Reader-facing publication title. Omit to derive it from the chosen subdomain.",
@@ -12172,6 +12172,103 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "commons_delete_editorial_article",
+    "category": "commons",
+    "title": "Delete One Transparent Commons Article",
+    "description": "Remove one article from the current edition while preserving every other article and edition metadata. Publishes a new revision; older stored revisions remain private. Deleting the last article withdraws that edition and deletes its stored history while preserving other editions. Use commons_delete_publication to remove all publication content. Requires current edition baseRevision and an idempotencyKey reused only for exact retries.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "publicationSubdomain": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 50,
+          "description": "Caller-owned publication containing the article."
+        },
+        "editionSlug": {
+          "description": "Edition holding the article. Defaults to the publication\u2019s latest edition.",
+          "type": "string",
+          "maxLength": 80,
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "articleSlug": {
+          "type": "string",
+          "maxLength": 80,
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "description": "Slug of the article to delete; other articles are preserved."
+        },
+        "baseRevision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Current edition revision from commons_get_publication; stale deletes are rejected."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 200,
+          "description": "Unique key for this deletion; reuse only for an exact retry."
+        }
+      },
+      "required": [
+        "publicationSubdomain",
+        "articleSlug",
+        "baseRevision",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Delete One Transparent Commons Article",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "commons_delete_publication",
+    "category": "commons",
+    "title": "Delete Transparent Commons Publication",
+    "description": "Permanently delete all stored editions and rendered content of a caller-owned publication and remove it from public serving. The subdomain stays reserved to its owner and is not reusable. A minimal ownership and operation receipt is retained indefinitely. Requires the publication baseRevision and an idempotencyKey reused only for exact retries. For one article use commons_delete_editorial_article.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "publicationSubdomain": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 50,
+          "description": "Caller-owned publication whose stored editions will all be deleted."
+        },
+        "baseRevision": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Publication revision from commons_get_publication, not an edition revision."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 200,
+          "description": "Unique key for this deletion; reuse only for an exact retry."
+        }
+      },
+      "required": [
+        "publicationSubdomain",
+        "baseRevision",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Delete Transparent Commons Publication",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
   {
     "name": "commons_get_entity",
     "category": "commons",
@@ -12293,20 +12390,32 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_get_publication",
     "category": "commons",
     "title": "Get Transparent Commons Publication",
-    "description": "Read a Transparent Commons publication and its latest edition revisions. Omit subdomain to inspect the caller-owned publication; pass a name to inspect a public publication. Returns the permanent public and archive URLs needed for sharing or later edits. Set includeArticles to also return every stored article\u2019s Markdown source and slug, which is what commons_update_editorial_article edits \u2014 the payload is large, so request it only when you intend to edit.",
+    "description": "Read a Transparent Commons publication and its latest edition revisions. Select a subdomain; omission works only for accounts with exactly one publication. Named public reads omit sources; authenticated owners may include them. Returns the permanent public and archive URLs needed for sharing or later edits. Set includeArticles to also return every stored article\u2019s Markdown source and slug, which is what commons_update_editorial_article edits \u2014 the payload is large, so request it only when you intend to edit.",
     "inputSchema": {
       "type": "object",
       "properties": {
         "includeArticles": {
-          "description": "Return every stored article\u2019s Markdown source alongside each edition. Large payload; request it only when you intend to edit an article. Owner-only: a publication read by name never returns sources.",
+          "description": "Return every stored article\u2019s Markdown source alongside each edition. Large payload; request it only when you intend to edit an article. Sources require an authenticated owner read, including when selecting by subdomain.",
           "type": "boolean"
         },
         "subdomain": {
-          "description": "Public publication name to inspect. Omit to return the publication owned by the authenticated account.",
+          "description": "Public publication name to inspect. Omit only when the account owns exactly one publication; otherwise list and select a subdomain.",
           "type": "string",
           "minLength": 3,
           "maxLength": 50
         },
+        "editionSlug": {
+          "description": "Restrict edition results to this slug.",
+          "type": "string",
+          "maxLength": 80,
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "articleSlug": {
+          "description": "Restrict article source results to this slug; requires includeArticles.",
+          "type": "string",
+          "maxLength": 80,
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
         "includeEditions": {
           "default": true,
           "description": "Include the latest revision of every published edition.",
@@ -12473,6 +12582,37 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": false
     }
   },
+  {
+    "name": "commons_list_publications",
+    "category": "commons",
+    "title": "List Transparent Commons Publications",
+    "description": "List the authenticated account\u2019s publication subdomains and revision numbers without fetching article bodies. Follow nextCursor using after for more results. Deleted publications are excluded; use commons_get_publication to read a selected publication.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "default": 25,
+          "description": "Maximum number of owned publications to return.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "after": {
+          "description": "nextCursor from the preceding page; omit for the first page.",
+          "type": "string",
+          "maxLength": 50
+        }
+      },
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List Transparent Commons Publications",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "commons_prepare_entity",
     "category": "commons",
@@ -12708,7 +12848,7 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_prepare_publication",
     "category": "commons",
     "title": "Prepare Transparent Commons Publication",
-    "description": "Check and normalize a subscriber-chosen Transparent Commons publication name before any write. Returns name availability, the caller's existing publication, permanent URL shape, ownership rules, and the required validate/claim/publish workflow. This is for a user-owned editorial publication, not a neutral /wiki/ entity.",
+    "description": "Check and normalize a subscriber-chosen Transparent Commons publication name before any write. Returns name availability, the requested publication ownership, permanent URL shape, ownership rules, and the required validate/claim/publish workflow. This is for a user-owned editorial publication, not a neutral /wiki/ entity.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -12716,7 +12856,7 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "minLength": 3,
           "maxLength": 50,
-          "description": "Requested publication name under transparent-commons.cc. The server normalizes spaces to hyphens, rejects reserved names, and enforces one globally unique name per account."
+          "description": "Requested publication name under transparent-commons.cc. The server normalizes spaces to hyphens, rejects reserved names, and keeps names globally unique; accounts may own multiple names."
         },
         "title": {
           "description": "Reader-facing publication title. Omit to derive it from the chosen subdomain.",
@@ -12747,10 +12887,19 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_publish_editorial",
     "category": "commons",
     "title": "Publish Transparent Commons Editorial Edition",
-    "description": "Publish up to 100 fully authored editorial pieces, including optional article/card images, Markdown body images, and collection/article Open Graph images, to the caller-owned Transparent Commons subdomain. The calling AI must research and author the source-grounded edition first; image URLs need alt text and preserved provenance/rights context. The tool validates, renders, persists, and returns permanent root, archive, and edition URLs. Existing editions require current baseRevision. Requires idempotencyKey; this is not the neutral wiki write tool.",
+    "description": "Publish up to 100 fully authored editorial pieces, including optional article/card images, Markdown body images, and collection/article Open Graph images, to the caller-owned Transparent Commons subdomain. The calling AI must research and author the source-grounded edition first; image URLs need alt text and preserved provenance/rights context. Merge mode preserves omitted articles. Explicit replace mode removes omitted articles from the current edition. Earlier revisions remain stored privately. The tool returns public and archive URLs. Existing editions require current baseRevision. Requires idempotencyKey; this is not the neutral wiki write tool.",
     "inputSchema": {
       "type": "object",
       "properties": {
+        "mode": {
+          "default": "merge",
+          "description": "Merge preserves articles omitted from the payload; replace removes omitted articles from the current edition.",
+          "type": "string",
+          "enum": [
+            "merge",
+            "replace"
+          ]
+        },
         "publicationSubdomain": {
           "type": "string",
           "minLength": 3,
@@ -13092,7 +13241,7 @@ var MCP_TOOL_CATALOG = [
     "annotations": {
       "title": "Publish Transparent Commons Editorial Edition",
       "readOnlyHint": false,
-      "destructiveHint": false,
+      "destructiveHint": true,
       "idempotentHint": true,
       "openWorldHint": true
     }
@@ -14199,10 +14348,167 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_update_editorial_article",
     "category": "commons",
     "title": "Edit One Transparent Commons Article",
-    "description": "Replace the Markdown of one article in a published edition without resupplying the others: it reads the stored sources, swaps the article you name, and publishes the next revision with the rest byte-identical. Read commons_get_publication with includeArticles first for the current source and revision. commons_publish_editorial is the full-replace path. Requires baseRevision and idempotencyKey.",
+    "description": "Replace the Markdown of one article in a published edition without resupplying the others: it reads the stored sources, swaps the article you name, and publishes the next revision with the rest byte-identical. Read commons_get_publication with includeArticles first for the current source and revision. Use commons_publish_editorial with mode:replace for an intentional full-edition replacement. Omitted fields stay unchanged; null clears optional fields. Requires baseRevision and idempotencyKey.",
     "inputSchema": {
       "type": "object",
       "properties": {
+        "sourceLabel": {
+          "description": "Replacement provenance label; omitted fields are preserved.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "sourceType": {
+          "description": "Replacement source class; null clears it.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 80
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "revision": {
+          "description": "Replacement article revision label; null clears it.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 80
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "updatedAt": {
+          "description": "Replacement source update label; null clears it.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 80
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "image": {
+          "description": "Replacement card and article image; null clears it.",
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Public HTTP(S) image URL."
+                },
+                "alt": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 500,
+                  "description": "Required accessible description of the image."
+                },
+                "caption": {
+                  "description": "Optional visible caption.",
+                  "type": "string",
+                  "maxLength": 1e3
+                },
+                "credit": {
+                  "description": "Optional visible creator, publisher, or rights credit.",
+                  "type": "string",
+                  "maxLength": 500
+                },
+                "sourceUrl": {
+                  "description": "Optional public HTTP(S) source page for provenance or rights context.",
+                  "type": "string",
+                  "format": "uri"
+                },
+                "width": {
+                  "description": "Optional intrinsic width in pixels.",
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "height": {
+                  "description": "Optional intrinsic height in pixels.",
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "url",
+                "alt"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "ogImage": {
+          "description": "Replacement social image; null clears it.",
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Public HTTP(S) image URL."
+                },
+                "alt": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 500,
+                  "description": "Required accessible description of the image."
+                },
+                "caption": {
+                  "description": "Optional visible caption.",
+                  "type": "string",
+                  "maxLength": 1e3
+                },
+                "credit": {
+                  "description": "Optional visible creator, publisher, or rights credit.",
+                  "type": "string",
+                  "maxLength": 500
+                },
+                "sourceUrl": {
+                  "description": "Optional public HTTP(S) source page for provenance or rights context.",
+                  "type": "string",
+                  "format": "uri"
+                },
+                "width": {
+                  "description": "Optional intrinsic width in pixels.",
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "height": {
+                  "description": "Optional intrinsic height in pixels.",
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "url",
+                "alt"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "publicationSubdomain": {
           "type": "string",
           "minLength": 3,
@@ -15123,6 +15429,15 @@ var MCP_TOOL_CATALOG = [
     "inputSchema": {
       "type": "object",
       "properties": {
+        "mode": {
+          "default": "merge",
+          "description": "Merge preserves articles omitted from the payload; replace removes omitted articles from the current edition.",
+          "type": "string",
+          "enum": [
+            "merge",
+            "replace"
+          ]
+        },
         "operation": {
           "type": "string",
           "enum": [
@@ -25101,7 +25416,7 @@ var MCP_TOOL_CATALOG = [
     "name": "reddit_trending",
     "category": "reddit",
     "title": "Reddit Trending",
-    "description": "Find Reddit discussions through Google, filter and select relevant candidates before opening them, then rank scraped threads by observed engagement. Use reddit_thread for a known URL. Comment retrieval verifies actual post dates against the requested window and reports captured counts separately from reported totals. Discovery, scraped threads and returned comments are billed separately. Discovery-only results leave post dates unverified; inspect partial, resultQuality and comment coverage before treating a shortfall as complete.",
+    "description": "Find Reddit discussions through Google, filter and select relevant candidates before opening them, then rank scraped threads by observed engagement. Use reddit_thread for a known URL. Comment retrieval verifies actual post dates against the requested window and returns captured comment bodies and coverage. Discovery, scraped threads and returned comments are billed separately. Discovery-only results leave post dates unverified; inspect partial, resultQuality and comment coverage before treating a shortfall as complete.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -25127,6 +25442,7 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "week",
+            "14d",
             "month",
             "year",
             "all"
@@ -25134,7 +25450,7 @@ var MCP_TOOL_CATALOG = [
         },
         "maxThreads": {
           "default": 20,
-          "description": "Cap on relevant threads selected before scraping; one search page can yield fewer. Each scraped thread and its returned comments are billed separately.",
+          "description": "Maximum number of threads returned. If a candidate cannot be delivered, other relevant candidates can take its place. Each delivered thread and its comments are billed separately.",
           "type": "integer",
           "minimum": 1,
           "maximum": 40
@@ -26087,7 +26403,7 @@ var MCP_TOOL_CATALOG = [
         "query": {
           "type": "string",
           "minLength": 1,
-          "description": "The search topic, exactly as it should be searched. Include the place here when you want it in the search terms \u2014 the server sends your query to Google unchanged and never adds or removes a location."
+          "description": "Search terms, including any desired location. The first query is sent unchanged. A one-page light search that returns only off-domain rows for a Reddit site scope can retry with a narrower Reddit thread scope."
         },
         "location": {
           "description": "Compatibility field. Ordinary search ignores this. Include a place in query when needed.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.56.1",
+  "version": "0.57.1",
   "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.58.1"
+    "mcpscraper-sdk": "^0.59.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"