Re-dive an Existing Niche
redive_nicheRefresh an existing niche’s Amazon research with current data by re-diving its competitors or discovering a new set; returns a dive ID to track completion.
Instructions
Use this to refresh an existing niche's research with current Amazon data, instead of creating a new niche with create_niche_dive. ⚠️ Spends dive tokens (one batch per ASIN dived) and cannot be undone — set confirm: true only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate re-dive — if a call errors or times out, poll get_dive_status instead of re-calling. Two modes: same_competitors re-dives the niche's current competitor set (no other argument needed) and discover finds a fresh set, sized by numberOfCompetitors and steerable with heroAsin / lockedAsins / excludedAsins. Runs asynchronously: returns a diveId and an estimatedCompletionDate — poll get_dive_status with that diveId until it reports success. The niche keeps its nicheId, so existing rank radars and reports follow the refreshed data.
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": {
"nicheId": "<nicheId>",
"mode": "<mode>"
},
"name": "redive_niche"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | How to pick the competitors for the refreshed dive. `same_competitors` re-runs the niche's current competitor set and takes no other argument — use it to refresh stale data. `discover` searches for a fresh competitor set, which is what you want when the niche has changed. | |
| confirm | No | Must be true to proceed — a re-dive spends dive tokens. Confirm the cost with the user first. | |
| nicheId | Yes | The niche to re-dive. Get one from `list_niches`. | |
| heroAsin | No | `discover` mode only. Seed product the competitor discovery starts from. Defaults to the niche's highest-selling competitor, preferring one the user's own connected seller account owns. | |
| lockedAsins | No | `discover` mode only. ASINs that must stay in the competitor set regardless of what discovery finds. Cannot exceed `numberOfCompetitors`, and cannot overlap `excludedAsins`. | |
| excludedAsins | No | `discover` mode only. ASINs discovery must never select. They are saved as exclusions on the niche, so every later dive of this niche skips them too. ASINs already excluded on the niche are always skipped; put one in `lockedAsins` to dive it anyway. | |
| numberOfCompetitors | No | Total ASINs the refreshed dive should contain, including `lockedAsins`. Required in `discover` mode and rejected in `same_competitors` mode. Dive tokens are spent per ASIN. |