plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "adswipefile",
  "version": "1.3.0",
  "description": "Winning Facebook and Instagram ads, competitor ads, hooks and angles from the AdSwipeFile ad library, in your AI agent over MCP: search real Meta ads by brand, niche and format, see what a brand is running, read an ad's copy and audiences, and write hooks from real ads, each linked to the ad's page.",
  "author": {
    "name": "AdSwipeFile",
    "email": "hello@adswipefile.com",
    "url": "https://adswipefile.com"
  },
  "homepage": "https://adswipefile.com/docs/mcp",
  "repository": "https://github.com/adswipefile/adswipefile-plugin",
  "license": "MIT",
  "keywords": [
    "ad library",
    "ads library",
    "winning ads",
    "competitor ads",
    "facebook ads",
    "instagram ads",
    "meta ads",
    "creative research",
    "hooks",
    "angles",
    "ad inspiration",
    "swipe file"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "AdSwipeFile",
        "shortDescription": "Ad library of winning Meta ads",
        "longDescription": "AdSwipeFile is an ad library of winning Facebook and Instagram ads for people who make Meta ads: media buyers, creative strategists, freelancers, agencies and DTC brands. Real ads from real brands, filed by brand, niche and format, that your AI assistant searches for you instead of you scrolling the Meta Ad Library.\n\nAsk what ads a competitor is running and get the formats, hooks, angles and offers it repeats. Ask for winning ads in a niche such as skincare, supplements or software, or in a format such as UGC, before and after, testimonial or comparison. Open an ad to read its audiences and, where your account includes it, its copy, then have the assistant name its hook and angle and write hooks for your product in the same pattern. Ads tracked on Meta show when they started and how long they have run. Check the ads you saved on adswipefile.com, and the newest ads of the brands you follow there.\n\nEvery ad links to its page on adswipefile.com, where you can see the creative.\n\nWhat it does not do: \"winning\" means ads brands kept running and that the library filed as worth studying. The library holds no spend, reach or performance data, so it never says how an ad performed or that one ad beat another. It does not cover every brand or every ad and is not a live feed of the Meta Ad Library. It cannot run, buy or edit ads, and does not generate images or video. Every tool is read-only. An AdSwipeFile account is required to connect.",
        "developerName": "AdSwipeFile",
        "category": "Business & Operations",
        "capabilities": [
          "Winning ads by brand, niche and format",
          "What ads a competitor is running",
          "An ad's copy, audiences and run dates",
          "Hooks and angles read from real ads",
          "New ads from the brands you follow",
          "Your saved ads, in your assistant"
        ],
        "websiteURL": "https://adswipefile.com",
        "supportURL": "https://adswipefile.com/contact",
        "privacyPolicyURL": "https://adswipefile.com/privacy",
        "termsOfServiceURL": "https://adswipefile.com/terms",
        "defaultPrompt": [
          "What ads is Liquid Death running? Sum up its hooks and angles.",
          "Show me winning UGC ads from skincare brands, with their hooks.",
          "Find testimonial ads for supplements and write 3 hooks for my product."
        ],
        "brandColor": "#10A760",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find ads in a niche and format",
              "prompt": "Show me 5 recent UGC ads from beauty and personal care brands.",
              "tools_triggered": "list_niches, list_ads",
              "expected_behavior": "Resolves the niche to beauty-personal-care and the format to ugc, lists up to five of the newest matching ads with each ad's brand, formats and page link, and says so if fewer than five match."
            },
            {
              "description": "Search the library by keyword",
              "prompt": "Find ads about protein powder.",
              "tools_triggered": "search_library",
              "expected_behavior": "Returns the matching ads, brands, niches or formats with their type and page link, and offers to list more ads from the most relevant brand or niche."
            },
            {
              "description": "See what ads one brand is running",
              "prompt": "What ads is Liquid Death running? Sum up its hooks and angles.",
              "tools_triggered": "search_library, list_ads, get_ad",
              "expected_behavior": "Finds the liquid-death brand, reads a sample of its newest ads, and summarizes the hooks, angles, formats and offers it repeats with a link to each ad it draws on; says which ads are still running where the result shows it, and otherwise calls them Liquid Death's ads in the library, not every ad the brand has run."
            },
            {
              "description": "Write hooks from real ads",
              "prompt": "Find testimonial ads in fitness and wellness and write 3 hooks in the same style for my magnesium sleep gummies.",
              "tools_triggered": "list_ads, get_ad",
              "expected_behavior": "Reads several testimonial ads from the fitness-wellness niche, names the pattern each hook uses with a link to the ad, then writes three original hooks for the user's product that follow those patterns without copying any ad's wording."
            },
            {
              "description": "List the signed-in account's saved ads",
              "prompt": "Show me the ads I've saved and what they have in common.",
              "tools_triggered": "list_saved_ads",
              "expected_behavior": "Lists the ads saved on the reviewer account, newest first, with brand, formats and links, and notes the formats or niches they share; if none are saved, says so and explains that ads are saved on adswipefile.com. Does not offer to save or remove ads."
            }
          ],
          "negative": [
            {
              "description": "Performance data is out of scope",
              "prompt": "What CTR and ROAS did Liquid Death's last ads get?",
              "expected_behavior": "Explains that the library holds ad creative, not spend or performance figures, and offers to show Liquid Death's ads instead."
            },
            {
              "description": "Running ads is out of scope",
              "prompt": "Launch this ad on my Facebook account with a $50 daily budget.",
              "expected_behavior": "Explains that AdSwipeFile is a reference library and cannot create, run or buy ads, and calls no tool."
            },
            {
              "description": "Write actions are not supported",
              "prompt": "Save the newest Glossier ad to my favorites.",
              "expected_behavior": "Explains that the plugin is read-only and cannot save or remove ads, and points to adswipefile.com, where the ad's page has a save button."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1b0Pzmu7b7aElkp4t60PHZeT_qYfs0G-z/view?usp=sharing",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments, and shows no plans or prices. Accounts are managed on adswipefile.com, outside ChatGPT."
      },
      "publication": {
        "release_notes": "1.3.0: Listing, skills and example prompts rewritten in the words ad buyers use: winning ads, competitor ads, hooks and angles. Two skills are renamed: find-ad-examples is now find-winning-ads and brand-teardown is now competitor-ads, so commands that named the old skills need the new names. Search winning Facebook and Instagram ads by brand, niche and format; see what ads a brand is running; read an ad's copy, audiences and run dates; review your saved ads and the new ads of brands you follow. Eight read-only tools, every ad linked to its page."
      },
      "apps": "./.app.json"
    }
  }
}