mcpscraper-sdk 0.40.1 → 0.42.0

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
@@ -45,7 +45,7 @@ Current Google search pricing is 60 Credits per SERP search and 400 Credits plus
45
45
 
46
46
  ## API surface
47
47
 
48
- `client.tools` is the generated, typed 377-tool MCP surface from `contracts/mcp.tools.json`, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
48
+ `client.tools` is the generated, typed 375-tool MCP surface from `contracts/mcp.tools.json`, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
49
49
 
50
50
  For multimodal results such as `meta_ad_creative_media`, call `client.tools.callToolResult(...)` to preserve native MCP image/audio/resource blocks. `callTool(...)` remains backward-compatible and returns the parsed structured or text value.
51
51
 
@@ -89,6 +89,13 @@ Integrations are included with an active Starter plan or higher: OAuth connect/r
89
89
 
90
90
  Core operations are flat on the client: `startHarvest`, `searchSerp`, `harvestPaa`, `extractUrl`, `mapSiteUrls`, `extractSite`, `auditSite`, `getExtractSiteStatus`, `archiveRead`, `listJobs`, `getJob`, `getHistory`, `getLedger`.
91
91
 
92
+ For a durable PAA harvest, `client.tools.other.harvestPaaStart` accepts
93
+ `pages: 1 | 2` and defaults to one. Two pages add page-two organic results when
94
+ available while expanding only the preserved page-one PAA graph. Poll the same
95
+ `jobId` with `harvestPaaStatus`; its `progress.pagination` and
96
+ `result.pagination` are nullable for older saved jobs. The complete workflow is
97
+ in [`../../examples/paa-two-page.mjs`](../../examples/paa-two-page.mjs).
98
+
92
99
  ### Durable acquisition
93
100
 
94
101
  Long-running agents can start SERP/PAA work once and poll the provider-owned job
@@ -170,7 +177,7 @@ const hits = await client.memoryTools.memory.search({ query: 'competitor pricing
170
177
  const vaults = await client.memoryTools.vaults.listVaults({})
171
178
  ```
172
179
 
173
- Use `mcpscraper-memory-sdk`'s own `MemoryClient` instead if you already have a dedicated `mk_...` memory key and want to talk to `memory.mcpscraper.dev` directly.
180
+ Use `mcpscraper-memory-sdk`'s `MemoryClient` when you prefer its Memory-first namespaces; it uses the same MCP Scraper key and root endpoint.
174
181
 
175
182
  ## Regenerating types
176
183
 
package/dist/index.d.cts CHANGED
@@ -1072,7 +1072,7 @@ interface paths$1 {
1072
1072
  get?: never;
1073
1073
  put?: never;
1074
1074
  /**
1075
- * Call one memory.mcpscraper.dev tool by name, using this account's mcpscraper.dev API key
1075
+ * Call one Memory tool by name through mcpscraper.dev using this account's API key
1076
1076
  * @description Generic dispatch: names one of the 116 tools documented in this repo's
1077
1077
  * `contracts/memory.tools.json` and forwards `args` to it, using a memory identity
1078
1078
  * auto-provisioned for the calling mcpscraper.dev account. The response shape depends
package/dist/index.d.ts CHANGED
@@ -1072,7 +1072,7 @@ interface paths$1 {
1072
1072
  get?: never;
1073
1073
  put?: never;
1074
1074
  /**
1075
- * Call one memory.mcpscraper.dev tool by name, using this account's mcpscraper.dev API key
1075
+ * Call one Memory tool by name through mcpscraper.dev using this account's API key
1076
1076
  * @description Generic dispatch: names one of the 116 tools documented in this repo's
1077
1077
  * `contracts/memory.tools.json` and forwards `args` to it, using a memory identity
1078
1078
  * auto-provisioned for the calling mcpscraper.dev account. The response shape depends
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "mcpscraper-sdk",
3
- "version": "0.40.1",
4
- "description": "Official Node.js client for all 377 mcpscraper.dev MCP tools and the REST API",
3
+ "version": "0.42.0",
4
+ "description": "Official Node.js client for all 375 mcpscraper.dev MCP tools and the REST API",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "main": "./dist/index.cjs",
@@ -32,7 +32,7 @@
32
32
  "seo-api"
33
33
  ],
34
34
  "dependencies": {
35
- "mcpscraper-memory-sdk": "^0.40.1"
35
+ "mcpscraper-memory-sdk": "^0.42.0"
36
36
  },
37
37
  "devDependencies": {
38
38
  "openapi-typescript": "^7.13.0"