mcpscraper-cli 0.47.1 → 0.48.1

package/README.md

@@ -45,7 +45,7 @@ mcpscraper tools call gmail_import_status --args '{"ingestId":"opaque_ingest_id"
 
 Integration connections are included with an active Starter plan or higher and have no extra connection-operation debit in this release. Scheduled occurrences cost 75 Credits; agent-mode runs also add 1.5 times OpenRouter's actual reported cost. Inspect the live policy with `mcpscraper tools call get-schedule-status --args '{}'`.
 
-Current ordinary Google search pricing is 20 Credits per delivered SERP page, or 35 Credits per delivered page when the backup supplies the result. 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 browser slots.
+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. Full mode adds available same-page SERP features for 35 Credits per delivered page. Both modes default to one page; request two pages explicitly. 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 browser slots.
 
 Use `mcpscraper tools call harvest_paa_start --args '{"query":"...","pages":2,"idempotencyKey":"..."}' --json`
 to request a second organic-results page, then poll the returned `jobId` with
@@ -139,4 +139,4 @@ $ mcpscraper map https://example.com --json
 
 [Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-sdk`](../scraper) · [`mcpscraper-memory-sdk`](../memory) · Python: [`mcpscraper-sdk`](../scraper-python) · [`mcpscraper-memory-sdk`](../memory-python)
 
-Release changes: [SDK 0.48.1 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.48.1).
+Release changes: [SDK 0.49.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.49.0).

package/dist/bin/cli.js

@@ -10,7 +10,7 @@ import { randomUUID } from "crypto";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 
 // src/version.ts
-var CLI_VERSION = "0.47.1";
+var CLI_VERSION = "0.48.1";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -26229,10 +26229,19 @@ var MCP_TOOL_CATALOG = [
     "name": "search_serp",
     "category": "search",
     "title": "Google SERP Lookup",
-    "description": "Search current Google organic results, returning positions, URLs, titles, and descriptions without PAA expansion. Query is sent unchanged. One page is returned by default; set pages to 2 for a second page. Ordinary searches cost 20 Credits per page, or 35 Credits per page if the backup provider supplies the result. A temporary 35-Credit-per-page hold is settled to the delivered rate. Location, language, device, recency, and optional SERP module fields are accepted for compatibility but do not alter ordinary searches. Reuse the same idempotencyKey after an unknown response to recover the same billed operation. A saved serpIdentity uses its browser context and retains its 60-Credit search rate. Call credits_info for current pricing and balance.",
+    "description": "Search Google once. Light mode (default) returns organic position, URL, title, and description. Full mode returns those results plus available same-page SERP features: local pack, discussions/forums, videos, AI Overview, AI Mode, What People Are Saying, entity IDs, and on-page PAA preview when present. Feature status distinguishes present, absent, incomplete, unknown, and unsupported. Both modes default to one page; set pages:2 only when the user explicitly requests two pages. Two-page requests use organic results only and mark rich features unsupported. If page 2 fails, an available page 1 is returned as partial and billed for one delivered page. Full does not expand PAA, open Maps profiles, or scrape result sites. Light costs 20 Credits per delivered page, or 35 if the backup supplies it; one-page full costs 35 Credits; explicit two-page full costs 40 Credits for organic results only. Reuse the same idempotencyKey after an unknown response to recover the same billed operation. A saved serpIdentity uses its browser context and retains its 60-Credit search rate; it cannot be combined with full mode. Call credits_info for current pricing and balance.",
     "inputSchema": {
       "type": "object",
       "properties": {
+        "mode": {
+          "default": "light",
+          "description": "Light returns organic results. Full adds available SERP features for one page. With an explicit two-page request, only organic results are available and feature status is unsupported. Both default to one page.",
+          "type": "string",
+          "enum": [
+            "light",
+            "full"
+          ]
+        },
         "query": {
           "type": "string",
           "minLength": 1,
@@ -26274,39 +26283,9 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
         },
-        "includeAllSerpFeatures": {
-          "default": false,
-          "description": "Compatibility field. Ordinary search returns organic results only.",
-          "type": "boolean"
-        },
-        "includeLocalPack": {
-          "default": false,
-          "description": "Compatibility field. Ordinary search does not include the local pack.",
-          "type": "boolean"
-        },
-        "includeForums": {
-          "default": false,
-          "description": "Compatibility field. Ordinary search does not include forum modules.",
-          "type": "boolean"
-        },
-        "includeVideos": {
-          "default": false,
-          "description": "Compatibility field. Ordinary search does not include video modules.",
-          "type": "boolean"
-        },
-        "includeAiOverview": {
-          "default": false,
-          "description": "Compatibility field. Ordinary search does not include AI modules.",
-          "type": "boolean"
-        },
-        "includeWhatPeopleSaying": {
-          "default": false,
-          "description": "Compatibility field. Ordinary search does not include social modules.",
-          "type": "boolean"
-        },
         "pages": {
           "default": 1,
-          "description": "Request one page by default or two pages of organic results.",
+          "description": "One page by default. Set 2 only when the user explicitly requests two pages; two-page results include organic listings only; if page 2 is unavailable, page 1 is returned and billed when available.",
           "type": "integer",
           "minimum": 1,
           "maximum": 2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.47.1",
+  "version": "0.48.1",
   "description": "Command-line interface for the unified mcpscraper.dev MCP and REST APIs",
   "license": "MIT",
   "type": "module",