save_competitor_ad_to_swipe_file
Save a watched competitor’s ad into the org’s saved Inspiration — a durable reference copy (media + copy + advertiser snapshot) that survives the competitor rotating or deactivating the ad.
The ad must belong to an advertiser this org actively watches (see insights’ list_watched_competitors / list_competitor_ads). Idempotent: re-saving the same ad/variant returns the existing item.
Args: ad_id: The observed ad id (from list_competitor_ads) variant_position: Optional variant position; defaults to the best visual note: Optional note on why this ad matters
Returns: A dictionary containing:
- item: the saved swipe-file item (id, media_url, copy, …)
- source: provenance tag
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
ad_id | string | yes | Observed-ad id from insights’ list_competitor_ads. | |
variant_position | integer | no | Variant to save (position from the ad’s variants). Default: best visual. | |
note | string | no | Why this ad is worth keeping. |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.