mcp-scraper 0.33.7 → 0.34.0

package/dist/{worker-3LYNVGLF.js → worker-ZZHSYI3Y.js}

@@ -6,13 +6,13 @@ import {
 } from "./chunk-3HBPKR5G.js";
 import {
   harvest
-} from "./chunk-XVCETVYY.js";
+} from "./chunk-4KQVIYIH.js";
 import {
   browserServiceApiKey,
   runWithCostContext
 } from "./chunk-V36LS5YV.js";
 import "./chunk-K443GQY5.js";
-import "./chunk-V73MPRU6.js";
+import "./chunk-CB5C3BPB.js";
 import {
   MC_COSTS,
   serpActualCostMc
@@ -139,4 +139,4 @@ export {
   startWorker,
   tickOnce
 };
-//# sourceMappingURL=worker-3LYNVGLF.js.map
+//# sourceMappingURL=worker-ZZHSYI3Y.js.map

package/docs/mcp-tool-manifest.generated.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-24T22:48:53.625Z",
+  "generatedAt": "2026-07-25T03:25:17.950Z",
   "generatedFrom": "dist/bin/mcp-stdio-server.js",
   "serverInfo": {
     "name": "mcp-scraper",
@@ -16727,7 +16727,7 @@
     {
       "name": "reddit_trending",
       "title": "Reddit Trending",
-      "description": "Discover the top Reddit conversations about a topic from the last 30 days: searches Reddit (optionally one subreddit), ranks threads by engagement (upvotes + 2x comments), scrapes the top ones, and extracts the real questions people asked. Each scraped thread takes ~30s, so keep maxThreads small; for a wide scan set includeComments:false to rank cheaply first, then read the winners with reddit_thread. Not for reading one known thread URL — use reddit_thread for that.",
+      "description": "Discover the top Reddit conversations about a topic from the last week or month: finds relevant recent threads via a Google site:reddit.com search (optionally scoped to one subreddit), scrapes them for real upvotes, comments, and the questions people asked, and ranks by engagement (upvotes + 2x comments). Scraping runs in parallel across the discovered threads; set includeComments:false for a fast, cheap discovery-only sweep (relevant thread list, no engagement stats, no per-thread billing) and then read the ones you want with reddit_thread. Not for reading one known thread URL — use reddit_thread for that.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -16741,17 +16741,26 @@
             "minLength": 1,
             "description": "Bare subreddit name to scope the scan to one community, e.g. \"SEO\" (no r/ prefix, no URL). Omit to scan all of Reddit."
           },
+          "window": {
+            "type": "string",
+            "enum": [
+              "week",
+              "month"
+            ],
+            "default": "month",
+            "description": "How recent the threads must be: \"week\" or \"month\" (default). Applied via a Google time filter over reddit.com, so it reflects genuine recency."
+          },
           "maxThreads": {
             "type": "integer",
             "minimum": 1,
-            "maximum": 25,
-            "default": 5,
-            "description": "Top-ranked threads to keep. Default 5 — each scraped thread adds ~30s and the request has a hard ~300s ceiling, so raise this above 5 only with includeComments:false."
+            "maximum": 40,
+            "default": 20,
+            "description": "How many discovered threads to scrape and rank. Default 20 (scrape-all). Each scraped thread is billed like reddit_thread + its comments, so lower this to cap cost; raise toward 40 for a wider sweep. Scraping runs in parallel and stops early if it nears the request time limit (partial:true in the response)."
           },
           "includeComments": {
             "type": "boolean",
             "default": true,
-            "description": "Scrape each ranked thread for its body and comments to extract questions. Set false for a fast, cheap discovery-only sweep (ranking + metadata only), then call reddit_thread on the winners."
+            "description": "Scrape each discovered thread for real upvotes, comments, and the questions people asked, then rank by engagement. Set false for a fast, cheap discovery-only sweep — returns the discovered threads (title + url) in relevance order with NO engagement stats and NO per-thread billing, so you can then call reddit_thread on the ones you want."
           },
           "maxCommentsPerThread": {
             "type": "integer",
@@ -16877,7 +16886,14 @@
             "type": "integer",
             "minimum": 0
           },
-          "searchUrl": {
+          "candidatesFound": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "partial": {
+            "type": "boolean"
+          },
+          "searchQuery": {
             "type": "string"
           }
         },
@@ -16889,7 +16905,9 @@
           "rankedThreads",
           "questions",
           "threadsScraped",
-          "searchUrl"
+          "candidatesFound",
+          "partial",
+          "searchQuery"
         ],
         "additionalProperties": false,
         "$schema": "http://json-schema.org/draft-07/schema#"
@@ -17679,6 +17697,16 @@
             "maximum": 2,
             "default": 1,
             "description": "Number of result pages to fetch (1–2)."
+          },
+          "recency": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "month",
+              "year"
+            ],
+            "description": "Restrict results to a recent time window (Google \"past day/week/month/year\" filter). Omit for all-time. Useful for \"what is being said this week\" style queries; pairs well with a site: operator in the query."
           }
         },
         "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-scraper",
-  "version": "0.33.7",
+  "version": "0.34.0",
   "description": "MCP server for MCP Scraper web intelligence tools",
   "type": "module",
   "main": "./dist/index.cjs",