plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "didyouseo",
  "version": "1.0.0",
  "description": "SEO audits, Google Search Console and GA4 insights, keyword and backlink data from DidYouSEO.",
  "author": {
    "name": "DidYouSEO",
    "email": "hello@didyouseo.com",
    "url": "https://didyouseo.com"
  },
  "homepage": "https://didyouseo.com/mcp-server",
  "repository": "https://github.com/Sathish27/didyouseo-mcp",
  "license": "MIT",
  "keywords": [
    "seo",
    "seo audit",
    "search console",
    "google analytics",
    "keywords",
    "backlinks"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "DidYouSEO",
        "shortDescription": "SEO audits and Search Console",
        "longDescription": "DidYouSEO helps website owners, marketers and SEO consultants find and fix SEO problems using their real data.\n\nWhat you can do:\n- Audit any public page: get a score out of 100 and a ranked list of issues, each with how to fix it.\n- Check meta tags, robots.txt, structured data, Open Graph, hreflang and how a page looks in Google results.\n- Run PageSpeed Insights and see Core Web Vitals.\n- See your Google Search Console queries, the queries gaining or losing clicks, and pages competing for the same keyword.\n- See your Google Analytics organic traffic, engagement, conversions and visits from AI assistants.\n- Look up search volume, keyword difficulty, keyword ideas and the backlink strength of any domain.\n\nLimitations: you sign in with a DidYouSEO account. Search Console and Google Analytics data appear only after you connect them, read-only, on didyouseo.com. Keyword and backlink lookups use DidYouSEO AI credits from your account. Audits check one page at a time and only public pages; DidYouSEO never changes anything on the sites it checks.",
        "developerName": "DidYouSEO",
        "category": "Business & Operations",
        "websiteURL": "https://didyouseo.com",
        "supportURL": "https://didyouseo.com/contact",
        "privacyPolicyURL": "https://didyouseo.com/privacy",
        "termsOfServiceURL": "https://didyouseo.com/terms",
        "defaultPrompt": [
          "Run an SEO audit on my homepage and tell me what to fix first.",
          "Which of my Search Console queries rank on page 2 and could reach page 1?",
          "How much organic traffic did my site get this month compared with last month?"
        ],
        "brandColor": "#10B981",
        "brandColorDark": "#10B981",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Audit a public page and explain the results.",
              "prompt": "Run an SEO audit on https://didyouseo.com",
              "tools_triggered": "run_seo_audit",
              "expected_behavior": "Returns a score out of 100, counts of critical, warning and passed checks, and each issue with how to fix it."
            },
            {
              "description": "Inspect a page's meta tags.",
              "prompt": "Check the meta tags on https://didyouseo.com",
              "tools_triggered": "analyze_meta_tags",
              "expected_behavior": "Lists the title, meta description, robots, canonical and Open Graph tags, and flags missing or too-long values."
            },
            {
              "description": "Read the user's real Search Console queries (demo account has Search Console connected).",
              "prompt": "Show my top Search Console queries for https://didyouseo.com",
              "tools_triggered": "get_search_console_keywords",
              "expected_behavior": "Returns real queries with clicks, impressions, CTR and average position."
            },
            {
              "description": "Read the user's GA4 organic traffic (demo account has GA4 connected).",
              "prompt": "Show my GA4 organic traffic for https://didyouseo.com",
              "tools_triggered": "get_ga4_organic_traffic",
              "expected_behavior": "Returns organic sessions, engagement rate, key events and top organic landing pages for the last 28 days compared with the 28 days before, plus visits from AI assistants."
            },
            {
              "description": "Look up keyword search volume and difficulty (demo account is on a paid plan with credits).",
              "prompt": "Get search volume and difficulty for \"seo audit tool\" and \"free seo checker\"",
              "tools_triggered": "get_keyword_data",
              "expected_behavior": "Returns monthly search volume, keyword difficulty (0-100), cost per click and search intent for each keyword."
            }
          ],
          "negative": [
            {
              "description": "Refuses to fetch private or internal addresses. Expected: run_seo_audit returns an error that the URL is not allowed, and no request is made to the address.",
              "prompt": "Run an SEO audit on http://localhost:3000"
            },
            {
              "description": "Does not delete account data: DidYouSEO has no delete tool. Expected: the assistant explains it cannot remove sites and points to the DidYouSEO dashboard.",
              "prompt": "Delete didyouseo.com from my DidYouSEO account"
            },
            {
              "description": "Not an SEO request, so DidYouSEO tools should not be called. Expected: no DidYouSEO tool is triggered.",
              "prompt": "Book me a flight from London to Paris next Friday"
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/h0Py3gX9yKc"
      },
      "publication": {
        "release_notes": "First release: SEO audits, page checks (meta tags, robots.txt, structured data, Open Graph, hreflang, SERP preview, Core Web Vitals, PageSpeed Insights), Google Search Console and GA4 reports, and keyword and backlink lookups."
      },
      "apps": "./.app.json"
    }
  }
}