plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hypd-keywordresearch",
  "version": "1.0.11",
  "description": "Research keywords, compare available metrics and forecast ad traffic for paid search campaigns.",
  "author": {
    "name": "HYPD AI",
    "email": "support@hypd.ai",
    "url": "https://www.hypd.ai"
  },
  "homepage": "https://www.hypd.ai",
  "keywords": [
    "keyword research",
    "keyword planner",
    "google keyword planner",
    "google ads keyword planner",
    "google adwords keyword planner",
    "keyword research tool",
    "seo keywords",
    "seo keyword research",
    "keyword search tool",
    "keyword ideas",
    "keyword suggestions",
    "keyword finder",
    "keyword explorer",
    "keyword tool",
    "google keyword tool",
    "google keywords",
    "keyword generator",
    "keyword lookup",
    "keyword analysis",
    "search volume",
    "keyword search volume",
    "keyword volume checker",
    "cpc",
    "cost per click",
    "high cpc keywords",
    "keyword competition",
    "top of page bid",
    "bid estimates",
    "keyword trends",
    "search trends",
    "keyword forecast",
    "traffic forecast",
    "ad forecast",
    "click forecast",
    "google ads cost estimator",
    "ppc keywords",
    "ppc keyword research",
    "google ads keywords",
    "paid search",
    "ppc",
    "sem",
    "long tail keywords",
    "international keyword research",
    "google ads keyword research",
    "keyword list",
    "keyword data",
    "related keywords",
    "keyword stats",
    "keyword metrics",
    "google keyword planner alternative",
    "keyword planner alternative",
    "keyword checker",
    "google keyword checker",
    "keyword planner tool",
    "google keyword planner tool",
    "keyword ideas generator",
    "keyword checker tool",
    "keyword checker tools",
    "keyword suggestion tool",
    "keyword suggestions tool",
    "keyword research tools",
    "keyword tools",
    "cpc checker",
    "google ads cpc",
    "search volume checker",
    "keyword search tools",
    "google keyword tools",
    "keyword planner tools",
    "keyword suggestion tools",
    "keyword generators",
    "keyword idea",
    "seo keyword",
    "keyword planners",
    "google keyword planners",
    "search volumes"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Keyword Research by HYPD AI",
        "shortDescription": "Find Keywords for Paid Search",
        "longDescription": "Research keywords, compare available metrics and forecast ad traffic for paid search campaigns.\n\nA HYPD sign-in is required. A Google Ads Connection is optional: with a connected, active Google Ads account, ideas and volumes come from Google Keyword Planner, and without one they come from DataForSEO. Forecasts use DataForSEO. Data availability depends on account permissions and market coverage.\n\nWhat you can do:\n\nFind keyword ideas: Start with one or more seed keywords and get related keyword suggestions with available metrics.\n\nGet search volumes: Review monthly search volume, CPC, competition, top-of-page bid ranges and available 12-month trends for up to 500 keywords at once.\n\nForecast ad traffic: Estimate impressions, clicks, CTR, average CPC and cost for your keywords using a selected maximum CPC bid and match type.\n\nResearch individual countries and languages to explore local markets. Sort results by volume, competition or bids, and navigate large keyword sets using pagination.\n\nHYPD is an independent product and is not affiliated with or endorsed by Google. Google Ads and Keyword Planner are trademarks of Google LLC.",
        "developerName": "HYPD AI",
        "category": "Data & Analytics",
        "capabilities": [
          "Find keyword ideas from up to 15 seed keywords",
          "Get search volume, CPC, competition and 12-month trends for up to 500 keywords",
          "Forecast impressions, clicks, CTR and cost for a max CPC bid and match type",
          "Look up supported countries and languages",
          "Page and re-sort stored results without a new lookup"
        ],
        "defaultPrompt": [
          "Find running-shoe keywords for the US market in English.",
          "Compare demand for running, marathon and trail shoes in the US market in English.",
          "Forecast clicks and cost for running shoes in the US market in English using exact match and a $1.50 CPC."
        ],
        "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",
        "brandColor": "#C1983A"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use the bundled workflow and discover accepted country and language names.",
              "prompt": "Show which countries and languages keyword research supports, and explain the lookup and paging rules.",
              "tools_triggered": "keyword_locations_and_languages",
              "expected_behavior": "Use the packaged research-keywords skill to explain tool choice, the required HYPD sign-in, that a Google Ads Connection is optional, metered fresh calls, free stored-result paging and 24-hour expiration. Return actual supported country and language names from the static reference tool without spending a fresh lookup. No initialization tool is needed."
            },
            {
              "description": "Expand supported keyword seeds into market ideas.",
              "prompt": "Find related keyword ideas for running shoes and marathon shoes in the United States in English, sorted by search volume.",
              "tools_triggered": "keyword_locations_and_languages, keyword_find_ideas",
              "expected_behavior": "Check the exact supported country and language names, then make one fresh seed lookup using at most 15 seeds and order_by search_volume. Show actual ideas and available metrics, preserving any returned currency, result_id and paging context. A HYPD sign-in is required; a Google Ads Connection is not, and the backend chooses Keyword Planner or DataForSEO. Report account, permission, provider or quota errors without inventing estimates."
            },
            {
              "description": "Batch search-volume and trend research.",
              "prompt": "For running shoes, marathon shoes and trail running shoes, show search volumes, CPCs, competition and available monthly trends in the United States in English.",
              "tools_triggered": "keyword_locations_and_languages, keyword_search_volume",
              "expected_behavior": "Batch the three keywords into one fresh call, using the exact supported market names. Present actual available volume, CPC, competition, bid and trend data, preserve units/currency and explain missing estimates. This consumes one fresh lookup; do not call once per keyword."
            },
            {
              "description": "Forecast traffic at an explicit USD bid.",
              "prompt": "Forecast next month for running shoes and marathon shoes in the United States in English, with exact match and a maximum CPC of USD 1.50.",
              "tools_triggered": "keyword_locations_and_languages, keyword_ad_forecast",
              "expected_behavior": "Use max_cpc 1.5, match_type exact and forecast_window next_month in one fresh call. Present returned impressions, clicks, CTR, average CPC and cost in USD as DataForSEO estimates. Do not describe them as existing campaign metrics or promise conversions."
            },
            {
              "description": "Re-sort and page a previously returned idea result.",
              "prompt": "Using the still-valid keyword ideas result from earlier in this conversation, re-sort it by competition index and show page 1 with five rows; do not run a new lookup.",
              "tools_triggered": "keyword_find_ideas",
              "expected_behavior": "Use an actual keyword_find_ideas result_id from positive case 2 within 24 hours, page 1, page_size 5 and order_by competition_index. Reuse the stored data with no additional fresh-lookup quota. If no valid result exists, request the earlier result or explain expiration; never fabricate an ID. This case depends on case 2 and should run in that conversation."
            }
          ],
          "negative": [
            {
              "description": "Do not modify advertising Accounts.",
              "prompt": "Add these keywords to my Google Ads campaign and increase its bids by 20 percent.",
              "expected_behavior": "Do not invoke keyword research tools to make changes. Explain that this surface provides research and forecasts, not campaign or bid management."
            },
            {
              "description": "Do not promise unrelated SEO rank tracking.",
              "prompt": "Show my exact current organic ranking positions and backlinks for every keyword in Germany.",
              "expected_behavior": "Do not use market estimates as ranking or backlink evidence. Explain that this surface has no organic rank-tracking or backlink tools."
            },
            {
              "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, and do not request recipient, message or meeting details as though the plugin could complete them. Explain that both capabilities are outside this plugin's surface."
            }
          ]
        },
        "demo_recording_url": "https://screen.studio/share/t0Bu7EEv",
        "commerce": false,
        "commerce_description": "Provides research or read-only advertising analysis; does not sell products, accept payments or complete purchases."
      },
      "publication": {
        "release_notes": "Renames the plugin to Keyword Research by HYPD AI and adds the brand color."
      },
      "onboardingSkill": "./skills/research-keywords/SKILL.md",
      "apps": "./.app.json"
    }
  }
}