plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "seo-gets",
  "version": "2.0.3",
  "description": "Ask questions about connected Google Search Console and GA4 properties, investigate SEO performance, and turn the findings into reports and action plans.",
  "homepage": "https://app.seogets.com",
  "keywords": [
    "SEO",
    "Google Search Console",
    "GA4",
    "analytics",
    "search performance"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SEO Gets",
        "shortDescription": "SEO insights from GSC & GA4",
        "longDescription": "Connect ChatGPT to SEO Gets to explore Google Search Console and GA4 data across one or more properties. Ask about performance trends, pages, queries, date ranges, indexing status, and errors. SEO Gets can also use your content groups, topic clusters, and brand keyword filters to create reports and practical action plans.",
        "developerName": "SEO Gets",
        "category": "Data & Analytics",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://app.seogets.com",
        "supportURL": "https://seogets.com/help",
        "privacyPolicyURL": "https://seogets.com/privacy",
        "termsOfServiceURL": "https://seogets.com/terms",
        "defaultPrompt": [
          "Compare organic search performance across my connected properties for the last 28 days.",
          "Which pages and queries gained or lost the most clicks this month?",
          "Check indexing status and errors for my connected properties."
        ],
        "brandColor": "#165DFF",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/logo.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List available sites. Discovery and the baseline read call. Verifies the MCP connection and auth work.",
              "prompt": "Which sites do I have in SEO Gets?",
              "tools_triggered": "list_sites",
              "expected_behavior": "A list of the GSC properties available to the user, including the test site, with no auth or empty-result errors. The assistant presents them readably and doesn't invent sites."
            },
            {
              "description": "Site performance for a date range. Core analytics retrieval with a time window and metric aggregation.",
              "prompt": "How did example.com perform in the last 28 days compared to the previous 28 days? Show clicks, impressions, CTR, and average position.",
              "tools_triggered": "get_site_performance",
              "expected_behavior": "Clicks, impressions, CTR, and average position for both periods, with the change in each. The figures match what the SEO Gets UI shows for the same dates, and the date ranges are the ones the user requested."
            },
            {
              "description": "Topic clusters. Retrieval of user-defined segmentation data.",
              "prompt": "Show me the topic clusters I've set up for example.com.",
              "tools_triggered": "list_topic_clusters",
              "expected_behavior": "All existing clusters for the site with their names and definitions. If the site has none, an explicit empty state rather than fabricated clusters."
            },
            {
              "description": "Indexing health overview. Technical SEO check using aggregated page-level indexing data.",
              "prompt": "Give me an indexing overview for example.com. How many pages are indexed, and what are the main reasons pages aren't?",
              "tools_triggered": "get_indexing_overview",
              "expected_behavior": "The total page count and a breakdown by indexing status or coverage state, including the reasons for non-indexed pages. The numbers are internally consistent (the breakdown sums to the total)."
            },
            {
              "description": "Create a site annotation (write action). Write operation that records a site change for later correlation with performance.",
              "prompt": "Add an annotation to example.com for today: 'Published new pricing page and updated internal links'.",
              "tools_triggered": "create_site_annotation",
              "expected_behavior": "Confirmation that the annotation was created, with today's date and the exact text provided. A follow-up check (for example, viewing it in the UI) shows it saved correctly. Because this is a write action, clean up afterward with delete_site_annotation."
            }
          ],
          "negative": [
            {
              "description": "Site not in the account. The user asks for data on a domain that isn't connected to their SEO Gets account. The MCP should return a clear \"not found\" or no-access error, and the assistant should not make up metrics.",
              "prompt": "How many clicks did notmysite-example.org get in the last 28 days?"
            },
            {
              "description": "Invalid or impossible date range. The user requests a period outside the available data window (the tool covers roughly the last 16 months) or one that is logically invalid, such as an end date before the start date. The MCP should reject it or return no data, and the assistant should explain the limitation instead of returning fabricated figures.",
              "prompt": "Show me performance for example.com from March 2020 to January 2021."
            },
            {
              "description": "Request outside the MCP's capabilities. The user asks for something the available tools don't support, such as making changes to the actual website or Google Search Console settings. No tool should be triggered, and the assistant should say it can't do this instead of attempting a workaround or implying it succeeded.",
              "prompt": "Submit example.com's sitemap to Google Search Console and request indexing for my 10 newest pages."
            }
          ]
        }
      },
      "apps": "./.app.json"
    }
  }
}