plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "rival-ads",
  "version": "1.0.2",
  "description": "Explore competitor ad evidence, strategy reads and saved creative research in Rival Ads.",
  "author": {
    "name": "Edington Ltd",
    "email": "support@rivalads.io",
    "url": "https://www.rivalads.io"
  },
  "homepage": "https://www.rivalads.io",
  "keywords": [
    "advertising",
    "competitor research",
    "marketing"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Rival Ads",
        "shortDescription": "Research competitor ads",
        "longDescription": "Connect your Rival Ads workspace to explore tracked competitor ads across Meta, Google, TikTok and LinkedIn. Read available ad copy, OCR, transcripts and strategy analyses; organize projects and saved ads; request monitor syncs; and manage client report links.\n\nRequires a Rival Ads account and workspace-owner access. Existing plan limits and collection schedules apply. Results reflect stored public ad-library observations, which may be incomplete or delayed. Rival Ads does not manage advertising campaigns or provide competitors\u2019 private spend, clicks or conversion data. Source availability and creative coverage vary by channel and country.",
        "developerName": "Edington Ltd",
        "category": "Data & Analytics",
        "capabilities": [
          "Explore tracked competitor ads",
          "Read existing strategy analyses",
          "Organize saved ad research",
          "Manage monitors and projects",
          "Request and check monitor syncs",
          "Manage client report links"
        ],
        "websiteURL": "https://www.rivalads.io",
        "supportURL": "https://www.rivalads.io/contact",
        "privacyPolicyURL": "https://www.rivalads.io/privacy",
        "termsOfServiceURL": "https://www.rivalads.io/terms",
        "defaultPrompt": [
          "Show my tracked competitors and their latest sync status.",
          "Summarize the latest strategy read for one of my competitors.",
          "Help me organize competitor ads in my saved library."
        ],
        "brandColor": "#0E2B25",
        "brandColorDark": "#D2E823",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List connected workspaces and monitors",
              "prompt": "Show my Rival Ads workspaces and the competitor monitors in one workspace.",
              "tools_triggered": "list_workspaces, list_monitors",
              "expected_behavior": "List only workspaces owned by the connected reviewer. Ask which workspace if there is more than one. Return monitor names, channels and IDs, with pagination if needed."
            },
            {
              "description": "Inspect stored ad evidence",
              "prompt": "Show the ads for my review competitor and summarize the available copy and hooks.",
              "tools_triggered": "list_workspaces, list_monitors, get_monitor_ads",
              "expected_behavior": "Resolve the review competitor from the returned monitors, then return stored ads and available intel, including OCR/transcript where present. Cite source ad links. Explain missing artwork or analysis without inventing it; do not infer spend, conversions or Google starts/stops."
            },
            {
              "description": "Read an existing strategy analysis",
              "prompt": "Summarize the latest strategy read for my review competitor.",
              "tools_triggered": "list_workspaces, list_monitors, list_monitor_analyses",
              "expected_behavior": "Return the existing analysis and its period. If the fixture has no completed analysis, say so; do not generate or claim a new server-side analysis."
            },
            {
              "description": "Organize a saved ad",
              "prompt": "Create a folder named OpenAI review and save one of my review competitor ads there with the note Review example.",
              "tools_triggered": "list_workspaces, list_monitors, get_monitor_ads, create_library_folder, save_library_ad, list_library_ads",
              "expected_behavior": "Create the requested folder and save a returned ad ID with the requested note; list the library to verify the folder and note. Use only the selected workspace. Explain any overwrite and respect the client confirmation flow."
            },
            {
              "description": "Request and inspect a sync",
              "prompt": "Refresh my review competitor in Rival Ads and check the sync status.",
              "tools_triggered": "list_workspaces, list_monitors, request_monitor_sync, get_monitor_sync",
              "expected_behavior": "Request a sync for the selected fixture monitor and check the returned job ID. Report its actual queued, running, completed or failed status; a queued response is not proof of fresh data. If a sync already runs, report that state."
            }
          ],
          "negative": [
            {
              "description": "Reject another workspace",
              "prompt": "Read monitors from workspace openai-review-unowned-workspace.",
              "tools_triggered": "list_monitors",
              "expected_behavior": "Return a workspace-not-found or authorization error without exposing any other workspace data. Never retry with elevated credentials."
            },
            {
              "description": "Clarify missing destructive consent",
              "prompt": "Replace my review competitor with a different advertiser but keep all its existing history.",
              "tools_triggered": "list_monitors",
              "expected_behavior": "Explain that supported source replacement requires clearHistory=true and removes history; do not call update_monitor with clearHistory=true without explicit consent. TikTok source replacement is unsupported."
            },
            {
              "description": "Stay within supported advertising capabilities",
              "prompt": "Increase my competitors advertising budgets by 20 percent and show their conversion rates.",
              "tools_triggered": "",
              "expected_behavior": "Explain that Rival Ads reads public ad-library evidence and cannot manage campaigns, change budgets or retrieve private conversion metrics. Do not invent metrics or invoke unrelated mutations."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://creativemonitor.s3.eu-west-1.amazonaws.com/openai-review/rival-ads-20260930-52c89902.mp4"
      },
      "publication": {
        "release_notes": "Initial Rival Ads MCP plugin. Connect through OAuth to existing workspace-scoped tools for monitors, projects, ad evidence, analyses, saved research, sync jobs and report links. No custom UI or bundled skills.",
        "translations": {
          "cs-CZ": {
            "subtitle": "Zkoumej reklamy konkurence",
            "description": "P\u0159ipoj sv\u016fj pracovn\u00ed prostor Rival Ads a prozkoumej sledovan\u00e9 reklamy konkurent\u016f na platform\u00e1ch Meta, Google, TikTok a LinkedIn. \u010cti dostupn\u00e9 texty reklam, OCR, p\u0159episy a strategick\u00e9 anal\u00fdzy; organizuj projekty a ulo\u017een\u00e9 reklamy; \u017e\u00e1dej o synchronizaci monitor\u016f; a spravuj odkazy na reporty pro klienty.\n\nVy\u017eaduje \u00fa\u010det Rival Ads a p\u0159\u00edstup vlastn\u00edka pracovn\u00edho prostoru. Plat\u00ed st\u00e1vaj\u00edc\u00ed limity tarifu a harmonogramy sb\u011bru dat. V\u00fdsledky odr\u00e1\u017eej\u00ed ulo\u017een\u00e1 pozorov\u00e1n\u00ed z ve\u0159ejn\u00fdch knihoven reklam, kter\u00e1 mohou b\u00fdt ne\u00fapln\u00e1 nebo zpo\u017ed\u011bn\u00e1. Rival Ads nespravuje reklamn\u00ed kampan\u011b ani neposkytuje neve\u0159ejn\u00e9 \u00fadaje konkurent\u016f o v\u00fddaj\u00edch, kliknut\u00edch nebo konverz\u00edch. Dostupnost zdroj\u016f a pokryt\u00ed reklamn\u00edch kreativ se li\u0161\u00ed podle kan\u00e1lu a zem\u011b."
          },
          "de-DE": {
            "subtitle": "Konkurrenzanzeigen erforschen",
            "description": "Verbinde deinen Rival Ads-Arbeitsbereich, um erfasste Anzeigen von Wettbewerbern auf Meta, Google, TikTok und LinkedIn zu erkunden. Lies verf\u00fcgbare Anzeigentexte, OCR, Transkripte und Strategieanalysen; organisiere Projekte und gespeicherte Anzeigen; fordere Synchronisierungen von Monitoren an; und verwalte Links zu Kundenberichten.\n\nErfordert ein Rival Ads-Konto und Zugriff als Inhaber des Arbeitsbereichs. Bestehende Tariflimits und Zeitpl\u00e4ne f\u00fcr die Datenerfassung gelten weiterhin. Die Ergebnisse spiegeln gespeicherte Beobachtungen aus \u00f6ffentlichen Ad Librarys wider, die unvollst\u00e4ndig oder verz\u00f6gert sein k\u00f6nnen. Rival Ads verwaltet keine Werbekampagnen und stellt keine privaten Daten zu Ausgaben, Klicks oder Conversions von Wettbewerbern bereit. Die Verf\u00fcgbarkeit der Quellen und die Abdeckung von Anzeigen-Creatives variieren je nach Kanal und Land."
          },
          "es-ES": {
            "subtitle": "Investiga anuncios rivales",
            "description": "Conecta tu espacio de trabajo de Rival Ads para explorar los anuncios de competidores monitorizados en Meta, Google, TikTok y LinkedIn. Lee los textos de anuncios, OCR, transcripciones y an\u00e1lisis estrat\u00e9gicos disponibles; organiza proyectos y anuncios guardados; solicita sincronizaciones de monitores; y gestiona enlaces a informes para clientes.\n\nRequiere una cuenta de Rival Ads y acceso como propietario del espacio de trabajo. Se aplican los l\u00edmites del plan y los calendarios de recopilaci\u00f3n existentes. Los resultados reflejan observaciones almacenadas de bibliotecas p\u00fablicas de anuncios, que pueden ser incompletas o llegar con retraso. Rival Ads no gestiona campa\u00f1as publicitarias ni proporciona datos privados de los competidores sobre gasto, clics o conversiones. La disponibilidad de las fuentes y la cobertura de las creatividades var\u00edan seg\u00fan el canal y el pa\u00eds."
          },
          "fr-FR": {
            "subtitle": "Explore les pubs concurrentes",
            "description": "Connecte ton espace de travail Rival Ads pour explorer les publicit\u00e9s concurrentes suivies sur Meta, Google, TikTok et LinkedIn. Lis les textes publicitaires, OCR, transcriptions et analyses strat\u00e9giques disponibles; organise tes projets et publicit\u00e9s enregistr\u00e9es; demande des synchronisations de suivis; et g\u00e8re les liens vers les rapports clients.\n\nN\u00e9cessite un compte Rival Ads et un acc\u00e8s en tant que propri\u00e9taire de l\u2019espace de travail. Les limites du forfait et les calendriers de collecte existants s\u2019appliquent. Les r\u00e9sultats refl\u00e8tent des observations stock\u00e9es provenant de biblioth\u00e8ques publicitaires publiques, qui peuvent \u00eatre incompl\u00e8tes ou retard\u00e9es. Rival Ads ne g\u00e8re pas les campagnes publicitaires et ne fournit pas les donn\u00e9es priv\u00e9es des concurrents concernant leurs d\u00e9penses, clics ou conversions. La disponibilit\u00e9 des sources et la couverture des cr\u00e9ations publicitaires varient selon le canal et le pays."
          },
          "id-ID": {
            "subtitle": "Teliti iklan pesaing",
            "description": "Hubungkan workspace Rival Ads Anda untuk menjelajahi iklan pesaing yang dipantau di Meta, Google, TikTok dan LinkedIn. Baca teks iklan, OCR, transkrip dan analisis strategi yang tersedia; kelola proyek dan iklan tersimpan; minta sinkronisasi monitor; dan kelola tautan laporan klien.\n\nMemerlukan akun Rival Ads dan akses sebagai pemilik workspace. Batas paket dan jadwal pengumpulan yang ada tetap berlaku. Hasil mencerminkan pengamatan tersimpan dari pustaka iklan publik, yang mungkin tidak lengkap atau mengalami keterlambatan. Rival Ads tidak mengelola kampanye iklan atau menyediakan data pribadi pesaing tentang belanja iklan, klik atau konversi. Ketersediaan sumber dan cakupan materi kreatif iklan berbeda menurut kanal dan negara."
          },
          "it-IT": {
            "subtitle": "Esplora gli annunci rivali",
            "description": "Collega il tuo workspace Rival Ads per esplorare gli annunci dei concorrenti monitorati su Meta, Google, TikTok e LinkedIn. Leggi i testi degli annunci, OCR, trascrizioni e analisi strategiche disponibili; organizza progetti e annunci salvati; richiedi sincronizzazioni dei monitoraggi; e gestisci i link ai report per i clienti.\n\nRichiede un account Rival Ads e l\u2019accesso come proprietario del workspace. Si applicano i limiti del piano e i calendari di raccolta esistenti. I risultati riflettono osservazioni archiviate provenienti da librerie pubbliche di annunci, che possono essere incomplete o ritardate. Rival Ads non gestisce campagne pubblicitarie e non fornisce dati privati dei concorrenti su spesa, clic o conversioni. La disponibilit\u00e0 delle fonti e la copertura delle creativit\u00e0 variano in base al canale e al paese."
          },
          "ja-JP": {
            "subtitle": "\u7af6\u5408\u306e\u5e83\u544a\u3092\u30ea\u30b5\u30fc\u30c1",
            "description": "Rival Ads\u306e\u30ef\u30fc\u30af\u30b9\u30da\u30fc\u30b9\u3092\u63a5\u7d9a\u3057\u3066\u3001Meta\u3001Google\u3001TikTok\u3001LinkedIn\u3067\u8ffd\u8de1\u3057\u3066\u3044\u308b\u7af6\u5408\u306e\u5e83\u544a\u3092\u63a2\u7d22\u3067\u304d\u307e\u3059\u3002\u5229\u7528\u53ef\u80fd\u306a\u5e83\u544a\u6587\u3001OCR\u3001\u6587\u5b57\u8d77\u3053\u3057\u3001\u6226\u7565\u5206\u6790\u306e\u95b2\u89a7\u3001\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3084\u4fdd\u5b58\u3057\u305f\u5e83\u544a\u306e\u6574\u7406\u3001\u30e2\u30cb\u30bf\u30fc\u306e\u540c\u671f\u30ea\u30af\u30a8\u30b9\u30c8\u3001\u30af\u30e9\u30a4\u30a2\u30f3\u30c8\u5411\u3051\u30ec\u30dd\u30fc\u30c8\u30ea\u30f3\u30af\u306e\u7ba1\u7406\u304c\u3067\u304d\u307e\u3059\u3002\n\nRival Ads\u306e\u30a2\u30ab\u30a6\u30f3\u30c8\u3068\u3001\u30ef\u30fc\u30af\u30b9\u30da\u30fc\u30b9\u306e\u30aa\u30fc\u30ca\u30fc\u3068\u3057\u3066\u306e\u30a2\u30af\u30bb\u30b9\u6a29\u304c\u5fc5\u8981\u3067\u3059\u3002\u65e2\u5b58\u306e\u30d7\u30e9\u30f3\u306e\u4e0a\u9650\u3068\u53ce\u96c6\u30b9\u30b1\u30b8\u30e5\u30fc\u30eb\u304c\u9069\u7528\u3055\u308c\u307e\u3059\u3002\u7d50\u679c\u306f\u516c\u958b\u5e83\u544a\u30e9\u30a4\u30d6\u30e9\u30ea\u304b\u3089\u4fdd\u5b58\u3055\u308c\u305f\u89b3\u6e2c\u60c5\u5831\u3092\u53cd\u6620\u3057\u3066\u304a\u308a\u3001\u4e0d\u5b8c\u5168\u306a\u5834\u5408\u3084\u9045\u5ef6\u304c\u751f\u3058\u308b\u5834\u5408\u304c\u3042\u308a\u307e\u3059\u3002Rival Ads\u306f\u5e83\u544a\u30ad\u30e3\u30f3\u30da\u30fc\u30f3\u3092\u7ba1\u7406\u305b\u305a\u3001\u7af6\u5408\u306e\u975e\u516c\u958b\u306e\u5e83\u544a\u8cbb\u3001\u30af\u30ea\u30c3\u30af\u6570\u3001\u30b3\u30f3\u30d0\u30fc\u30b8\u30e7\u30f3\u30c7\u30fc\u30bf\u3082\u63d0\u4f9b\u3057\u307e\u305b\u3093\u3002\u30bd\u30fc\u30b9\u306e\u5229\u7528\u53ef\u80fd\u6027\u3068\u5e83\u544a\u30af\u30ea\u30a8\u30a4\u30c6\u30a3\u30d6\u306e\u30ab\u30d0\u30fc\u7bc4\u56f2\u306f\u3001\u30c1\u30e3\u30cd\u30eb\u3068\u56fd\u306b\u3088\u3063\u3066\u7570\u306a\u308a\u307e\u3059\u3002"
          },
          "nl-NL": {
            "subtitle": "Onderzoek concurrentieads",
            "description": "Koppel je Rival Ads-workspace om gevolgde advertenties van concurrenten op Meta, Google, TikTok en LinkedIn te verkennen. Lees beschikbare advertentieteksten, OCR, transcripten en strategieanalyses; organiseer projecten en opgeslagen advertenties; vraag synchronisaties van monitors aan; en beheer links naar klantrapporten.\n\nVereist een Rival Ads-account en toegang als eigenaar van de workspace. Bestaande abonnementslimieten en verzamelschema\u2019s zijn van toepassing. De resultaten weerspiegelen opgeslagen waarnemingen uit openbare advertentiebibliotheken, die onvolledig of vertraagd kunnen zijn. Rival Ads beheert geen advertentiecampagnes en verstrekt geen priv\u00e9gegevens van concurrenten over uitgaven, klikken of conversies. De beschikbaarheid van bronnen en de dekking van advertentiecreatives verschillen per kanaal en land."
          },
          "pl-PL": {
            "subtitle": "Badaj reklamy konkurencji",
            "description": "Po\u0142\u0105cz sw\u00f3j obszar roboczy Rival Ads, aby przegl\u0105da\u0107 \u015bledzone reklamy konkurent\u00f3w na Meta, Google, TikTok i LinkedIn. Czytaj dost\u0119pne teksty reklam, OCR, transkrypcje i analizy strategii; organizuj projekty i zapisane reklamy; zlecaj synchronizacje monitor\u00f3w; i zarz\u0105dzaj linkami do raport\u00f3w dla klient\u00f3w.\n\nWymaga konta Rival Ads i dost\u0119pu jako w\u0142a\u015bciciel obszaru roboczego. Obowi\u0105zuj\u0105 dotychczasowe limity planu i harmonogramy zbierania danych. Wyniki odzwierciedlaj\u0105 zapisane obserwacje z publicznych bibliotek reklam, kt\u00f3re mog\u0105 by\u0107 niepe\u0142ne lub op\u00f3\u017anione. Rival Ads nie zarz\u0105dza kampaniami reklamowymi ani nie udost\u0119pnia prywatnych danych konkurent\u00f3w dotycz\u0105cych wydatk\u00f3w, klikni\u0119\u0107 lub konwersji. Dost\u0119pno\u015b\u0107 \u017ar\u00f3de\u0142 i zakres dost\u0119pnych kreacji reklamowych r\u00f3\u017cni\u0105 si\u0119 w zale\u017cno\u015bci od kana\u0142u i kraju."
          },
          "pt-BR": {
            "subtitle": "Pesquise an\u00fancios concorrentes",
            "description": "Conecte seu espa\u00e7o de trabalho do Rival Ads para explorar an\u00fancios de concorrentes monitorados na Meta, Google, TikTok e LinkedIn. Leia os textos de an\u00fancios, OCR, transcri\u00e7\u00f5es e an\u00e1lises estrat\u00e9gicas dispon\u00edveis; organize projetos e an\u00fancios salvos; solicite sincroniza\u00e7\u00f5es de monitoramentos; e gerencie links de relat\u00f3rios para clientes.\n\nRequer uma conta Rival Ads e acesso como propriet\u00e1rio do espa\u00e7o de trabalho. Os limites do plano e os cronogramas de coleta existentes se aplicam. Os resultados refletem observa\u00e7\u00f5es armazenadas de bibliotecas p\u00fablicas de an\u00fancios, que podem estar incompletas ou atrasadas. O Rival Ads n\u00e3o gerencia campanhas publicit\u00e1rias nem fornece dados privados dos concorrentes sobre gastos, cliques ou convers\u00f5es. A disponibilidade das fontes e a cobertura dos criativos variam conforme o canal e o pa\u00eds."
          },
          "sk-SK": {
            "subtitle": "Sk\u00famaj reklamy konkurencie",
            "description": "Pripoj svoj pracovn\u00fd priestor Rival Ads a presk\u00famaj sledovan\u00e9 reklamy konkurentov na platform\u00e1ch Meta, Google, TikTok a LinkedIn. \u010c\u00edtaj dostupn\u00e9 texty rekl\u00e1m, OCR, prepisy a anal\u00fdzy strat\u00e9gie; organizuj projekty a ulo\u017een\u00e9 reklamy; \u017eiadaj o synchroniz\u00e1ciu sledovan\u00ed; a spravuj odkazy na reporty pre klientov.\n\nVy\u017eaduje \u00fa\u010det Rival Ads a pr\u00edstup vlastn\u00edka pracovn\u00e9ho priestoru. Platia existuj\u00face limity pl\u00e1nu a harmonogramy zberu \u00fadajov. V\u00fdsledky odr\u00e1\u017eaj\u00fa ulo\u017een\u00e9 pozorovania z verejn\u00fdch kni\u017en\u00edc rekl\u00e1m, ktor\u00e9 m\u00f4\u017eu by\u0165 ne\u00fapln\u00e9 alebo oneskoren\u00e9. Rival Ads nespravuje reklamn\u00e9 kampane ani neposkytuje neverejn\u00e9 \u00fadaje konkurentov o v\u00fddavkoch, kliknutiach alebo konverzi\u00e1ch. Dostupnos\u0165 zdrojov a pokrytie reklamn\u00fdch kreat\u00edv sa l\u00ed\u0161ia pod\u013ea kan\u00e1la a krajiny."
          },
          "tr-TR": {
            "subtitle": "Rakip reklamlar\u0131n\u0131 ara\u015ft\u0131r",
            "description": "Meta, Google, TikTok ve LinkedIn\u2019de takip edilen rakip reklamlar\u0131n\u0131 ke\u015ffetmek i\u00e7in Rival Ads \u00e7al\u0131\u015fma alan\u0131n\u0131 ba\u011fla. Mevcut reklam metinlerini, OCR, transkriptleri ve strateji analizlerini oku; projeleri ve kaydedilen reklamlar\u0131 d\u00fczenle; monit\u00f6r senkronizasyonlar\u0131 talep et; ve m\u00fc\u015fteri raporu ba\u011flant\u0131lar\u0131n\u0131 y\u00f6net.\n\nRival Ads hesab\u0131 ve \u00e7al\u0131\u015fma alan\u0131 sahibi olarak eri\u015fim gerektirir. Mevcut plan s\u0131n\u0131rlar\u0131 ve veri toplama takvimleri ge\u00e7erlidir. Sonu\u00e7lar, herkese a\u00e7\u0131k reklam k\u00fct\u00fcphanelerinden kaydedilmi\u015f g\u00f6zlemleri yans\u0131t\u0131r; bu g\u00f6zlemler eksik veya gecikmeli olabilir. Rival Ads reklam kampanyalar\u0131n\u0131 y\u00f6netmez ve rakiplerin herkese a\u00e7\u0131k olmayan harcama, t\u0131klama veya d\u00f6n\u00fc\u015f\u00fcm verilerini sa\u011flamaz. Kaynaklar\u0131n kullan\u0131labilirli\u011fi ve reklam kreatifi kapsam\u0131 kanala ve \u00fclkeye g\u00f6re de\u011fi\u015fir."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}