mcpscraper-sdk 0.23.1 → 0.25.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 +4 -2
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -40,7 +40,7 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
|
|
|
40
40
|
|
|
41
41
|
## API surface
|
|
42
42
|
|
|
43
|
-
`client.tools` is the generated, typed
|
|
43
|
+
`client.tools` is the generated, typed 215-tool MCP surface. It includes 114 MCP Scraper tools and all 101 mirrored Memory tools from `contracts/mcp.tools.json`.
|
|
44
44
|
|
|
45
45
|
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.
|
|
46
46
|
|
|
@@ -57,6 +57,8 @@ await client.tools.connections.exportConnectedServiceData({
|
|
|
57
57
|
dataset: 'resend_data',
|
|
58
58
|
lastDays: 7,
|
|
59
59
|
})
|
|
60
|
+
const inbox = await client.tools.schedule.listScheduledRuns({ view: 'inbox' })
|
|
61
|
+
const templates = await client.tools.schedule.listArtifactTemplates({ status: 'active' })
|
|
60
62
|
```
|
|
61
63
|
|
|
62
64
|
The connected-data export performs bounded Gmail, Calendar, Google Search Console, Zoom, Meta Marketing, or Resend pagination server-side and returns small results inline or a private seven-day JSONL artifact. Use `exportConnectedServiceData({ dataset: 'search_console_performance' })` for a fresh Search Console API extract. A scheduled `connection_sync` maintains a typed `gsc_performance_*` table exposed as `listServiceConnections().tableName`; use `exportSearchConsoleTableData` for a server-filtered download from that persisted table. Use `meta_ads_insights` for daily account, campaign, ad-set, and ad reporting across connected Meta ad accounts. Resend can aggregate sent/received mail, logs, contacts, broadcasts, and templates with `resend_data`. Resume partial exports with the returned `continuation` object; renew an expired signed URL with `client.tools.connections.renewConnectedDataDownload({ artifactId })`. Use `listServiceConnections` for verified grants and per-tool permission blockers, then `describeServiceConnectionTool` for the exact provider-native schema before calling through the generic connection bridges.
|
|
@@ -115,4 +117,4 @@ npm run generate
|
|
|
115
117
|
|
|
116
118
|
## See also
|
|
117
119
|
|
|
118
|
-
[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full
|
|
120
|
+
[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 114-tool direct-memory surface) · [`mcpscraper-sdk` on PyPI](https://pypi.org/project/mcpscraper-sdk/) · [`mcpscraper-cli`](../cli)
|
package/dist/index.d.cts
CHANGED
|
@@ -17,8 +17,8 @@ interface paths {
|
|
|
17
17
|
put?: never;
|
|
18
18
|
/**
|
|
19
19
|
* Run a Google SERP search, or a full People-Also-Ask harvest
|
|
20
|
-
* @description Set `serpOnly: true` for a pure organic-results/SERP call (
|
|
21
|
-
*
|
|
20
|
+
* @description Set `serpOnly: true` for a pure organic-results/SERP call (14 credits; runs headful so
|
|
21
|
+
* Google serves a complete page).
|
|
22
22
|
* Omit or set `false` for a full People-Also-Ask harvest, which also returns SERP data
|
|
23
23
|
* (55 credit base + 3 credits per question actually returned; unused estimate is
|
|
24
24
|
* refunded). Runs synchronously and returns the result inline.
|
|
@@ -619,7 +619,7 @@ interface paths {
|
|
|
619
619
|
/**
|
|
620
620
|
* Structured SERP capture with AI Overview/AI Mode detection, entity IDs, and location-match evidence
|
|
621
621
|
* @description Holds 14 credits for the SERP and settles to 4 credits when the capture is served
|
|
622
|
-
* headless, or retains 14 credits when
|
|
622
|
+
* headless, or retains 14 credits when it runs headful.
|
|
623
623
|
* When `includePageSnapshots` is true, also holds 1 credit per requested
|
|
624
624
|
* `pageSnapshotLimit` slot and settles to 1 credit per URL actually attempted.
|
|
625
625
|
* Rate-limited to 60 requests/minute per account.
|
package/dist/index.d.ts
CHANGED
|
@@ -17,8 +17,8 @@ interface paths {
|
|
|
17
17
|
put?: never;
|
|
18
18
|
/**
|
|
19
19
|
* Run a Google SERP search, or a full People-Also-Ask harvest
|
|
20
|
-
* @description Set `serpOnly: true` for a pure organic-results/SERP call (
|
|
21
|
-
*
|
|
20
|
+
* @description Set `serpOnly: true` for a pure organic-results/SERP call (14 credits; runs headful so
|
|
21
|
+
* Google serves a complete page).
|
|
22
22
|
* Omit or set `false` for a full People-Also-Ask harvest, which also returns SERP data
|
|
23
23
|
* (55 credit base + 3 credits per question actually returned; unused estimate is
|
|
24
24
|
* refunded). Runs synchronously and returns the result inline.
|
|
@@ -619,7 +619,7 @@ interface paths {
|
|
|
619
619
|
/**
|
|
620
620
|
* Structured SERP capture with AI Overview/AI Mode detection, entity IDs, and location-match evidence
|
|
621
621
|
* @description Holds 14 credits for the SERP and settles to 4 credits when the capture is served
|
|
622
|
-
* headless, or retains 14 credits when
|
|
622
|
+
* headless, or retains 14 credits when it runs headful.
|
|
623
623
|
* When `includePageSnapshots` is true, also holds 1 credit per requested
|
|
624
624
|
* `pageSnapshotLimit` slot and settles to 1 credit per URL actually attempted.
|
|
625
625
|
* Rate-limited to 60 requests/minute per account.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcpscraper-sdk",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Official Node.js client for all
|
|
3
|
+
"version": "0.25.0",
|
|
4
|
+
"description": "Official Node.js client for all 215 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.
|
|
35
|
+
"mcpscraper-memory-sdk": "^0.26.0"
|
|
36
36
|
},
|
|
37
37
|
"devDependencies": {
|
|
38
38
|
"openapi-typescript": "^7.13.0"
|