mcpscraper-cli 0.51.0 → 0.52.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 +7 -5
- package/dist/bin/cli.js +60 -904
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ Command-line interface for the unified [mcpscraper.dev](https://mcpscraper.dev)
|
|
|
4
4
|
|
|
5
5
|
[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/blob/main/CHANGELOG.md)
|
|
6
6
|
|
|
7
|
-
The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every
|
|
7
|
+
The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every unified MCP tool, including retained-file readers, provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
|
|
8
8
|
|
|
9
9
|
## Install
|
|
10
10
|
|
|
@@ -51,18 +51,18 @@ mcpscraper tools call archive_read --args '{"url":"https://github.com/octocat/He
|
|
|
51
51
|
mcpscraper tools call artifact_describe --args '{"artifactId":"artifact_123"}' --json
|
|
52
52
|
mcpscraper tools call artifact_read --args '{"artifactId":"artifact_123","offset":0,"maxBytes":64000}' --json
|
|
53
53
|
mcpscraper tools call artifact_download --args '{"artifactId":"artifact_123"}' --raw-result
|
|
54
|
-
mcpscraper tools call
|
|
54
|
+
mcpscraper tools call list_artifact_templates --args '{"status":"active"}' --json
|
|
55
55
|
mcpscraper tools call lead_list_enrich --args '{"idempotencyKey":"roofing-dallas-001","source":{"kind":"rows","rows":[{"Business":"White Rock Roofing","City":"Dallas","Website":"https://roofwhiterock.com"}]},"columnMap":{"name":"Business","city":"City","websiteUrl":"Website"},"defaultEntityType":"business","emailSearchFallback":"serp_snippets","peopleDiscovery":"owners","peopleQueryTemplates":["{business} owner of company {city}","{business} founder {city}"],"outputFormats":["csv","xlsx"]}' --json
|
|
56
56
|
mcpscraper tools call gmail_search_messages --args '{"connectionId":"gmail_conn_123","query":"has:attachment newer_than:30d","limit":25}' --json
|
|
57
57
|
mcpscraper tools call gmail_prepare_selection --args '{"connectionId":"gmail_conn_123","purpose":"memory_import","source":{"kind":"query","query":"has:attachment newer_than:30d"}}' --json
|
|
58
58
|
mcpscraper tools call gmail_import_status --args '{"ingestId":"opaque_ingest_id"}' --json
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
`tools list` contains
|
|
61
|
+
`tools list` contains the current manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
|
|
62
62
|
|
|
63
63
|
`tools call --json` keeps the existing output shape: parsed `structuredContent` or text for text-only results, and the MCP envelope when it includes resources or media. Use `--raw-result` to always retain the envelope, including `content`, `structuredContent`, metadata and resource links. Both modes save inline binary blocks to local files and replace their bytes with `savedPath` and byte-count metadata. Retained-file envelopes and resource links remain available in the output. For complete text, use the returned artifact ID with `artifact_read` and follow `nextOffset` until it is null. `artifact_describe` reports MIME type, size, supported readers and retention expiry; `artifact_download` returns or renews the original file's link while retention remains valid. A preview or one read window is not the whole source.
|
|
64
64
|
|
|
65
|
-
Integration connections are included with an active Starter plan or higher and have no extra connection-operation debit in this release.
|
|
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
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 light mode makes two primary attempts, then one API fallback. 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 use a managed browser for organic results at 35 Credits per delivered page. Request a second page 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.
|
|
68
68
|
|
|
@@ -158,4 +158,6 @@ $ mcpscraper map https://example.com --json
|
|
|
158
158
|
|
|
159
159
|
[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)
|
|
160
160
|
|
|
161
|
-
|
|
161
|
+
Durable PAA harvests should wait at least 20 seconds between status checks and honor a longer returned polling interval. Keep the same job ID and retry key while the original work is running.
|
|
162
|
+
|
|
163
|
+
Release changes: [SDK 0.53.1 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.53.1).
|