mcpscraper-sdk 0.59.2 → 0.59.3

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.
+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,12 +601,11 @@ 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.
+         *     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;
@@ -2405,6 +2404,8 @@ interface components {
                 score?: string;
                 depth?: number;
                 body?: string;
+                /** Format: date-time */
+                publishedAt?: string;
             }[];
             sourceUrl?: string;
         };
@@ -2414,8 +2415,8 @@ 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" | "14d" | "month" | "year" | "all";
@@ -2425,7 +2426,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;
@@ -2458,11 +2459,18 @@ 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;
@@ -2485,7 +2493,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";
@@ -5214,6 +5222,7 @@ declare class RedditNamespace {
             score?: string;
             depth?: number;
             body?: string;
+            publishedAt?: string;
         }[];
         sourceUrl?: string;
     }>;

package/dist/index.d.ts

@@ -601,12 +601,11 @@ 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.
+         *     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;
@@ -2405,6 +2404,8 @@ interface components {
                 score?: string;
                 depth?: number;
                 body?: string;
+                /** Format: date-time */
+                publishedAt?: string;
             }[];
             sourceUrl?: string;
         };
@@ -2414,8 +2415,8 @@ 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" | "14d" | "month" | "year" | "all";
@@ -2425,7 +2426,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;
@@ -2458,11 +2459,18 @@ 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;
@@ -2485,7 +2493,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";
@@ -5214,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.2",
+  "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.2"
+    "mcpscraper-memory-sdk": "^0.58.3"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"