Research a competitor
research_competitorStarts the first research on one core competitor that has none yet: Debriefing reads its site and outside sources. It uses one update from the weekly research allowance. Admin only. Send an idempotency_key. A retry with the same idempotency_key returns the first answer and does not act again. It starts no second job and uses no allowance or daily cap a second time.
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": {
"competitor_id": "<competitor_id>",
"idempotency_key": "<idempotency_key>"
},
"name": "research_competitor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| competitor_id | Yes | An id from list_competitors | |
| idempotency_key | Yes | A unique string you make for this request, such as a UUID. Send the same key when you retry, and Debriefing returns the first answer instead of acting twice. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| message | Yes | ||
| refresh | No | ||
| replayed | No | True when this answer repeats an earlier call with the same idempotency_key. |