plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "proxy-ad-library",
  "version": "1.0.3",
  "description": "Real-time Meta, Google, LinkedIn and TikTok ad-library access for AI assistants. No API keys.",
  "author": {
    "name": "Proxy",
    "email": "support@useproxy.dev",
    "url": "https://useproxy.dev"
  },
  "homepage": "https://useproxy.dev",
  "license": "UNLICENSED",
  "keywords": [
    "ads",
    "ad library",
    "competitor research",
    "meta",
    "google",
    "linkedin",
    "tiktok"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Proxy",
        "shortDescription": "Ad Library Access",
        "longDescription": "Proxy gives AI assistants real-time access to the public ad libraries of Meta, Google, LinkedIn, and TikTok. Users can search for brands, retrieve their currently running ads, analyze ad creatives (images and video transcripts), discover competitors, and generate competitive briefs \u2014 all without API keys. Workflows span brand lookup, ad retrieval across platforms, media analysis, and keyword or competitor discovery. Proxy is read-only: it only reads public ad libraries and cannot create or publish ads. Private performance data such as conversion rate or ROAS is not available.",
        "developerName": "Proxy",
        "category": "Business & Operations",
        "capabilities": [
          "Search ad libraries",
          "Retrieve ads",
          "Analyze ad creatives",
          "Discover competitors"
        ],
        "websiteURL": "https://useproxy.dev",
        "supportURL": "https://useproxy.dev/support",
        "privacyPolicyURL": "https://useproxy.dev/privacy",
        "termsOfServiceURL": "https://useproxy.dev/terms",
        "defaultPrompt": [
          "Show Nike's active Meta ads.",
          "Who are Canva's main competitors?",
          "What Google ads is Shopify running?"
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Look up a brand's Meta Platform ID by name.",
              "prompt": "Find the Meta Platform ID for Nike.",
              "tools_triggered": "get_meta_platform_id",
              "expected_behavior": "Returns up to three candidate Meta page results for Nike including platform IDs, verified status, and follower counts."
            },
            {
              "description": "Retrieve currently running Meta ads for a brand.",
              "prompt": "Show me all the active Facebook ads that Apple is running right now.",
              "tools_triggered": "get_meta_platform_id, get_meta_ads",
              "expected_behavior": "Returns a list of Apple's active Meta ads with creative text, media URLs, dates, and impression ranges."
            },
            {
              "description": "Search for Google ads for a brand and get details on a specific ad.",
              "prompt": "What Google ads is Shopify running? Get the full details on one of them.",
              "tools_triggered": "get_google_platform_id, get_google_ads, get_google_ad_details",
              "expected_behavior": "Returns Shopify's active Google ads list followed by full creative variations, regional targeting, and impression data for the selected ad."
            },
            {
              "description": "Analyze a video ad for transcript and visual content.",
              "prompt": "Find Anysphere's TikTok ads, then transcribe the first one and describe what's shown visually.",
              "tools_triggered": "search_tiktok_ads, analyze_ad_video",
              "expected_behavior": "Returns Anysphere's EU-delivered TikTok ads, then a timestamped transcript of the first ad's voiceover and a description of scenes, on-screen text, and branding shown in the video."
            },
            {
              "description": "Discover competitors for a company and pull their ads.",
              "prompt": "Who are Canva's main competitors? Show me one competitor's Meta ads.",
              "tools_triggered": "search_competitors, get_meta_platform_id, get_meta_ads",
              "expected_behavior": "Returns a list of competitors for Canva, then retrieves and displays active Meta ads for the chosen competitor."
            }
          ],
          "negative": [
            {
              "description": "Request to post or publish an ad on behalf of the user.",
              "prompt": "Create and publish a Facebook ad for my business."
            },
            {
              "description": "Request for private ad performance data not in public libraries.",
              "prompt": "Show me the conversion rate and ROAS for Nike's current Meta campaigns."
            },
            {
              "description": "Request unrelated to advertising or competitive intelligence.",
              "prompt": "Book me a flight to London next Tuesday."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin reads public ad-library data only. It does not sell products, show plans or initiate any purchase.",
        "demo_recording_url": "https://www.loom.com/share/416673fb725d41ebb6f97a88bbe31a75"
      },
      "publication": {
        "release_notes": "Initial release: Meta, Google, LinkedIn and TikTok ad-library search, creative analysis and competitor discovery."
      },
      "apps": "./.app.json"
    }
  }
}