plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meta-ad-library-by-ryze-ai",
  "version": "1.0.0",
  "description": "Search the public Meta Ad Library and manage your own Google Ads and Meta Ads accounts from ChatGPT.",
  "author": {
    "name": "Meow AI, LLC",
    "email": "hello@get-ryze.ai",
    "url": "https://www.get-ryze.ai/"
  },
  "homepage": "https://www.get-ryze.ai/",
  "keywords": [
    "meta ad library",
    "facebook ad library",
    "competitor ads",
    "google ads",
    "meta ads",
    "ppc",
    "marketing"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Meta Ad Library by Ryze AI",
        "shortDescription": "Ad Library, Meta & Google Ads",
        "longDescription": "Meta Ad Library by Ryze AI lets you research any advertiser's Facebook and Instagram ads in ChatGPT, then work on your own Google Ads and Meta Ads accounts in the same conversation.\n\nCompetitor research:\n- Search the public Meta Ad Library by competitor domain, Facebook Page id or keyword\n- See the image or video link, ad text, call to action, landing page, start date and days running\n- Longest-running ads come first, filtered by country, format, date and active status\n\nYour Meta Ads and Google Ads accounts:\n- Account summaries and campaign, ad set, ad group, ad and keyword performance with spend, CTR, CPC, CPA and ROAS\n- Search terms, optimization recommendations, and keyword ideas with search volume and bid ranges\n- Changes you confirm: pause or activate campaigns, ad sets and ads, change budgets and bids, add keywords and negative keywords, apply or dismiss recommendations\n\nEvery tool has a fixed, typed input for one specific task. Read tools only read. Changes run with the permissions of the accounts you connected, and ChatGPT asks before anything is overwritten or deleted.\n\nRequires a Ryze AI account. Not affiliated with or endorsed by Meta or Google.",
        "developerName": "Meow AI, LLC",
        "category": "Business & Operations",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://www.get-ryze.ai/",
        "supportURL": "https://www.get-ryze.ai/about",
        "privacyPolicyURL": "https://www.get-ryze.ai/privacy",
        "termsOfServiceURL": "https://www.get-ryze.ai/terms-of-use",
        "defaultPrompt": [
          "Show the longest-running Facebook ads for nike.com",
          "Find ads about running shoes in the Meta Ad Library",
          "Summarize my Google Ads account for the last 30 days"
        ],
        "brandColor": "#1A0E06",
        "brandColorDark": "#F7F1E8",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Competitor research by domain in the public Meta Ad Library.",
              "prompt": "Show the 3 longest-running Facebook and Instagram ads for nike.com in the US.",
              "tools_triggered": "meta_ads_search_ad_library",
              "expected_behavior": "meta_ads_search_ad_library finds the Facebook page Nike (15087023444) and returns 3 Nike ads, longest-running first, each with days running, format, image link, ad text and landing page. Exact ads change as Nike updates its campaigns."
            },
            {
              "description": "Niche scan by keyword in the public Meta Ad Library.",
              "prompt": "Find the 3 longest-running ads about running shoes in the Meta Ad Library.",
              "tools_triggered": "meta_ads_search_ad_library",
              "expected_behavior": "meta_ads_search_ad_library returns 3 ads from several advertisers, longest-running first, for example Running Warehouse, Veloci Running and HOKA, each with days running, image link and ad text. Exact ads change over time."
            },
            {
              "description": "Google Ads account summary for the last 30 days.",
              "prompt": "Summarize my Google Ads account performance for the last 30 days: spend, clicks, impressions and conversions.",
              "tools_triggered": "google_ads_list_accounts, google_ads_get_account_summary",
              "expected_behavior": "google_ads_list_accounts returns the account Ryze AI (9050286399), not a manager, in USD and America/Los_Angeles. The app summarizes it for the last 30 days with impressions, clicks, cost, conversions and CTR. It is a low-activity sample account, so the metrics are zero."
            },
            {
              "description": "Meta Ads campaign performance for the last 30 days, as a table.",
              "prompt": "Show my Meta Ads campaigns in the Ryze Core ad account for the last 30 days with spend, clicks, CPA and ROAS, as a table.",
              "tools_triggered": "meta_ads_list_ad_accounts, meta_ads_get_performance",
              "expected_behavior": "meta_ads_list_ad_accounts includes Ryze Core (act_1012403044761485). The app runs meta_ads_get_performance at campaign level and shows a table of its campaigns with spend, impressions, clicks, CTR, CPC, conversions, CPA and ROAS, plus account totals."
            },
            {
              "description": "Connecting a platform: the app creates a one-time link.",
              "prompt": "Give me a link to connect Meta Ads to my Ryze workspace.",
              "tools_triggered": "ryze_create_connection_link",
              "expected_behavior": "ryze_create_connection_link returns a one-time link on reports.get-ryze.ai for Meta Ads with an expiry time, and the app gives the user that link. This is a write action, so ChatGPT may ask for confirmation first."
            }
          ],
          "negative": [
            {
              "description": "Generic marketing copywriting that needs no ad data.",
              "prompt": "Write 5 Instagram caption ideas for a coffee brand launch."
            },
            {
              "description": "Industry benchmark question answered from general knowledge, not the user's data.",
              "prompt": "What is the average click-through rate for search ads across industries?"
            },
            {
              "description": "Image editing; the app has no image generation or editing tools.",
              "prompt": "Edit this product photo to look more premium for my ad."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1GOw7ssOKQuu9hVJJqO2AcnCKyL8IS0V2/view?usp=sharing",
        "commerce": false,
        "commerce_description": "Ryze AI does not sell products or process payments."
      },
      "publication": {
        "release_notes": "First release: search the public Meta Ad Library and manage Google Ads and Meta Ads with typed tools. OAuth sign-in. Every tool sets all four hints (read-only, destructive, idempotent, open world) explicitly."
      },
      "apps": "./.app.json"
    }
  }
}