mcpscraper-sdk 0.59.1 → 0.59.3

package/README.md

@@ -233,8 +233,10 @@ Use `bug_reporting` to prepare a redacted draft from observed calls and errors.
 
 ## Consistent hosted MCP protocol
 
-This release targets MCP Scraper 0.103.1 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.
+This release targets MCP Scraper 0.103.10 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).
 
 PAA job progress can include the optional `phase` and `observedAt` fields. They identify observed extraction work separately from worker renewal. Existing polling and request arguments remain compatible. See [the release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.1).
+
+Omit the Reddit trending window for an all-time search. Dated searches verify post or comment activity, including when comment text is omitted. See the [0.59.3 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.3) for the compatible package versions.

package/dist/index.d.cts

@@ -601,15 +601,11 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Discover and rank the top recent Reddit threads for a topic
-         * @description Discovers Reddit threads through a Google site:reddit.com search and selects relevant candidates
-         *     before scraping. Supports week, month, year and all-time windows. Scraped post dates are checked
-         *     against the requested publication window; discovery-only candidate dates remain unverified.
-         *     With includeComments:true, collects selected threads and ranks by engagement (upvotes + 2x
-         *     reported comments). Billing: one discovery debit plus 30 credits per scraped thread and 2 credits
-         *     per captured comment, each refunded on failure. Set includeComments:false for a candidate list
-         *     without per-thread billing. Comment coverage distinguishes the requested limit, returned text
-         *     comments and reported comment count. A bounded capture can return partial:true.
+         * Discover and rank Reddit discussions for a topic
+         * @description Finds Reddit discussions for a topic or subreddit. Omit the window for an all-time search.
+         *     Dated searches verify the post or a captured comment timestamp, including for link-only results.
+         *     Discovery, verified threads, and returned comment text are billed separately. Undated link-only
+         *     searches bill discovery only. An empty delivery refunds the discovery charge.
          */
         post: operations["redditTrending"];
         delete?: never;
@@ -2408,6 +2404,8 @@ interface components {
                 score?: string;
                 depth?: number;
                 body?: string;
+                /** Format: date-time */
+                publishedAt?: string;
             }[];
             sourceUrl?: string;
         };
