mcpscraper-cli 0.59.1 → 0.59.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -64,7 +64,7 @@ mcpscraper tools call gmail_import_status --args '{"ingestId":"opaque_ingest_id"
64
64
 
65
65
  Integration connections are included with an active Starter plan or higher and have no extra connection-operation debit in this release.
66
66
 
67
- 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. Unfiltered one-page light mode makes two primary attempts, then one API fallback. Two-page searches return organic results without a backup provider. Unfiltered one-page full mode adds available same-page SERP features for 35 Credits. Both modes default to one page. Past-week and past-month searches return one page of organic results at 35 Credits; omit the date filter when requesting two pages. Request a second page explicitly only for an unfiltered search. Date filters and saved search identities require one page. Combining either with two pages is rejected before acquisition or billing. 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.
67
+ 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. Unfiltered one-page light mode makes two primary attempts, then one API fallback. Two-page searches return organic results without a backup provider. Unfiltered one-page full mode adds available same-page SERP features for 45 Credits; when those features take longer the organic results arrive first and `search_serp_status` returns the rest, and a full search without them is charged as a light search. Both modes default to one page. Past-week and past-month searches return one page of organic results at 150 Credits; omit the date filter when requesting two pages. Request a second page explicitly only for an unfiltered search. Date filters and saved search identities require one page. Combining either with two pages is rejected before acquisition or billing. 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.
68
68
 
69
69
  Use `mcpscraper tools call harvest_paa_start --args '{"query":"...","pages":2,"idempotencyKey":"..."}' --json`
70
70
  to request a second organic-results page, then poll the returned `jobId` with
@@ -194,7 +194,7 @@ Server 0.100.1 improves Maps discovery, review text and list collection through
194
194
 
195
195
  ## Consistent hosted MCP protocol
196
196
 
197
- This release targets MCP Scraper 0.107.0 with 459 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.
197
+ This release targets MCP Scraper 0.110.0 with 459 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.
198
198
 
199
199
  Publication management: list owned subdomains with `commons_list_publications`, select a name with `commons_get_publication`, and edit one article with `commons_update_editorial_article`. Publishing merges omitted articles by default; use `mode:replace` for a full replacement. Use the dedicated article or publication delete tool with its current revision and a stable retry key. See the [release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0).
200
200
 
package/dist/bin/cli.js CHANGED
@@ -10,7 +10,7 @@ import { randomUUID } from "crypto";
10
10
  import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
11
11
 
12
12
  // src/version.ts
13
- var CLI_VERSION = "0.59.1";
13
+ var CLI_VERSION = "0.59.3";
14
14
 
15
15
  // src/generated-tools.ts
16
16
  var MCP_TOOL_CATALOG = [
@@ -30802,7 +30802,7 @@ var MCP_TOOL_CATALOG = [
30802
30802
  "name": "search_serp",
30803
30803
  "category": "search",
30804
30804
  "title": "Google SERP Lookup",
30805
- "description": "Search Google. Default light mode returns one organic-results page. Use mode:full on an unfiltered one-page search for available local-pack, forum, video, AI, entity and PAA-preview features; check featureStatus for coverage. Full does not open result sites, expand PAA or open Maps profiles. Set pages:2 only when two pages are requested: organic results only, no backup provider. Date filters (recency:week/month) and saved serpIdentity require one page; identities cannot use full mode. One-page light tries twice before its API fallback. Light costs 20 Credits per delivered page (35 with fallback); one-page full costs 35; a date-filtered search costs 150; two-page full costs 40; saved identities cost 60. Unavailable page 2 means partial coverage billed for page 1. Browser/two-page results mark rich features unsupported. Reuse the same idempotencyKey after an uncertain response. Call credits_info for pricing and balance.",
30805
+ "description": "Search Google. Default light mode returns one organic-results page. Use mode:full on an unfiltered one-page search for available local-pack, forum, video, AI, entity and PAA-preview features; check featureStatus for coverage. Full does not open result sites, expand PAA or open Maps profiles. Set pages:2 only when two pages are requested: organic results only, no backup provider. Date filters (recency:week/month) and saved serpIdentity require one page; identities cannot use full mode. One-page light tries twice before its API fallback. Light costs 20 Credits per delivered page (35 with fallback); one-page full costs 45 (when featureCompletion is pending, organic results arrive first and search_serp_status returns the features; if they stay unavailable the search is charged as light); a date-filtered search costs 150; two-page full costs 40; saved identities cost 60. Unavailable page 2 means partial coverage billed for page 1. Browser/two-page results mark rich features unsupported. Reuse the same idempotencyKey after an uncertain response. Call credits_info for pricing and balance.",
30806
30806
  "inputSchema": {
30807
30807
  "type": "object",
30808
30808
  "properties": {
@@ -30864,8 +30864,7 @@ var MCP_TOOL_CATALOG = [
30864
30864
  "maximum": 2
30865
30865
  },
30866
30866
  "linkResolution": {
30867
- "default": "complete",
30868
- "description": "complete waits until result links are real destination URLs, which can add 30 to 60 seconds when Google wraps them. deferred returns as soon as results are captured: wrapped links stay as working Google redirect links marked pending, and search_serp_status with the returned jobId supplies the destination URLs at no charge once they unlock, usually within a minute; the result states the wait.",
30867
+ "description": "Omit for the default. A one-page full search then delivers as soon as results are captured: most result links are final, and any that Google still wraps stay as working Google redirect links marked pending; search_serp_status with the returned jobId supplies their destination URLs at no charge, usually within a minute, and the result states the wait. Other searches wait for final links by default. complete always waits until every link is a real destination URL, which adds 30 to 60 seconds to a full search. deferred never waits.",
30869
30868
  "type": "string",
30870
30869
  "enum": [
30871
30870
  "complete",
@@ -30898,7 +30897,7 @@ var MCP_TOOL_CATALOG = [
30898
30897
  "name": "search_serp_status",
30899
30898
  "category": "other",
30900
30899
  "title": "Check Durable Google SERP Lookup",
30901
- "description": "Read a saved search by jobId. For a search made with linkResolution:deferred, this supplies the destination URLs for links that were pending; wait the number of seconds the search result states, and call again if some are still pending. Also reads a durable SERP job created through the legacy HTTP job API. Reading never starts or bills another search.",
30900
+ "description": "Read a saved search by jobId. For a search that returned pending links, this supplies their destination URLs; wait the number of seconds the search result states, and call again if some are still pending. Also reads a durable SERP job created through the legacy HTTP job API. Reading never starts or bills another search.",
30902
30901
  "inputSchema": {
30903
30902
  "type": "object",
30904
30903
  "properties": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcpscraper-cli",
3
- "version": "0.59.1",
3
+ "version": "0.59.3",
4
4
  "description": "Command-line interface for the unified mcpscraper.dev MCP and REST APIs",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -19,7 +19,7 @@
19
19
  },
20
20
  "dependencies": {
21
21
  "commander": "^12.0.0",
22
- "mcpscraper-sdk": "^0.61.1"
22
+ "mcpscraper-sdk": "^0.61.3"
23
23
  },
24
24
  "devDependencies": {
25
25
  "@types/node": "^22.0.0"