Competitor Monitoring
Run Competitor Monitoring
Collect competitor activity now, outside the schedule
POST
Run a competitor collection now, for one competitor or for all of them.
Collection normally runs on its own: every two weeks for each competitor, at your workspace’s
weekly slot (the schedule), and once when a competitor
is added. Use this to collect again in between.
- A competitor that is already being collected keeps its current run.
- A run collects the activity since the competitor’s previous run, or the last 90 days the first time.
- When a competitor’s next scheduled collection is less than ten days away, this run takes its place.
- Runs are limited per workspace: a run started too soon after the previous one answers
429with codeRATE_LIMITED, and you can try again a little later.
MCP
The same action is therun_competitor_monitoring tool, with the same competitor_id
argument and the same throttle.
Authorizations
The API key you created on the API settings page of the Clustr app.
Body
application/json
One competitor, by its Clustr ID (cmp_…) from List Competitors. Omit it, or send no body, to
run every competitor. The id from earlier responses also works.
Example:
"cmp_r0jpyyqyeh0txpgdhb604j2g9s"