Analysis tools
Image vision, video transcription, competitor discovery and a cross-platform competitive brief. Works on results from any platform tool.
analyze_ad_image
| Parameter | Type | Notes |
|---|---|---|
media_urls |
string or string[] | Any image URL from a platform tool |
brand_name, ad_id |
string | Optional context |
total_impressions |
int | Enables a performance hypothesis |
Returns the image as a vision content block so the assistant can describe layout, copy and visual hooks.
analyze_ad_video
| Parameter | Type | Notes |
|---|---|---|
ad_archive_id + page_id |
string | Stable Meta identifiers, preferred |
tiktok_id |
string | Stable TikTok identifier, preferred |
media_url |
string | Only for a URL returned in the last few minutes |
Transcribes the voiceover and describes the visual sequence with Gemini. Prefer stable IDs: signed Meta and TikTok URLs expire quickly and the server re-fetches a fresh one for you. One video per call.
search_competitors
| Parameter | Type | Notes |
|---|---|---|
domain |
string | Find similar companies to this site |
company_name or description |
string | Name or market description |
Domain input finds similar sites; name or description runs a semantic search. Returns candidate companies with domains, ready for the platform lookup tools.
get_competitive_brief
| Parameter | Type | Notes |
|---|---|---|
brands |
object[] | { name, is_own_brand, ads: [{ id, impressions, start_date, format, hook_type }] } |
Turns already-pulled ad metadata into a structured brief: winners, formats, hook mix and scenarios. No upstream call. Free.
get_credit_balance
No parameters. Returns remaining daily credits, plan, reset time and upgrade or billing links. Free. See Credits and plans.