mcpscraper-sdk 0.59.2 → 0.59.4

package/README.md

@@ -239,4 +239,4 @@ Publication management: list owned subdomains with `commons_list_publications`,
 
 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.
+Use Reddit Trends review mode to preview links, approve mode to fetch selected threads, or auto mode to search and fetch in one call. See the [0.59.4 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.4) for the compatible package versions.

package/dist/index.d.cts

@@ -601,12 +601,12 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Discover and rank the top recent Reddit threads for a topic
-         * @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.
+         * 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.
+         *     Review mode previews links. Approve mode fetches only selected URLs from the review.
+         *     Auto mode discovers and fetches threads immediately. Dated fetches verify post or comment timestamps.
+         *     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;
@@ -2405,17 +2405,28 @@ interface components {
                 score?: string;
                 depth?: number;
                 body?: string;
+                /** Format: date-time */
+                publishedAt?: string;
             }[];
             sourceUrl?: string;
         };
         RedditTrendingRequest: {
-            /** @description Topic in plain words, e.g. "crm for small business". Not a URL. */
-            topic: string;
+            /** @description Topic to search. Required for discovery. */
+            topic?: string;
+            /** @enum {string} */
+            approvalMode?: "review" | "approve" | "auto";
+            /**
+             * Format: uuid
+             * @description Required in approve mode.
+             */
+            reviewId?: string;
+            /** @description Required in approve mode. Pass only URLs selected from the review. */
+            approvedUrls?: string[];
             /** @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" | "14d" | "month" | "year" | "all";
@@ -2425,7 +2436,7 @@ interface components {
              */
             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;
@@ -2437,6 +2448,16 @@ interface components {
         };
         RedditTrendingResponse: {
             topic?: string;
+            review?: {
+                /** Format: uuid */
+                id: string;
+                /** Format: date-time */
+                expiresAt: string;
+                /** @enum {string} */
+                window?: "week" | "14d" | "month" | "year" | "all";
+                includeComments?: boolean;
+                maxCommentsPerThread?: number;
+            };
             subreddit?: string | null;
             /** @description Resolved publication window: "7d", "14d", "30d", "365d" or "all". */
             window?: string;
@@ -2453,16 +2474,24 @@ interface components {
                 commentCount?: number;
                 engagementScore?: number;
                 ageText?: string;
+                postBody?: string;
                 /**
                  * Format: date-time
                  * @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;
@@ -2485,7 +2514,7 @@ interface components {
             candidatesFound?: number;
             /** @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";
@@ -4023,6 +4052,13 @@ interface operations {
             };
             400: components["responses"]["BadRequest"];
             402: components["responses"]["InsufficientBalance"];
+            /** @description Review is unavailable or expired. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
         };
@@ -5214,6 +5250,7 @@ declare class RedditNamespace {
             score?: string;
             depth?: number;
             body?: string;
+            publishedAt?: string;
         }[];
         sourceUrl?: string;
     }>;

package/dist/index.d.ts

@@ -601,12 +601,12 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Discover and rank the top recent Reddit threads for a topic
-         * @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.
+         * 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.
+         *     Review mode previews links. Approve mode fetches only selected URLs from the review.
+         *     Auto mode discovers and fetches threads immediately. Dated fetches verify post or comment timestamps.
+         *     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;
@@ -2405,17 +2405,28 @@ interface components {
                 score?: string;
                 depth?: number;
                 body?: string;
+                /** Format: date-time */
+                publishedAt?: string;
             }[];
             sourceUrl?: string;
         };
         RedditTrendingRequest: {
-            /** @description Topic in plain words, e.g. "crm for small business". Not a URL. */
-            topic: string;
+            /** @description Topic to search. Required for discovery. */
+            topic?: string;
+            /** @enum {string} */
+            approvalMode?: "review" | "approve" | "auto";
+            /**
+             * Format: uuid
+             * @description Required in approve mode.
+             */
+            reviewId?: string;
+            /** @description Required in approve mode. Pass only URLs selected from the review. */
+            approvedUrls?: string[];
             /** @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" | "14d" | "month" | "year" | "all";
@@ -2425,7 +2436,7 @@ interface components {
              */
             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;
@@ -2437,6 +2448,16 @@ interface components {
         };
         RedditTrendingResponse: {
             topic?: string;
+            review?: {
+                /** Format: uuid */
+                id: string;
+                /** Format: date-time */
+                expiresAt: string;
+                /** @enum {string} */
+                window?: "week" | "14d" | "month" | "year" | "all";
+                includeComments?: boolean;
+                maxCommentsPerThread?: number;
+            };
             subreddit?: string | null;
             /** @description Resolved publication window: "7d", "14d", "30d", "365d" or "all". */
             window?: string;
@@ -2453,16 +2474,24 @@ interface components {
                 commentCount?: number;
                 engagementScore?: number;
                 ageText?: string;
+                postBody?: string;
                 /**
                  * Format: date-time
                  * @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;
@@ -2485,7 +2514,7 @@ interface components {
             candidatesFound?: number;
             /** @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";
@@ -4023,6 +4052,13 @@ interface operations {
             };
             400: components["responses"]["BadRequest"];
             402: components["responses"]["InsufficientBalance"];
+            /** @description Review is unavailable or expired. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             429: components["responses"]["ConcurrencyLimitExceeded"];
             500: components["responses"]["ServerError"];
         };
@@ -5214,6 +5250,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.2",
+  "version": "0.59.4",
   "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.2"
+    "mcpscraper-memory-sdk": "^0.58.4"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"