Skip to content
AI CMOHQ
AI CMOHQ
 DOCS
GitHubX

Ad Library

The Ad Library brings competitive ad intelligence and creative discovery into your dashboard under /dashboard/ad-library.

Solo founders can track competing campaigns across Meta, Google, TikTok, LinkedIn, and X without purchasing expensive third-party spy tools.

Core Architecture

The Ad Library operates across three interconnected layers:

1. Multi-Platform Collectors

Collectors ingest public ad data across active advertising networks:

  • Supported Networks: Meta, Google, TikTok, LinkedIn, and X.
  • Live Ingestion: Meta live collection activates when AICMO_AD_LIBRARY_LIVE=1 is enabled alongside your META_AD_LIBRARY_TOKEN.
  • Deterministic Fixtures: Development and testing environments use verified fixtures to guarantee test predictability.

2. Winner Scoring Algorithm

Every ingested ad receives a normalized composite score from 0 to 100 based on four weighted indicators:

Score = 0.40 * Runtime + 0.30 * Reach + 0.20 * Concentration + 0.10 * Spend
  • Runtime (40%): How many consecutive days the creative has remained active. Longevity is the strongest signal of profitability in paid advertising.
  • Estimated Reach (30%): Approximate audience impressions delivered.
  • Concentration (20%): Geographic and demographic targeting focus.
  • Spend (10%): Estimated media investment behind the creative.

3. Winner Tiers & Longevity Labels

Ads are classified into five operational confidence tiers:

  • High Confidence: Top performers with extended continuous runtimes.
  • Winner: Proven creative angles with strong engagement and repeat media buys.
  • Emerging: New campaigns showing early velocity.
  • Loser: Tests paused after short runtimes.
  • Unscored: Newly sighted creatives awaiting longevity signal.

Longevity badges categorize duration into proven, strong, and floor thresholds.

Dashboard Workspaces

The /dashboard/ad-library UI organizes competitive intelligence into three tabs:

  1. Discovery Grid: Filter creatives by platform, niche, format, and winner tier. View ad previews, runtimes, and copy angles.
  2. Saved Boards: Save high-performing ads to organized boards. Saves are decoupled from database foreign keys, so you can bookmark ads even before full ingest completion.
  3. Competitor Watchlist: Track key competitors by brand name. The system automatically reconciles tracked brand spellings and merges discovered advertisers.

Clone & Remix

Found an ad angle that converts? Click Clone to generate on-brand variations with the Kavi agent.

  • The remixHook engine analyzes the source hook and produces three distinct variants:
    1. Direct Problem/Solution: Tackles the core friction point immediately.
    2. Contrarian Perspective: Challenges conventional industry assumptions.
    3. Curiosity Gap: Leads with surprising data or unexpected customer outcomes.

Credit Gate

Running manual search probes and competitor scans is rate-limited and consumes credits under the ad_library_scan credit gate (billed under geo_scan / prospect_scan).