roasr_spy_search
Find longest-running Meta Ad Library creatives by keyword or brand, sorted by days_live, and get hooks, headlines, format, tags, and country for analysis.
Instructions
Search stored competitor creatives from the Meta Ad Library: by keyword (query — hook/headline/tags) and/or by brand (brand — exact page-name filter). Empty input returns the top by days_live. Returns hook, headline, format, tags, country and ad_archive_id for a follow-up Vision analysis. days_live is a proxy for what wins.
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": "roasr_spy_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | competitor brand / page name (optional; exact filter) | |
| limit | No | how many creatives to return (1–100, default 20) | |
| query | No | keyword or phrase (optional) |