---
title: "Analysis tools"
description: "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](/docs/credits).