scrapewise_get_matcher_run_pairs
Lists the product pairs that ONE finished matching run of the group found, as that run wrote them:
its matches (kind=MATCH) or its to-review pairs (kind=REVIEW), in the run's own order, up to 500 per
page. Use it to look at an older run from the history, also after a newer run replaced its matches.
Read-only; costs nothing; a Read key may call it.
Args:
- id (string, path, required): the group's id.
- runId (string, path, required): the run's id (runId from scrapewise_get_matcher_history).
- kind (string, query, optional, default MATCH): MATCH | REVIEW.
- page (integer, query, optional, default 0): the page, starting at 0.
- size (integer, query, optional, default 100): pairs per page, 1 to 500.
- 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:
runId, kind, ledgerStatus, content, totalElements, page, size. ledgerStatus: COMPLETE (the whole
list), TRUNCATED (the list hit its size limit; to-review pairs were cut first), PARTIAL (a part could
not be stored) or NONE (this run keeps no pair list: an older run, or only the newest runs keep one) -
then content is empty. Each pair: sourceScraperId, sourceIdentity (the shop row's ID value), masterRef
(the main-list row), decision (MATCH / REVIEW), score (0-100 or null), matchOrigin (VERDICT = a person
approved it, KEPT = kept from the run before, ENGINE), sourceTitle, masterTitle.
Examples:
- Use when: "which matches did last week's run have?", "show the pairs of run X".
- Don't use when: you want the group's current matches -> scrapewise_get_match_evidence; the list of
runs -> scrapewise_get_matcher_history.
Error Handling:
- 400 FIELD_INVALID: kind not MATCH / REVIEW, page below 0, or size not 1 to 500 (field names it).
- 404 NotFound: no such run in this group for this customer (also another group's or customer's run).
- 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; 429 RATE_LIMITED; 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>",
"runId": "<runId>"
},
"name": "scrapewise_get_matcher_run_pairs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | the group's id. | |
| kind | No | MATCH | REVIEW. | |
| page | No | the page, starting at 0. | |
| size | No | pairs per page, 1 to 500. | |
| runId | Yes | the run's id (runId from scrapewise_get_matcher_history). | |
| customerRef | No | Admin keys in Take Over only: the customerUniqueRef of the customer the admin works for. Required then; leave it out otherwise. |