mcpscraper-sdk 0.50.0 → 0.51.0

package/README.md

@@ -41,7 +41,7 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
 - `err.isConcurrencyLimitExceeded()` — narrows `err.body` to `{ active, limit, retryable, upgrade, ... }`.
 - `err.isVerificationChallenge()` / `err.isTimeout()` — preserve actionable, vendor-neutral retry and charge details returned by the service.
 
-Google Search light mode returns organic positions, URLs, titles, and descriptions for 20 Credits per delivered SERP page, or 35 Credits when the backup supplies the result. One-page full mode adds available same-page SERP features for 35 Credits. Both modes default to one page; request two pages explicitly for organic results only at 40 Credits. If page 2 cannot be delivered, an available page 1 is returned as partial and billed at the one-page rate. A 35-Credit-per-requested-page hold is settled after delivery. PAA costs 400 Credits plus 10 Credits per returned question. One optional concurrency pack adds two browser slots for $5/month; quantity `n` adds `2n` slots for `$5n` without changing the base plan.
+Google Search light mode returns organic positions, URLs, titles, and descriptions for 20 Credits per delivered SERP page, or 35 Credits when the backup supplies the result. One-page full mode adds available same-page SERP features for 35 Credits. Both modes default to one page; an unfiltered two-page search costs 40 Credits when the normal provider returns both pages. Past-week and past-month searches use a managed browser for organic results at 35 Credits per delivered page, and unfiltered searches use it only as the final backup. If page 2 cannot be delivered, an available page 1 is returned as partial and billed at the one-page rate. A 35-Credit-per-requested-page hold is settled after delivery. PAA costs 400 Credits plus 10 Credits per returned question. One optional concurrency pack adds two browser slots for $5/month; quantity `n` adds `2n` slots for `$5n` without changing the base plan.
 
 ## API surface
 
@@ -191,4 +191,4 @@ npm run generate
 
 [Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 121-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)
 
-Release changes: [SDK 0.49.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.49.0).
+Release changes: [SDK 0.51.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.51.0).

package/dist/index.d.cts

