MCP toolsRivals and marketsUpdated
Rivals
What does clickd_rivals do?
Sets a site against its rivals from reads already kept: the sites near it doing similar work, the sites closest in meaning, its market rule by rule, or two sites side by side. A key may make this call on the sites it has claimed.
Listed at /mcp and /mcp/all. Its name answers a call at either address.
When to use it
- You want to know who a site is up against before choosing which fixes to make.
- You want two sites side by side, rule by rule or by what they write about.
What you ask
You say“Who are example.com’s rivals, and where is it behind them?”
clickd_rivals({ site: "example.com" })
| Argument | Type | Needed | What it is |
|---|---|---|---|
site | Text | Yes | The site, as a domain such as example.com. |
view | One of these | No | competitors (the default), near, market, rules or content.competitorsnearmarketrulescontent |
with | Text | No | The other site, already read. |
limit | Number | No | For near only: how many sites. 10 if left out. |
What comes back
- By default, where the site is and its rivals near it doing similar work, each with score and pages.
- Or the sites closest in meaning, the site against its market rule by rule, or two sites rule by rule or by content.
| Site | Score | Pages | Linked from |
|---|---|---|---|
| example.com | 72 | 100 | 4 sites |
| rival.example | 66 | 58 | 9 sites |
| north.example | 48 | 37 | 1 site |
Made-up sites and figures, to show the shape of the answer. The answer itself is JSON. A score says pages are well formed. It does not say an assistant cites the site.
Over HTTP
It is GET /api/v1/sites/{site}/competitors, with your key as a bearer token:
curl "https://clickd.com/api/v1/sites/example.com/competitors" \
-H "Authorization: Bearer $CLICKD_KEY"When it fails
| When | Status | What to do |
|---|---|---|
| Your assistant has no key yet | isError over MCP | Sign up with clickd_signup, then connect again with the key it gives. |
| The key has not claimed the site | 404 | Claim it with clickd_claim, then clickd_claim with step check. |
Every error’s wording is in the API reference.
The call in full, with its HTTP address, each argument’s type, who may make it and the call in four languages, is clickd_rivals in the API reference.