mcpscraper-sdk 0.59.3 → 0.59.5

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).
 
-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.
+Pass `linkResolution: deferred` to Search or a People Also Ask harvest to receive results before wrapped Google links are resolved, then read the same job again for the destination URLs. See the [0.59.5 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.5) for the compatible package versions.

package/dist/index.d.cts

@@ -603,7 +603,8 @@ interface paths {
         /**
          * 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.
+         *     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.
          */
@@ -2410,8 +2411,17 @@ interface components {
             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;
             /**
@@ -2438,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;
@@ -2454,6 +2474,7 @@ interface components {
                 commentCount?: number;
                 engagementScore?: number;
                 ageText?: string;
+                postBody?: string;
                 /**
                  * Format: date-time
                  * @description Observed publication timestamp when available.
@@ -4031,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"];
         };

package/dist/index.d.ts

@@ -603,7 +603,8 @@ interface paths {
         /**
          * 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.
+         *     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.
          */
@@ -2410,8 +2411,17 @@ interface components {
             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;
             /**
@@ -2438,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;
@@ -2454,6 +2474,7 @@ interface components {
                 commentCount?: number;
                 engagementScore?: number;
                 ageText?: string;
+                postBody?: string;
                 /**
                  * Format: date-time
                  * @description Observed publication timestamp when available.
@@ -4031,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"];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.59.3",
+  "version": "0.59.5",
   "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.3"
+    "mcpscraper-memory-sdk": "^0.58.5"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"