scrapewise_get_matcher_scope_jobs
Lists the scraper runs of the group that a matching save may use as its scope: the newest
finished run per scraper of the group. Read-only; costs nothing. These run ids are what the scope
list (and the matchersByScope keys) of scrapewise_update_matcher_job take.
Args:
- id (string, path, required): the group's id.
- masterJobId (string, query, optional): the run used as the main list; it is left out of the
answer, so the main list is never matched against itself.
- customerRef (string, query, optional): only for a Scrapewise admin key while the admin works in
another customer's account (Take Over): the customerUniqueRef of that customer. Required then
(409 TAKE_OVER_ACTIVE without it); leave it out otherwise.
Returns:
A list of ScraperJobStatusDTO (id = the run id, scraperId, scraperName, state, finished,
itemsQuantity), newest first.
Examples:
- Use when: "which runs can I match in group {id}?" before a save.
- Use when: refreshing a setup to the newest runs of the same scrapers.
- Don't use when: you need an older run of one scraper -> scrapewise_get_scraper_load_history
(filter by scraper) and pass that run id in scope.
Error Handling:
- 400 (CustomerError): no group with this id for this customer, or a bad masterJobId.
- 409 TAKE_OVER_ACTIVE: this key's admin works in another customer's account — end Take Over or
send customerRef=<that customer's ref>.
- 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_get_matcher_scope_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's id. | |
| customerRef | No | Admin keys in Take Over only: the customerUniqueRef of the customer the admin works for. Required then; leave it out otherwise. | |
| masterJobId | No | the run used as the main list; it is left out of the answer, so the main list is never matched against itself. |