mcpscraper-sdk 0.18.0 → 0.20.0

package/dist/index.d.cts

@@ -479,6 +479,32 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/reddit/trending": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Discover and rank the top recent Reddit threads for a topic
+         * @description Finds relevant recent Reddit threads via a Google site:reddit.com search over a week/month window,
+         *     then (by default) scrapes them all in parallel for real upvotes, comments, and the questions people
+         *     asked, and ranks by engagement (upvotes + 2x comments). Billing: one discovery debit plus, when
+         *     includeComments is true, 30 credits per scraped thread and 2 credits per captured comment, each
+         *     refunded on failure. Set includeComments:false for a cheap discovery-only sweep (thread list, no
+         *     engagement stats, no per-thread billing). Scraping respects a soft deadline and returns partial:true
+         *     if it stops early rather than exceeding the request limit.
+         */
+        post: operations["redditTrending"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/video/analyze": {
         parameters: {
             query?: never;
@@ -820,9 +846,6 @@ interface components {
             error_type: string;
             message: string;
             retryable: boolean;
-            attempts?: {
-                [key: string]: unknown;
-            }[];
         };
         InsufficientBalanceError: {
             /** @enum {string} */
@@ -898,6 +921,11 @@ interface components {
              * @default false
              */
             serpOnly: boolean;
+            /**
+             * @description Optional Google time filter (past day/week/month/year). Omit for all-time. Pairs well with a site: operator in the query.
+             * @enum {string}
+             */
+            recency?: "day" | "week" | "month" | "year";
             /** @default false */
             debug: boolean;
         };
@@ -909,9 +937,6 @@ interface components {
             result?: {
                 [key: string]: unknown;
             };
-            attempts?: {
-                [key: string]: unknown;
-            }[];
             error?: string;
         };
         JobRecord: {
@@ -921,9 +946,6 @@ interface components {
             result?: {
                 [key: string]: unknown;
             } | null;
-            attempts?: {
-                [key: string]: unknown;
-            }[];
             created_at?: string;
         };
         ExtractUrlRequest: {
@@ -1397,20 +1419,8 @@ interface components {
                 message?: string;
             } | null;
         };
-        SerpIntelligenceCaptureAttempt: {
-            attemptNumber?: number;
-            outcome?: string;
-            startedAt?: string;
-            completedAt?: string;
-            durationMs?: number;
-            problemCode?: string;
-            message?: string;
-            browserSessionId?: string | null;
-            cleanupSucceeded?: boolean | null;
-        };
         SerpIntelligenceCaptureResponse: {
             harvestResult?: components["schemas"]["SerpIntelligenceHarvestResult"];
-            attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
             locationEvidence?: {
                 [key: string]: unknown;
             } | null;
@@ -1421,7 +1431,6 @@ interface components {
         };
         SerpIntelligencePageSnapshotsResponse: {
             pageSnapshotArtifacts?: components["schemas"]["SerpPageSnapshotCapture"][];
-            attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
         };
         WorkflowRun: {
             id?: string;
@@ -2465,6 +2474,97 @@ interface operations {
             };
         };
     };
+    redditTrending: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Topic in plain words, e.g. "crm for small business". Not a URL. */
+                    topic: string;
+                    /** @description Bare subreddit name to scope the scan, e.g. "SEO" (no r/ prefix). Omit to scan all of Reddit. */
+                    subreddit?: string;
+                    /**
+                     * @description How recent the threads must be.
+                     * @default month
+                     * @enum {string}
+                     */
+                    window?: "week" | "month";
+                    /**
+                     * @description How many discovered threads to scrape and rank (scrape-all default). Lower to cap cost.
+                     * @default 20
+                     */
+                    maxThreads?: number;
+                    /**
+                     * @description true = scrape each thread for engagement + questions and rank; false = cheap discovery-only list.
+                     * @default true
+                     */
+                    includeComments?: boolean;
+                    /**
+                     * @description Comments captured (and billed) per scraped thread when includeComments is true.
+                     * @default 50
+                     */
+                    maxCommentsPerThread?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Ranked trending threads. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        topic?: string;
+                        subreddit?: string | null;
+                        /** @description Resolved window, e.g. "7d" or "30d". */
+                        window?: string;
+                        totals?: {
+                            threads?: number;
+                            upvotes?: number;
+                            comments?: number;
+                        };
+                        rankedThreads?: {
+                            title?: string;
+                            url?: string;
+                            subreddit?: string;
+                            score?: number;
+                            commentCount?: number;
+                            engagementScore?: number;
+                            ageText?: string;
+                            topQuestions?: string[];
+                        }[];
+                        questions?: {
+                            question?: string;
+                            threadUrl?: string;
+                        }[];
+                        threadsScraped?: number;
+                        candidatesFound?: number;
+                        /** @description true if scraping stopped early at the time limit. */
+                        partial?: boolean;
+                        /** @description The Google site:reddit.com query used for discovery. */
+                        searchQuery?: string;
+                    };
+                };
+            };
+            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"];
+        };
+    };
     videoAnalyze: {
         parameters: {
             query?: never;
@@ -3380,7 +3480,6 @@ declare class SerpIntelligenceNamespace {
     constructor(r: Requester);
     capture(params: SerpIntelligenceCaptureParams, options?: SerpIntelligenceCaptureOptions): Promise<{
         harvestResult?: components["schemas"]["SerpIntelligenceHarvestResult"];
-        attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
         locationEvidence?: {
             [key: string]: unknown;
         } | null;
@@ -3392,7 +3491,6 @@ declare class SerpIntelligenceNamespace {
     captureWithReceipt(params: SerpIntelligenceCaptureParams, options?: SerpIntelligenceCaptureOptions): Promise<SerpIntelligenceCaptureReceipt>;
     pageSnapshots(params: RequestBodyOf<'serpIntelligencePageSnapshots'>): Promise<{
         pageSnapshotArtifacts?: components["schemas"]["SerpPageSnapshotCapture"][];
-        attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
     }>;
 }
 declare class WorkflowsNamespace {
@@ -3512,9 +3610,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         };
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         error?: string;
     }>;
     harvestPaa(params: RequestBodyOf<'harvestSync'>): Promise<{
@@ -3523,9 +3618,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         };
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         error?: string;
     }>;
     extractUrl(params: RequestBodyOf<'extractUrl'>): Promise<{
@@ -3752,9 +3844,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         } | null;
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         created_at?: string;
     }[]>;
     getJob(id: string): Promise<{
@@ -3764,9 +3853,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         } | null;
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         created_at?: string;
     }>;
     getHistory(): Promise<{

package/dist/index.d.ts

@@ -479,6 +479,32 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/reddit/trending": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Discover and rank the top recent Reddit threads for a topic
+         * @description Finds relevant recent Reddit threads via a Google site:reddit.com search over a week/month window,
+         *     then (by default) scrapes them all in parallel for real upvotes, comments, and the questions people
+         *     asked, and ranks by engagement (upvotes + 2x comments). Billing: one discovery debit plus, when
+         *     includeComments is true, 30 credits per scraped thread and 2 credits per captured comment, each
+         *     refunded on failure. Set includeComments:false for a cheap discovery-only sweep (thread list, no
+         *     engagement stats, no per-thread billing). Scraping respects a soft deadline and returns partial:true
+         *     if it stops early rather than exceeding the request limit.
+         */
+        post: operations["redditTrending"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/video/analyze": {
         parameters: {
             query?: never;
@@ -820,9 +846,6 @@ interface components {
             error_type: string;
             message: string;
             retryable: boolean;
-            attempts?: {
-                [key: string]: unknown;
-            }[];
         };
         InsufficientBalanceError: {
             /** @enum {string} */
@@ -898,6 +921,11 @@ interface components {
              * @default false
              */
             serpOnly: boolean;
+            /**
+             * @description Optional Google time filter (past day/week/month/year). Omit for all-time. Pairs well with a site: operator in the query.
+             * @enum {string}
+             */
+            recency?: "day" | "week" | "month" | "year";
             /** @default false */
             debug: boolean;
         };
@@ -909,9 +937,6 @@ interface components {
             result?: {
                 [key: string]: unknown;
             };
-            attempts?: {
-                [key: string]: unknown;
-            }[];
             error?: string;
         };
         JobRecord: {
@@ -921,9 +946,6 @@ interface components {
             result?: {
                 [key: string]: unknown;
             } | null;
-            attempts?: {
-                [key: string]: unknown;
-            }[];
             created_at?: string;
         };
         ExtractUrlRequest: {
@@ -1397,20 +1419,8 @@ interface components {
                 message?: string;
             } | null;
         };
-        SerpIntelligenceCaptureAttempt: {
-            attemptNumber?: number;
-            outcome?: string;
-            startedAt?: string;
-            completedAt?: string;
-            durationMs?: number;
-            problemCode?: string;
-            message?: string;
-            browserSessionId?: string | null;
-            cleanupSucceeded?: boolean | null;
-        };
         SerpIntelligenceCaptureResponse: {
             harvestResult?: components["schemas"]["SerpIntelligenceHarvestResult"];
-            attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
             locationEvidence?: {
                 [key: string]: unknown;
             } | null;
@@ -1421,7 +1431,6 @@ interface components {
         };
         SerpIntelligencePageSnapshotsResponse: {
             pageSnapshotArtifacts?: components["schemas"]["SerpPageSnapshotCapture"][];
-            attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
         };
         WorkflowRun: {
             id?: string;
@@ -2465,6 +2474,97 @@ interface operations {
             };
         };
     };
+    redditTrending: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Topic in plain words, e.g. "crm for small business". Not a URL. */
+                    topic: string;
+                    /** @description Bare subreddit name to scope the scan, e.g. "SEO" (no r/ prefix). Omit to scan all of Reddit. */
+                    subreddit?: string;
+                    /**
+                     * @description How recent the threads must be.
+                     * @default month
+                     * @enum {string}
+                     */
+                    window?: "week" | "month";
+                    /**
+                     * @description How many discovered threads to scrape and rank (scrape-all default). Lower to cap cost.
+                     * @default 20
+                     */
+                    maxThreads?: number;
+                    /**
+                     * @description true = scrape each thread for engagement + questions and rank; false = cheap discovery-only list.
+                     * @default true
+                     */
+                    includeComments?: boolean;
+                    /**
+                     * @description Comments captured (and billed) per scraped thread when includeComments is true.
+                     * @default 50
+                     */
+                    maxCommentsPerThread?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Ranked trending threads. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        topic?: string;
+                        subreddit?: string | null;
+                        /** @description Resolved window, e.g. "7d" or "30d". */
+                        window?: string;
+                        totals?: {
+                            threads?: number;
+                            upvotes?: number;
+                            comments?: number;
+                        };
+                        rankedThreads?: {
+                            title?: string;
+                            url?: string;
+                            subreddit?: string;
+                            score?: number;
+                            commentCount?: number;
+                            engagementScore?: number;
+                            ageText?: string;
+                            topQuestions?: string[];
+                        }[];
+                        questions?: {
+                            question?: string;
+                            threadUrl?: string;
+                        }[];
+                        threadsScraped?: number;
+                        candidatesFound?: number;
+                        /** @description true if scraping stopped early at the time limit. */
+                        partial?: boolean;
+                        /** @description The Google site:reddit.com query used for discovery. */
+                        searchQuery?: string;
+                    };
+                };
+            };
+            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"];
+        };
+    };
     videoAnalyze: {
         parameters: {
             query?: never;
@@ -3380,7 +3480,6 @@ declare class SerpIntelligenceNamespace {
     constructor(r: Requester);
     capture(params: SerpIntelligenceCaptureParams, options?: SerpIntelligenceCaptureOptions): Promise<{
         harvestResult?: components["schemas"]["SerpIntelligenceHarvestResult"];
-        attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
         locationEvidence?: {
             [key: string]: unknown;
         } | null;
@@ -3392,7 +3491,6 @@ declare class SerpIntelligenceNamespace {
     captureWithReceipt(params: SerpIntelligenceCaptureParams, options?: SerpIntelligenceCaptureOptions): Promise<SerpIntelligenceCaptureReceipt>;
     pageSnapshots(params: RequestBodyOf<'serpIntelligencePageSnapshots'>): Promise<{
         pageSnapshotArtifacts?: components["schemas"]["SerpPageSnapshotCapture"][];
-        attempts?: components["schemas"]["SerpIntelligenceCaptureAttempt"][];
     }>;
 }
 declare class WorkflowsNamespace {
@@ -3512,9 +3610,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         };
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         error?: string;
     }>;
     harvestPaa(params: RequestBodyOf<'harvestSync'>): Promise<{
@@ -3523,9 +3618,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         };
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         error?: string;
     }>;
     extractUrl(params: RequestBodyOf<'extractUrl'>): Promise<{
@@ -3752,9 +3844,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         } | null;
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         created_at?: string;
     }[]>;
     getJob(id: string): Promise<{
@@ -3764,9 +3853,6 @@ declare class ScraperClient {
         result?: {
             [key: string]: unknown;
         } | null;
-        attempts?: {
-            [key: string]: unknown;
-        }[];
         created_at?: string;
     }>;
     getHistory(): Promise<{

package/package.json

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