Paid-Creative Reverse Engineer

SKILL: Paid-Creative Reverse Engineer
A rival's top reels and videos reveal which hooks, formats, and CTAs actually convert. Ranking Facebook reels by play count and TikTok by most-liked strips away vanity content, while an optional YouTube pass extends the teardown to video ads, pre-roll, and long-form hooks. A platforms input lets you choose exactly which cross-platform surfaces to run, and region, recency, and depth controls tune the pull.

You are running this skill on API Direct via its MCP tools. Execute the steps below yourself by calling the named tools in order — values in <angle brackets> come from a previous step. Then deliver the result described at the end.

INPUTS:
  - competitor (required): <competitor — ASK THE USER>
      The rival brand whose video creative you want to reverse-engineer
  - platforms (optional): (optional — e.g. facebook, tiktok, youtube)
      Comma-separated list of platforms to run — options: facebook, tiktok, youtube. Omit to run all of them; name specific platforms to limit the run.
  - region (optional): (optional — e.g. us)
      Two-letter region code applied to the TikTok search to localize which creative is winning
  - recency_days (optional): 30 (default — override if you like)
      Freshness window in days for TikTok results (one of 1, 7, 30, 90, 180) to focus on current creative trends
  - depth (optional): 2 (default — override if you like)
      How many pages of results to pull per platform (more pages = a deeper teardown); applies to the reels, videos, TikTok, and YouTube steps

PLATFORM SELECTION: some steps are gated with "Only run if {platforms} includes X". If the user supplied a `platforms` value, run only the steps whose platform is listed. If the user did NOT supply `platforms`, run ALL steps — every platform the skill supports.

STEPS:
  1. Tool `search_facebook_pages` — search_facebook_pages(query={competitor})
     Locate the brand's official Facebook page url.
  2. Tool `facebook_page_details` — facebook_page_details(url=<page_url>)
     Pull the reels_page_id and delegate_page_id needed for the media endpoints.
  3. Tool `facebook_page_reels` — facebook_page_reels(reels_page_id=<reels_page_id>, get_sentiment=true, pages=2)
     Rank reels by play_count to surface their highest-performing hooks and openers. Facebook is the always-on anchor of the teardown.
  4. Tool `facebook_page_videos` — facebook_page_videos(delegate_page_id=<delegate_page_id>, get_sentiment=true, pages=2)
     Sort by views to extract recurring video angles, story structures, and CTAs.
  5. Tool `search_tiktok` — search_tiktok(query={competitor}, sort_by=most_liked, publish_time=30, get_sentiment=true, pages=2)
     Only run if {platforms} includes tiktok: Cross-check which creative concepts win on TikTok; flag is_ad items and the trending sounds used.
  6. Tool `search_youtube` — search_youtube(query={competitor}, get_sentiment=true, pages=2)
     Only run if {platforms} includes youtube: Surface the brand's YouTube long-form video hooks, formats, and CTAs to complete the cross-platform creative teardown.

DELIVER: A cross-platform creative teardown of the rival's top-performing video hooks, formats, and angles — with the sounds and CTAs to replicate — across Facebook, TikTok, and (optionally) YouTube, for whichever platforms you choose to run.

Note: each underlying tool call is billed at its normal endpoint price; get_sentiment adds a small per-page surcharge. Page through results as needed but stop once you have enough to deliver the outcome.