resolve_shop
Resolve a shop name, domain or URL to indexed WhatWins candidates before using ID-scoped tools.
Use resolve_shop whenever the user provides a shop name, domain or URL instead of a verified WhatWins store ID. The tool is typo tolerant and returns ranked candidates rather than silently guessing.
Inputs
| Field | Type | Required | Notes |
|---|---|---|---|
storeIds | [] | Yes | Always empty; this tool resolves an identity |
query | string | Yes | Shop name, domain or URL, 2–160 characters |
limit | number | Yes | 1–5 candidates |
Example call
{
"storeIds": [],
"query": "grunz",
"limit": 5
}Result behavior
Each candidate includes its indexed ID, name, domain and match evidence. Prefer a strong exact-domain candidate. When several plausible candidates remain, show them to the user and ask which shop they mean before running an expensive analysis.
The returned ID is opaque. Do not manufacture IDs from names or domains, and do not assume that resolving a public shop grants access to every tracked-shop-only tool.
Credits
Resolution uses a bounded candidate lookup and settles against the results returned.