scrapewise_update_scraper_group_ai_control
Turns "AI control" on or off for one group. When on, on the chosen schedule, the AI
reviews the latest run of every scraper in the group, detects broken or degraded
results, proposes a fix, checks the fixed results on real pages before using them,
and undoes a fix when the next real run is worse. It can repair scrapers that read the
page with selectors (built automatically or by hand), and JSON-LD and API scrapers; we
switch each kind of repair on. AI-schema scrapers are checked and you get an alert;
they are not repaired yet. Supplier endpoints and uploaded files are not checked.
There are no other customer settings.
During the test phase some problems are only recorded, not repaired. Use
scrapewise_get_scraper_group_ai_control_status to see the next check and the last
result.
Switching on is available after the account's first wallet top-up (or a paid plan).
Switching off is always allowed. Changing the frequency or switching off and on again
never brings the next review earlier than the chosen frequency allows.
When switched on, a first check is queued right away if the group is due; it usually
starts within minutes.
Args:
- id (string, path param, required): the group's MongoDB ObjectId.
- body (GroupAiControlDTO, required): enabled — true/false; cadence — DAILY,
TWICE_WEEKLY or WEEKLY (optional; omitted keeps the current choice, default WEEKLY).
Returns:
The updated GroupDTO, carrying aiControlEnabled and aiControlCadence.
Examples:
- Use when: "let AI check and fix the scrapers in group {id} every week" →
enabled=true, cadence=WEEKLY
- Use when: "check group {id} every day" → enabled=true, cadence=DAILY
- Use when: "stop the AI from changing scrapers in group {id}" → enabled=false
- Don't use when: you want to change one scraper's selectors yourself → edit the
scraper (scrapewise_create_scraper with its id — it creates or updates).
Error Handling:
- 402 (PlanError) when switching on before the account's first wallet top-up.
- 400 (CustomerError envelope) if no group with the given id exists for this
customer, or the cadence is not one of the three values.
- 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>",
"body": "<body>"
},
"name": "scrapewise_update_scraper_group_ai_control"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's MongoDB ObjectId. | |
| body | Yes | Switch group AI control on or off and choose how often it runs. |