@@ -1306,7 +1306,7 @@ interface components {
              */
             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.
+             * @description Optional Google time filter. Ordinary search_serp accepts week or month and returns organic browser results; PAA harvest also accepts day and year. Omit for all-time results.
              * @enum {string}
              */
             recency?: "day" | "week" | "month" | "year";
@@ -4501,6 +4501,9 @@ interface ExtractSiteOptions extends ScraperRequestOptions {
 }
 type HarvestDefaultedKey = 'depth' | 'maxQuestions' | 'gl' | 'hl' | 'device' | 'proxyMode' | 'pages' | 'serpOnly' | 'debug';
 type HarvestParams = Omit<RequestBodyOf<'startHarvest'>, HarvestDefaultedKey> & Partial<Pick<RequestBodyOf<'startHarvest'>, HarvestDefaultedKey>>;
+type SearchSerpParams = Omit<RequestBodyOf<'harvestSync'>, 'serpOnly' | 'recency'> & {
+    recency?: 'week' | 'month';
+};
 type ArchiveReadDefaultedKey = 'offset' | 'maxBytes' | 'maxEntries' | 'maxTotalBytes' | 'depositToLibrary';
 type ArchiveReadParams = Omit<RequestBodyOf<'archiveRead'>, ArchiveReadDefaultedKey> & Partial<Pick<RequestBodyOf<'archiveRead'>, ArchiveReadDefaultedKey>>;
 type SerpIntelligenceCaptureDefaultedKey = 'gl' | 'hl' | 'device' | 'proxyMode' | 'pages' | 'debug' | 'includePageSnapshots' | 'pageSnapshotLimit';
@@ -4960,7 +4963,7 @@ declare class ScraperClient {
         job_id: string;
         status: "pending";
     }>;
-    searchSerp(params: Omit<RequestBodyOf<'harvestSync'>, 'serpOnly'>, options?: ScraperRequestOptions): Promise<{
+    searchSerp(params: SearchSerpParams, options?: ScraperRequestOptions): Promise<{
         job_id: string;
         status: "done" | "cancelled" | "failed";
         result?: {
@@ -5310,4 +5313,4 @@ declare class ScraperApiError extends Error {
     };
 }
 
-export { type ArchiveReadParams, type ConcurrencyAccountViewBody, type ConcurrencyLimitBody, type ConcurrencyPackBody, type ExtractSiteOptions, type GmailMutationOptions, type HarvestParams, type IdempotentRequestOptions, type InsufficientBalanceBody, type PublicErrorEnvelopeBody, ScraperApiError, ScraperClient, type ScraperClientOptions, type ScraperRequestOptions, type SerpIntelligenceCaptureOptions, type SerpIntelligenceCaptureParams, type SerpIntelligenceCaptureReceipt, type StructuredErrorBody, type components, type operations, type paths };
+export { type ArchiveReadParams, type ConcurrencyAccountViewBody, type ConcurrencyLimitBody, type ConcurrencyPackBody, type ExtractSiteOptions, type GmailMutationOptions, type HarvestParams, type IdempotentRequestOptions, type InsufficientBalanceBody, type PublicErrorEnvelopeBody, ScraperApiError, ScraperClient, type ScraperClientOptions, type ScraperRequestOptions, type SearchSerpParams, type SerpIntelligenceCaptureOptions, type SerpIntelligenceCaptureParams, type SerpIntelligenceCaptureReceipt, type StructuredErrorBody, type components, type operations, type paths };

package/dist/index.d.ts

@@ -1306,7 +1306,7 @@ interface components {
              */
             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.
+             * @description Optional Google time filter. Ordinary search_serp accepts week or month and returns organic browser results; PAA harvest also accepts day and year. Omit for all-time results.
              * @enum {string}
              */
             recency?: "day" | "week" | "month" | "year";
@@ -4501,6 +4501,9 @@ interface ExtractSiteOptions extends ScraperRequestOptions {
 }
 type HarvestDefaultedKey = 'depth' | 'maxQuestions' | 'gl' | 'hl' | 'device' | 'proxyMode' | 'pages' | 'serpOnly' | 'debug';
 type HarvestParams = Omit<RequestBodyOf<'startHarvest'>, HarvestDefaultedKey> & Partial<Pick<RequestBodyOf<'startHarvest'>, HarvestDefaultedKey>>;
+type SearchSerpParams = Omit<RequestBodyOf<'harvestSync'>, 'serpOnly' | 'recency'> & {
+    recency?: 'week' | 'month';
+};
 type ArchiveReadDefaultedKey = 'offset' | 'maxBytes' | 'maxEntries' | 'maxTotalBytes' | 'depositToLibrary';
 type ArchiveReadParams = Omit<RequestBodyOf<'archiveRead'>, ArchiveReadDefaultedKey> & Partial<Pick<RequestBodyOf<'archiveRead'>, ArchiveReadDefaultedKey>>;
 type SerpIntelligenceCaptureDefaultedKey = 'gl' | 'hl' | 'device' | 'proxyMode' | 'pages' | 'debug' | 'includePageSnapshots' | 'pageSnapshotLimit';
@@ -4960,7 +4963,7 @@ declare class ScraperClient {
         job_id: string;
         status: "pending";
     }>;
-    searchSerp(params: Omit<RequestBodyOf<'harvestSync'>, 'serpOnly'>, options?: ScraperRequestOptions): Promise<{
+    searchSerp(params: SearchSerpParams, options?: ScraperRequestOptions): Promise<{
         job_id: string;
         status: "done" | "cancelled" | "failed";
         result?: {
@@ -5310,4 +5313,4 @@ declare class ScraperApiError extends Error {
     };
 }
 
-export { type ArchiveReadParams, type ConcurrencyAccountViewBody, type ConcurrencyLimitBody, type ConcurrencyPackBody, type ExtractSiteOptions, type GmailMutationOptions, type HarvestParams, type IdempotentRequestOptions, type InsufficientBalanceBody, type PublicErrorEnvelopeBody, ScraperApiError, ScraperClient, type ScraperClientOptions, type ScraperRequestOptions, type SerpIntelligenceCaptureOptions, type SerpIntelligenceCaptureParams, type SerpIntelligenceCaptureReceipt, type StructuredErrorBody, type components, type operations, type paths };
+export { type ArchiveReadParams, type ConcurrencyAccountViewBody, type ConcurrencyLimitBody, type ConcurrencyPackBody, type ExtractSiteOptions, type GmailMutationOptions, type HarvestParams, type IdempotentRequestOptions, type InsufficientBalanceBody, type PublicErrorEnvelopeBody, ScraperApiError, ScraperClient, type ScraperClientOptions, type ScraperRequestOptions, type SearchSerpParams, type SerpIntelligenceCaptureOptions, type SerpIntelligenceCaptureParams, type SerpIntelligenceCaptureReceipt, type StructuredErrorBody, type components, type operations, type paths };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-sdk",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "description": "Official Node.js client for all 364 mcpscraper.dev MCP tools and the REST API",
   "license": "MIT",
   "type": "module",
@@ -19,6 +19,7 @@
     "README.md"
   ],
   "scripts": {
+    "generate": "openapi-typescript ../../contracts/scraper.openapi.yaml -o src/schema.ts",
     "prepack": "npm run build",
     "build": "tsup src/index.ts --format esm,cjs --dts",
     "typecheck": "tsc --noEmit",
@@ -31,7 +32,7 @@
     "seo-api"
   ],
   "dependencies": {
-    "mcpscraper-memory-sdk": "^0.50.0"
+    "mcpscraper-memory-sdk": "^0.51.0"
   },
   "devDependencies": {
     "openapi-typescript": "^7.13.0"