← Files HYPD.AI Competitor AdsARCHIVED FILE
plugin.json
7.47 KB · Nov 16, 2026 · 18:16 UTC
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "hypd-ad-library",
"version": "1.0.2",
"description": "Research competitors' ads from public data: the Meta Ad Library, Google Ads Transparency, who advertises on a Google search, and landing pages.",
"author": {
"name": "HYPD AI",
"email": "support@hypd.ai",
"url": "https://www.hypd.ai"
},
"homepage": "https://www.hypd.ai",
"keywords": [
"ad-library",
"competitor-research",
"advertising",
"marketing"
],
"extensions": {
"com.openai": {
"interface": {
"displayName": "HYPD.AI Competitor Ads",
"shortDescription": "Research competitors' ads",
"longDescription": "HYPD.AI Competitor Ads helps marketers, agencies, ecommerce teams and creative strategists see the ads their competitors run, from public ad transparency data. No ad account needs to be connected.\n\nUse it to:\n\n\u2022 Find a brand's Facebook Page and list every ad it runs or has run on Facebook and Instagram, with the text, headline, call to action, media, platforms and run dates.\n\n\u2022 Search Facebook and Instagram ads by keyword across all advertisers, to see how a market advertises and to discover competitors.\n\n\u2022 Open one ad's full creative.\n\n\u2022 Find a brand's advertiser profile in Google's Ads Transparency Center and list the ads it runs on Search, YouTube, Shopping, Maps and Play.\n\n\u2022 See which advertisers show sponsored results on a Google search, and what their ads say.\n\n\u2022 Find the sites that compete with a domain in Google search, to decide whose ads to look at.\n\n\u2022 Take a screenshot of the landing page an ad sends people to.\n\n\u2022 Spot the offers, angles and formats that repeat, and the ads that have run longest.\n\nThe public libraries publish the ads themselves, where they ran and since when; they do not publish spend or impressions for commercial ads, and HYPD.AI never estimates them as if they were data. In the EU, EEA and UK, Meta adds its own reach and targeting fields.\n\nHYPD.AI only reads public data and does not create, change or report ads.\n\nHYPD.AI is an independent product and is not affiliated with or endorsed by Meta or Google. Meta, Facebook and Instagram are trademarks of Meta Platforms, Inc. Google, Google Ads and YouTube are trademarks of Google LLC.",
"developerName": "HYPD AI",
"category": "Data & Analytics",
"capabilities": [
"List the Facebook and Instagram ads a competitor runs",
"Search Facebook and Instagram ads by keyword across advertisers",
"List the text, image and video ads a competitor runs on Google",
"See who advertises on a Google search",
"Find a site's competitors in Google search",
"Screenshot a competitor's landing page"
],
"defaultPrompt": [
"Use $hypd-get-started to help me get started with HYPD.AI Competitor Ads."
],
"brandColor": "#C1983A",
"composerIcon": "./assets/composer-icon.png",
"logo": "./assets/directory-icon.png",
"websiteURL": "https://www.hypd.ai",
"supportURL": "https://www.hypd.ai/contact",
"privacyPolicyURL": "https://www.hypd.ai/privacy",
"termsOfServiceURL": "https://www.hypd.ai/terms"
},
"review": {
"test_cases": {
"positive": [
{
"description": "List a brand's Meta ads.",
"prompt": "What ads is Allbirds running on Facebook and Instagram in the United States right now?",
"tools_triggered": "init, adlib_meta_find_advertisers, adlib_meta_advertiser_ads",
"expected_behavior": "Resolve Allbirds to its Facebook Page, list its active ads in the US with their text, call to action and run dates, and say that spend and impressions are not published."
},
{
"description": "Search Meta ads by keyword.",
"prompt": "Find active Facebook ads in Germany that mention running shoes.",
"tools_triggered": "init, adlib_meta_search",
"expected_behavior": "Search with countries [\"DE\"] and ad_active_status active, and report the advertisers and creatives returned without inventing ads."
},
{
"description": "List a brand's Google ads.",
"prompt": "Show me the video ads Gymshark runs on Google in the United Kingdom.",
"tools_triggered": "init, adlib_google_find_advertisers, adlib_google_advertiser_ads",
"expected_behavior": "Resolve Gymshark to its advertiser and list its video ads for the UK market with their run dates, most recent first. Say that Google's transparency data carries no ad text and does not say on which Google property a video ran."
},
{
"description": "See who advertises on a search.",
"prompt": "Who is advertising on Google for 'project management software' in the United States, in English?",
"tools_triggered": "init, adlib_google_keyword_ads",
"expected_behavior": "Return the sponsored results for that search with each advertiser's domain and ad text, and say so when no ads were shown."
},
{
"description": "Find competitors and view a landing page.",
"prompt": "Which sites compete with allbirds.com in US search? Then take a screenshot of the homepage of the first direct competitor.",
"tools_triggered": "init, adlib_find_competitors, adlib_landing_page_screenshot",
"expected_behavior": "List the competing domains with their overlap figures as third-party estimates, leaving out allbirds.com itself and general platforms such as YouTube, Reddit or Amazon. Then screenshot the first remaining domain's homepage and describe what it shows."
}
],
"negative": [
{
"description": "Do not estimate unpublished spend as data.",
"prompt": "How much does Allbirds spend on Facebook ads each month?",
"expected_behavior": "Explain that the public libraries do not publish spend for commercial ads; it may show the ads and how long they have run, but must not present a spend figure as data."
},
{
"description": "Do not create or change ads.",
"prompt": "Create a Facebook ad that copies Allbirds' best ad and publish it.",
"expected_behavior": "Do not invoke tools as if they created anything. Explain that the plugin only reads public ad libraries and cannot create or publish ads."
},
{
"description": "Do not use the plugin for unrelated communications or scheduling.",
"prompt": "Email my colleague and add a meeting to my calendar tomorrow.",
"expected_behavior": "Do not invoke this plugin for email or calendar operations; these capabilities are outside its surface."
}
]
},
"commerce": false,
"commerce_description": "Provides read-only research on public advertising data; does not sell products, accept payments or complete purchases."
},
"publication": {
"release_notes": "Competitor lists leave out large platforms, Google ad results come one ad per row, and landing page screenshots show the first screen unless the whole page is asked for."
},
"onboardingSkill": "./skills/hypd-get-started/SKILL.md",
"apps": "./.app.json"
}
}
}
SHA-256: 0fca555afa8e9b728150ad39d705acec1a374fdaa861b4219ff404bc900ada8c