Find competitors of a site
find_competitorsFind the competitors of an advertising site by its domain, across the whole base. competitors are the site's direct competitors, the main list of its competitors page: taken from a saved paid competitor analysis of the site when one exists, otherwise from candidate sites filtered by domain rules and checked one by one by an AI judge. Rows keep that order, strongest first; the row's score field is not a rating here. Each row also carries site_profile, the monthly visits estimate, active_ads (Meta ads active now), product_count, platform, top_country and domain_created. A subdomain is looked up by its registrable domain. competitors_total is the number of rows returned (at most limit). An EMPTY competitors list means the site is not covered yet; it is NOT evidence that the site has no competitors. similar (include_similar=true, the default) are look-alike sites by site profile: they resemble the site but were not checked as rivals, and may include clones, mirrors and other domains of the same brand; similar_total counts every site passing the similarity threshold, not only the returned rows. Use get_shop to open one domain in full and search_ads with landing_domain to list its ads. QUOTA: 1 MCP credit (one entity card). PRICING: on paid plans ×1 after 500 MCP credits/month; one-time consent via accept_pricing_terms; before calling, get the maximum debit from estimate_cost (free) and tell the user.
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": {
"domain": "<domain>"
},
"name": "find_competitors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | rows per list (default 20, maximum 50); applies to competitors and to similar | |
| domain | Yes | the site domain (e.g. 'example.com'), as returned by search_shops or get_shop | |
| include_similar | No | also return look-alike sites by site profile in similar (default true); false = competitors only |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when isError is true: machine-readable failure. The human explanation stays in content. | |
| domain | No | ||
| params | No | Request parameter echo: applied = parameters that shaped this result; normalized = parameters rewritten before applying (alias, type coercion, resolved id); ignored = parameters that were accepted but NOT applied, with the reason. | |
| similar | No | ||
| addon_hints | No | Add-on modules that have additional data for objects of this result (no prices, no paid values). subscription_status=active: the account has the module — use its normal path. Do not push a purchase the user did not ask about. | |
| competitors | No | ||
| similar_total | No | ||
| competitors_total | No |