mcpscraper-sdk 0.59.0 → 0.59.2

package/README.md

@@ -2,7 +2,7 @@
 
 Official TypeScript/JavaScript client for the [mcpscraper.dev](https://mcpscraper.dev) REST API — SERP search, People-Also-Ask harvesting, single-page and whole-site extraction, YouTube, Facebook/Google Ads Transparency, Instagram, Reddit, video breakdown, Google Maps, and directory/rank-tracking workflows.
 
-[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0)
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.1)
 
 This is a thin HTTP client generated against [`../../contracts/scraper.openapi.generated.json`](../../contracts/scraper.openapi.generated.json), the complete public REST contract for the hosted API. It contains no scraping, proxy, or billing logic — only typed request/response plumbing.
 
@@ -233,6 +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.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.
+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).
+
+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/index.d.cts

@@ -602,14 +602,11 @@ interface paths {
         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.
+         * @description Finds Reddit discussions for a topic or subreddit. With comments enabled, opens candidate posts
+         *     to verify publication dates, collects comment text, and ranks delivered threads by engagement.
+         *     The 14-day window replaces candidates with no usable comments when more candidates are available.
+         *     Discovery-only results have unverified publication dates. Discovery, delivered threads, and
+         *     captured comments are billed separately. An empty delivery refunds the discovery charge.
          */
         post: operations["redditTrending"];
         delete?: never;
@@ -2421,9 +2418,9 @@ interface components {
              * @default month
              * @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;
@@ -2441,7 +2438,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 +2458,12 @@ interface components {
                  * @description Observed publication timestamp when available.
                  */
                 publishedAt?: string | null;
+                comments?: {
+                    author: string;
+                    score: string;
+                    depth: number;
+                    body: string;
+                }[];
                 /** @description Text comments actually returned for this thread. */
                 capturedCommentCount?: number;
                 /** @description Requested per-thread comment cap. */
@@ -2480,10 +2483,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. */
             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 +4023,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"];
         };

package/dist/index.d.ts

@@ -602,14 +602,11 @@ interface paths {
         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.
+         * @description Finds Reddit discussions for a topic or subreddit. With comments enabled, opens candidate posts
+         *     to verify publication dates, collects comment text, and ranks delivered threads by engagement.
+         *     The 14-day window replaces candidates with no usable comments when more candidates are available.
+         *     Discovery-only results have unverified publication dates. Discovery, delivered threads, and
+         *     captured comments are billed separately. An empty delivery refunds the discovery charge.
          */
         post: operations["redditTrending"];
         delete?: never;
@@ -2421,9 +2418,9 @@ interface components {
              * @default month
              * @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;
@@ -2441,7 +2438,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 +2458,12 @@ interface components {
                  * @description Observed publication timestamp when available.
                  */
                 publishedAt?: string | null;
+                comments?: {
+                    author: string;
+                    score: string;
+                    depth: number;
+                    body: string;
+                }[];
                 /** @description Text comments actually returned for this thread. */
                 capturedCommentCount?: number;
                 /** @description Requested per-thread comment cap. */
@@ -2480,10 +2483,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. */
             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 +4023,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"];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.59.0",
+  "version": "0.59.2",
   "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.0"
+    "mcpscraper-memory-sdk": "^0.58.2"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"