plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "buildershq",
  "version": "1.0.1",
  "description": "Keyword volumes, Search Console, YouTube, Google Maps, app store and website traffic numbers for ChatGPT, from one MCP server.",
  "author": {
    "name": "Botmakers LLC",
    "email": "support@buildershq.net",
    "url": "https://buildershq.net"
  },
  "homepage": "https://buildershq.net",
  "keywords": [
    "seo",
    "keyword research",
    "search console",
    "youtube",
    "google maps",
    "app store",
    "analytics"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Builders HQ",
        "shortDescription": "Keyword, SEO and market data",
        "longDescription": "Builders HQ gives ChatGPT real marketing and growth numbers instead of guesses.\n\nWhat you can do\n- Keyword research: monthly search volumes, keyword ideas, competition and bid ranges from Google Ads Keyword Planner and Microsoft Advertising, for any country and language. Up to 1,000 keywords in one question.\n- Ad forecasts: expected clicks, average CPC and cost for a set of keywords at a bid and budget. Nothing is created or spent.\n- Your sites on Google and Bing: Search Console and Bing Webmaster Tools performance by query, page, country and date, URL Inspection, sitemaps and inbound links.\n- Faster indexing: tell Bing and the other IndexNow engines about changed pages, and submit sitemaps to Search Console and Bing.\n- YouTube: public numbers for any channel or video, search results, comments, and your own channels' YouTube Analytics.\n- Google Maps: places with ratings, review counts, contacts, opening hours and reviews.\n- App stores: search the App Store and Google Play, and check whether an app name and its domains are free.\n- Website traffic: Cloudflare and Vercel Web Analytics by page, country, referrer and device.\n\nGood to know\n- You sign in with Google. Keyword, YouTube, Google Maps and app store questions work right away.\n- To ask about your own sites, channels or traffic, connect Search Console, Bing Webmaster Tools, YouTube, Cloudflare, Vercel or IndexNow on your account page at buildershq.net. Your connections are encrypted and only used for your own questions, and you can disconnect them at any time.\n- Only five tools change anything (submitting URLs, adding or removing a sitemap, adding or removing a site), and only when you ask.\n\nWho it is for: founders, marketers, SEO specialists, YouTubers and app makers who want answers from their real data in the chat.",
        "developerName": "Botmakers LLC",
        "category": "Data & Analytics",
        "capabilities": [
          "Keyword volumes and ideas",
          "Ad clicks and cost forecasts",
          "Search Console and Bing reports",
          "YouTube and Google Maps research",
          "App name checks"
        ],
        "websiteURL": "https://buildershq.net",
        "supportURL": "https://buildershq.net/account",
        "privacyPolicyURL": "https://buildershq.net/privacy",
        "termsOfServiceURL": "https://buildershq.net/terms",
        "defaultPrompt": [
          "How many people in the US search for \"seo tools\", \"mcp server\" and \"google keyword planner\" each month?",
          "List the padel clubs in Miami with their rating and number of reviews.",
          "Is the app name Trailmix free on the App Store and Google Play?"
        ],
        "brandColor": "#1F6F4A",
        "brandColorDark": "#D7F76C",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Keyword search volumes, the main use. It reads Google Ads Keyword Planner through Builders HQ's own account, so it works on a new account with nothing connected. Each case can be run on its own, in a new chat.",
              "prompt": "How many people in the US search for \"seo tools\", \"mcp server\" and \"google keyword planner\" each month, and what is the top-of-page bid range?",
              "tools_triggered": "keyword_volume",
              "expected_behavior": "The assistant gives each keyword's average monthly searches in the United States (for example about 165,000 for \"seo tools\"), its competition level and its top-of-page bid range in USD, says the numbers come from Google Ads Keyword Planner, and changes nothing anywhere."
            },
            {
              "description": "New keyword ideas from a seed word, with a filter.",
              "prompt": "Find 15 keyword ideas for \"meal prep\" in the US with at least 1,000 monthly searches.",
              "tools_triggered": "keyword_ideas",
              "expected_behavior": "The assistant lists up to 15 related keywords (such as \"meal prep service\" or \"healthy meal prep\") with their monthly searches, competition and bid range, most searched first, all at or above 1,000 searches."
            },
            {
              "description": "A Google Ads forecast. It is the planner's forecast only: no campaign is created and nothing is spent.",
              "prompt": "Forecast clicks and cost for \"ai video editor\" and \"video editing app\" in the US at a $2 max CPC for the next 30 days.",
              "tools_triggered": "keyword_forecast",
              "expected_behavior": "The assistant gives the forecast clicks, average CPC and total cost for the period, says it is a Keyword Planner forecast for the keywords together, and states that nothing was created or spent."
            },
            {
              "description": "Places on Google Maps, for local market research.",
              "prompt": "List the padel clubs in Miami with their rating, number of reviews and address.",
              "tools_triggered": "search_places",
              "expected_behavior": "The assistant lists padel clubs in the Miami area as Google Maps shows them (for example Ultra Padel Club, 4.9 stars, about 940 reviews), each with its rating, review count and address."
            },
            {
              "description": "Is an app name free? It reads the App Store, Google Play and public domain registration data.",
              "prompt": "Is the app name Trailmix free on the App Store and Google Play? Check trailmix.com too.",
              "tools_triggered": "check_app_name",
              "expected_behavior": "The assistant gives a verdict for the name (for example \"used\": small App Store apps already go by it), names the apps that use it or similar names, and says whether trailmix.com is registered."
            }
          ],
          "negative": [
            {
              "description": "Another person's private data. Search Console, YouTube Analytics and traffic tools only read sites and channels the signed-in person connected themselves. The assistant should not call a tool to look up someone else's site performance, and should say it can only see the person's own connected sites.",
              "prompt": "Show me the Google Search Console clicks for nytimes.com for last month."
            },
            {
              "description": "Buying ads. Builders HQ forecasts and reads; it never creates campaigns, changes bids or spends money. The assistant should not call any tool to launch a campaign and should say that Builders HQ cannot run ads, offering a forecast instead.",
              "prompt": "Launch a Google Ads campaign for my bakery with a $50 daily budget."
            },
            {
              "description": "Personal information about private people. The tools answer about keywords, businesses on Maps, public channels and apps, not about individuals. The assistant should not use a tool to find a private person's address or phone number.",
              "prompt": "Find the home address and phone number of John Smith in Miami."
            }
          ]
        },
        "demo_recording_url": "https://buildershq.net/demo.mp4",
        "commerce": false,
        "commerce_description": "Builders HQ sells nothing in ChatGPT. It shows no prices, starts no purchase and links to no checkout or pricing page. Each account has daily limits; when one is reached the tools say so and stop there."
      },
      "publication": {
        "release_notes": "First release. Keyword volumes, ideas and forecasts; Search Console and Bing reports; IndexNow and sitemap submission; YouTube, Google Maps and app store research; Cloudflare and Vercel traffic."
      },
      "apps": "./.app.json"
    }
  }
}