Set the market radar
set_competitor_watchConfigure a weekly or daily competitor watch to track rivals' new ads, 30-day winners, niche trends, top posts, and content ideas; set competitors and topics, or stop tracking by clearing both.
Instructions
Set, change or stop a brand's MARKET RADAR (the standing competitor watch; Ad Spy > Watching in the web app; each brand has its own), run weekly or daily: newAds (what watched brands launched), winners (their ad passing 30 days running), trends + topPosts (formats and most-viewed posts for niche topics), ideas (3 to make). Only what you pass changes. competitors / topics REPLACE their lists (max 8 brands, 5 topics); both empty stops it and clears findings. auto:true picks 3-5 competitors, 2-3 similar brands and 2-3 topics from the saved brand or seed (one model call, billed at its token cost). dryRun:true quotes one check, saves nothing. Saving is free; each check holds its quote first and is skipped when the balance is short. runNow is refused while a check runs or just after one finished. Read it with list_watch_findings.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "set_competitor_watch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto | No | true picks competitors, similar brands and topics from the saved brand or seed; bills one model call at its token cost | |
| seed | No | for auto: a website, brand or niche | |
| brand | No | profile id/name from list_brands, this call only | |
| No | the weekly email | ||
| force | No | with runNow: check again right after a check, allowed once what is watched changed | |
| dryRun | No | true quotes one check and saves nothing | |
| runNow | No | check now (spends now) | |
| topics | No | niche search phrases, e.g. "protein breakfast" | |
| cadence | No | weekly (default) or daily check | |
| modules | No | on/off; omitted keep theirs | |
| competitors | No | the COMPLETE brand list |