@@ -2417,18 +2415,18 @@ interface components {
             /** @description Bare subreddit name to scope the scan, e.g. "SEO" (no r/ prefix). Omit to scan all of Reddit. */
             subreddit?: string;
             /**
-             * @description Publication window; scraped threads are checked against their actual post dates, while discovery-only dates remain unverified.
-             * @default month
+             * @description Activity window. A verified post or comment timestamp can qualify a thread.
+             * @default all
              * @enum {string}
              */
-            window: "week" | "month" | "year" | "all";
+            window: "week" | "14d" | "month" | "year" | "all";
             /**
-             * @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 relevant threads to deliver. Each scraped thread and its returned comments are billed separately.
              * @default 20
              */
             maxThreads: number;
             /**
-             * @description Open selected threads to verify post dates and collect comments; false returns search candidates for your own selection, without per-thread charges or verified post dates.
+             * @description Return captured comment text. Dated results still open and bill for verified threads when false.
              * @default true
              */
             includeComments: boolean;
@@ -2441,7 +2439,7 @@ interface components {
         RedditTrendingResponse: {
             topic?: string;
             subreddit?: string | null;
-            /** @description Resolved publication window: "7d", "30d", "365d" or "all". */
+            /** @description Resolved publication window: "7d", "14d", "30d", "365d" or "all". */
             window?: string;
             totals?: {
                 threads?: number;
@@ -2461,6 +2459,19 @@ interface components {
                  * @description Observed publication timestamp when available.
                  */
                 publishedAt?: string | null;
+                /**
+                 * Format: date-time
+                 * @description Latest verified captured comment timestamp when comment text is omitted.
+                 */
+                latestCommentPublishedAt?: string | null;
+                comments?: {
+                    author: string;
+                    score: string;
+                    depth: number;
+                    body: string;
+                    /** Format: date-time */
+                    publishedAt?: string;
+                }[];
                 /** @description Text comments actually returned for this thread. */
                 capturedCommentCount?: number;
                 /** @description Requested per-thread comment cap. */
@@ -2480,10 +2491,18 @@ interface components {
             }[];
             threadsScraped?: number;
             candidatesFound?: number;
-            /** @description true if scraping stopped early at the time limit. */
+            /** @description True when coverage is partial or the requested delivery target was missed. */
             partial?: boolean;
-            /** @description The Google site:reddit.com query used for discovery. */
+            /** @description The site-scoped query used by the discovery provider. */
             searchQuery?: string;
+            /** @enum {string} */
+            discoverySource?: "google_serp" | "reddit_search_fallback" | "none";
+            /** @enum {string} */
+            resultQuality?: "complete" | "partial" | "degraded";
+            degradedResult?: boolean;
+            degradationReasons?: string[];
+            retryRecommended?: boolean;
+            billingRefunded?: boolean;
         };
         /** @enum {string} */
         RedditCommentCoverageStatus: "complete" | "partial";
@@ -4012,13 +4031,6 @@ interface operations {
             };
             400: components["responses"]["BadRequest"];
             402: components["responses"]["InsufficientBalance"];
-            /** @description No Reddit threads found for that topic and window — billed amount was refunded. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
         };
@@ -5210,6 +5222,7 @@ declare class RedditNamespace {
             score?: string;
             depth?: number;
             body?: string;
+            publishedAt?: string;
         }[];
         sourceUrl?: string;
     }>;

package/dist/index.d.ts

@@ -601,15 +601,11 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Discover and rank the top recent Reddit threads for a topic
-         * @description Discovers Reddit threads through a Google site:reddit.com search and selects relevant candidates
-         *     before scraping. Supports week, month, year and all-time windows. Scraped post dates are checked
-         *     against the requested publication window; discovery-only candidate dates remain unverified.
-         *     With includeComments:true, collects selected threads and ranks by engagement (upvotes + 2x
-         *     reported comments). Billing: one discovery debit plus 30 credits per scraped thread and 2 credits
-         *     per captured comment, each refunded on failure. Set includeComments:false for a candidate list
-         *     without per-thread billing. Comment coverage distinguishes the requested limit, returned text
-         *     comments and reported comment count. A bounded capture can return partial:true.
+         * Discover and rank Reddit discussions for a topic
+         * @description Finds Reddit discussions for a topic or subreddit. Omit the window for an all-time search.
+         *     Dated searches verify the post or a captured comment timestamp, including for link-only results.
+         *     Discovery, verified threads, and returned comment text are billed separately. Undated link-only
+         *     searches bill discovery only. An empty delivery refunds the discovery charge.
          */
         post: operations["redditTrending"];
         delete?: never;
@@ -2408,6 +2404,8 @@ interface components {
                 score?: string;
                 depth?: number;
                 body?: string;
+                /** Format: date-time */
+                publishedAt?: string;
             }[];
             sourceUrl?: string;
         };
@@ -2417,18 +2415,18 @@ interface components {
             /** @description Bare subreddit name to scope the scan, e.g. "SEO" (no r/ prefix). Omit to scan all of Reddit. */
             subreddit?: string;
             /**
-             * @description Publication window; scraped threads are checked against their actual post dates, while discovery-only dates remain unverified.
-             * @default month
+             * @description Activity window. A verified post or comment timestamp can qualify a thread.
+             * @default all
              * @enum {string}
              */
-            window: "week" | "month" | "year" | "all";
+            window: "week" | "14d" | "month" | "year" | "all";
             /**
-             * @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 relevant threads to deliver. Each scraped thread and its returned comments are billed separately.
              * @default 20
              */
             maxThreads: number;
             /**
-             * @description Open selected threads to verify post dates and collect comments; false returns search candidates for your own selection, without per-thread charges or verified post dates.
+             * @description Return captured comment text. Dated results still open and bill for verified threads when false.
              * @default true
              */
             includeComments: boolean;
@@ -2441,7 +2439,7 @@ interface components {
         RedditTrendingResponse: {
             topic?: string;
             subreddit?: string | null;
-            /** @description Resolved publication window: "7d", "30d", "365d" or "all". */
+            /** @description Resolved publication window: "7d", "14d", "30d", "365d" or "all". */
             window?: string;
             totals?: {
                 threads?: number;
@@ -2461,6 +2459,19 @@ interface components {
                  * @description Observed publication timestamp when available.
                  */
                 publishedAt?: string | null;
+                /**
+                 * Format: date-time
+                 * @description Latest verified captured comment timestamp when comment text is omitted.
+                 */
+                latestCommentPublishedAt?: string | null;
+                comments?: {
+                    author: string;
+                    score: string;
+                    depth: number;
+                    body: string;
+                    /** Format: date-time */
+                    publishedAt?: string;
+                }[];
                 /** @description Text comments actually returned for this thread. */
                 capturedCommentCount?: number;
                 /** @description Requested per-thread comment cap. */
@@ -2480,10 +2491,18 @@ interface components {
             }[];
             threadsScraped?: number;
             candidatesFound?: number;
-            /** @description true if scraping stopped early at the time limit. */
+            /** @description True when coverage is partial or the requested delivery target was missed. */
             partial?: boolean;
-            /** @description The Google site:reddit.com query used for discovery. */
+            /** @description The site-scoped query used by the discovery provider. */
             searchQuery?: string;
+            /** @enum {string} */
+            discoverySource?: "google_serp" | "reddit_search_fallback" | "none";
+            /** @enum {string} */
+            resultQuality?: "complete" | "partial" | "degraded";
+            degradedResult?: boolean;
+            degradationReasons?: string[];
+            retryRecommended?: boolean;
+            billingRefunded?: boolean;
         };
         /** @enum {string} */
         RedditCommentCoverageStatus: "complete" | "partial";
@@ -4012,13 +4031,6 @@ interface operations {
             };
             400: components["responses"]["BadRequest"];
             402: components["responses"]["InsufficientBalance"];
-            /** @description No Reddit threads found for that topic and window — billed amount was refunded. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
         };
@@ -5210,6 +5222,7 @@ declare class RedditNamespace {
             score?: string;
             depth?: number;
             body?: string;
+            publishedAt?: string;
         }[];
         sourceUrl?: string;
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.59.1",
+  "version": "0.59.3",
   "description": "Official Node.js client for all 352 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.58.1"
+    "mcpscraper-memory-sdk": "^0.58.3"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"