scrapewise_run_scraper_group
Triggers a manual run of EVERY scraper that belongs to the given group. Each
scraper's run is queued asynchronously (same semantics as scrapewise_run_scraper
for an individual scraper). Optional `mergeData=true` combines the per-scraper
results into a single enriched dataset on completion. Requires the
RUN_WITH_GROUP plan feature.
Args:
- id (string, path param, required): the group's MongoDB ObjectId.
- mergeData (boolean, query param, optional, default false): if true, after
all per-scraper runs complete, the data is merged into the group's enriched
sibling collection.
Returns:
200 OK with `{"firstJob": boolean}` — true only when a signed-in user starts their very
first run by hand; always false for API keys. Poll scrapewise_get_scraper_load_history per scraper, or
read scrapewise_get_scraper_group_list to see lastRunState across the group.
Examples:
- Use when: "run all scrapers in group {id}" → id only
- Use when: "run group {id} and merge results" → mergeData=true
- Don't use when: you want to run just one scraper → use scrapewise_run_scraper
Error Handling:
- 402 if customer plan lacks RUN_WITH_GROUP feature.
- 402 WALLET_INSUFFICIENT_BALANCE, raised SYNCHRONOUSLY before anything is queued, when
the pay-as-you-go wallet is on and the customer has neither balance nor free requests.
Nothing runs and nothing is charged; top up and retry.
- 400 (CustomerError envelope) if no group with the given id exists for this customer.
- 401 Unauthorized.
- 500 INTERNAL.[runtime hint] This tool returns JSON-as-text — its response shape is dynamic (per-scraper itemsConfig, file binary, etc.) so the MCP outputSchema is omitted. Do not rely on the presence of any specific field in the response; treat the result as a string-or-object blob and parse defensively.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "scrapewise_run_scraper_group"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's MongoDB ObjectId. | |
| mergeData | No | if true, after all per-scraper runs complete, the data is merged into the group's enriched sibling collection. |