find_similar_shops
Find untracked competitors or lookalike shops for a named reference shop, with explicit shared-signal evidence.
Use find_similar_shops when the user provides a reference brand and asks for competitors, alternatives or similar stores. Use discover_shops when the request starts from a product niche instead of a reference shop.
Inputs
| Field | Type | Required | Notes |
|---|---|---|---|
storeIds | [] | Yes | Always empty; the reference is supplied in query |
query | string | Yes | Reference shop name, domain or URL, 2–160 characters |
limit | number | Yes | 1–8 suggestions |
sort | enum | Yes | relevance, traffic, live_ads |
countries | string[] | Yes | Zero to eight uppercase country codes |
minTraffic | number | No | Non-negative monthly-traffic threshold |
minLiveAds | number | No | Non-negative observed live-ad threshold |
shopifyOnly | boolean | Yes | Restrict suggestions to detected Shopify shops |
Example call
{
"storeIds": [],
"query": "gruns.co",
"limit": 6,
"sort": "relevance",
"countries": ["US"],
"shopifyOnly": true
}Result behavior
The tool resolves the reference, excludes that shop and shops already tracked by the workspace, then ranks candidates using available graph, semantic and category signals. Each suggestion includes a score, match method and human-readable reasons so the client can explain why it was returned.
Similarity is evidence for research, not proof that two companies are direct commercial competitors. Preserve the reasons and coverage status in the final answer.
Credits
The tool reserves the requested limit and settles against the number of suggestions returned.