mcpscraper-cli 0.47.0 → 0.48.0

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 Google search pricing is 60 Credits per SERP search and 400 Credits plus 10 Credits per returned question for PAA. 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.0 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.48.0).
+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.0";
+var CLI_VERSION = "0.48.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -26229,34 +26229,43 @@ 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. 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. Costs 60 Credits per search, including internal recovery attempts. 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. 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; full costs 35 Credits per delivered page. 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 returns available same-page SERP features. Both default to one page; full never implies two pages.",
+          "type": "string",
+          "enum": [
+            "light",
+            "full"
+          ]
+        },
         "query": {
           "type": "string",
           "minLength": 1,
           "description": "The search topic, exactly as it should be searched. Include the place here when you want it in the search terms \u2014 the server sends your query to Google unchanged and never adds or removes a location."
         },
         "location": {
-          "description": "Compatibility field. Ordinary one-page search ignores this. Include a place in query when needed.",
+          "description": "Compatibility field. Ordinary search ignores this. Include a place in query when needed.",
           "type": "string"
         },
         "gl": {
           "default": "us",
-          "description": "Compatibility field. Ordinary one-page search uses its fixed default market.",
+          "description": "Compatibility field. Ordinary search uses its fixed default market.",
           "type": "string",
           "minLength": 2,
           "maxLength": 2
         },
         "hl": {
           "default": "en",
-          "description": "Compatibility field. Ordinary one-page search uses its fixed default language.",
+          "description": "Compatibility field. Ordinary search uses its fixed default language.",
           "type": "string"
         },
         "device": {
           "default": "desktop",
-          "description": "Compatibility field. Ordinary one-page search uses desktop results.",
+          "description": "Compatibility field. Ordinary search uses desktop results.",
           "type": "string",
           "enum": [
             "desktop",
@@ -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 one-page search returns organic results only.",
-          "type": "boolean"
-        },
-        "includeLocalPack": {
-          "default": false,
-          "description": "Compatibility field. Ordinary one-page search does not include the local pack.",
-          "type": "boolean"
-        },
-        "includeForums": {
-          "default": false,
-          "description": "Compatibility field. Ordinary one-page search does not include forum modules.",
-          "type": "boolean"
-        },
-        "includeVideos": {
-          "default": false,
-          "description": "Compatibility field. Ordinary one-page search does not include video modules.",
-          "type": "boolean"
-        },
-        "includeAiOverview": {
-          "default": false,
-          "description": "Compatibility field. Ordinary one-page search does not include AI modules.",
-          "type": "boolean"
-        },
-        "includeWhatPeopleSaying": {
-          "default": false,
-          "description": "Compatibility field. Ordinary one-page 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 in light and full modes. Set 2 only when the user explicitly requests two pages.",
           "type": "integer",
           "minimum": 1,
           "maximum": 2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "Command-line interface for the unified mcpscraper.dev MCP and REST APIs",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "mcpscraper-sdk": "^0.48.0"
+    "mcpscraper-sdk": "^0.48.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"