radar_ads
Find the ads a competitor (or any search term) is running, from the ad libraries Hookbird is connected to (cached 24 hours). Free. Each ad has its hook text, platform, how many days it has been running (long-running ads are the ones that make money) and a short why. "providers" says which sources are on and, when one is off, why. When "ads" is empty and no provider is enabled, tell the user ad sources are not set up, do not invent ads. When "note" is set, no source covers the asked market: say so and that the ads shown ran elsewhere (each ad's "country"). Competitor names are in brand_profile. Use winning hooks as inspiration for hooks_generate (topic: "remix: ..."). Each ad says whether it is the competitor's own ("own": its advertiser carries the competitor's name and, when brand_profile lists the competitor's site, its ads land there) or only mentions the search word (another advertiser), and whether its text is a template ("templated": a dynamic ad whose words are filled per viewer, like "{{product.brand}}", so they are not public). Only cite, compare or remix the competitor's own ads with real text; say plainly when there are none.
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": "radar_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Or a free search term | |
| limit | No | How many ads (default 10) | |
| country | No | Two letter country code (default: the brand’s market) | |
| minDays | No | Only ads running at least this many days | |
| activeOnly | No | Only ads still running | |
| competitor | No | Competitor brand name, e.g. "Wafeq" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ads | No | ||
| note | No | ||
| error | No | ||
| query | No | ||
| total | No | ||
| market | No | ||
| providers | No |