`meta_ads_get_competitor_ad`

Get Competitor Ad

Description

Fetch one competitor ad in full detail from the scraped corpus and SEE the creative: complete copy (headline, primary text, description, CTA), landing URL, run dates, and every media asset. Mirrored images and video thumbnails are returned inline as image content blocks. For videos, pass include_frames to inline extracted frames (capped at ~40 images; window with start/end seconds and stride) — short-TTL signed URLs for EVERY frame, the audio track, and each original are always in structuredContent, along with frame_count/frame_fps (duration ≈ frame_count / frame_fps), the voiceover transcript, and the audio analysis. Media not yet mirrored or processed degrades to source URLs with a note. Requires no Meta connection. Get ad IDs from meta_ads_list_competitor_ads.

Read-onlyIdempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_get_competitor_ad",
    "arguments": {
      "ad_id": "ad-uuid-from-list",
      "reason": "Read the full copy and media for this ad"
    }
  }
}

hopkin meta competitor-ad get

Flag	Type	Required	Description
`--ad`	`string`	Required	The library ad ID from meta_ads_list_competitor_ads
`--include-frames`	`boolean`	Optional	Include extracted video frames as image content blocks (default: false)
`--stride`	`integer`	Optional	Return every Nth extracted frame. Defaults to a context-safe stride capping frames at ~40 images.
`--start`	`number`	Optional	Only frames at or after this offset into the video, in seconds
`--end`	`number`	Optional	Only frames at or before this offset into the video, in seconds

{
  "mcpServers": {
    "meta-ads": {
      "url": "https://meta.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`ad_id`	`string`	Required	The library ad ID from meta_ads_list_competitor_adsminLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (4)

Name	Type	Required	Description
`include_frames`	`boolean`	Optional	Include extracted video frames as image content blocks (default: false)
`stride`	`integer`	Optional	Return every Nth extracted frame. Defaults to a context-safe stride capping frames at ~40 images.min: 1
`start`	`number`	Optional	Only frames at or after this offset into the video, in secondsmin: 0
`end`	`number`	Optional	Only frames at or before this offset into the video, in secondsmin: 0

Examples

Inspect one ad

{
  "ad_id": "ad-uuid-from-list",
  "reason": "Read the full copy and media for this ad"
}

hopkin meta competitor-ad get --ad ad-uuid-from-list

With video frames

{
  "ad_id": "ad-uuid-from-list",
  "include_frames": true,
  "reason": "Visually review the video creative"
}

hopkin meta competitor-ad get --ad ad-uuid-from-list --include-frames true