plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "black-seo-analyzer",
  "version": "0.1.1",
  "description": "Hosted technical SEO audits, crawl reports, comparisons and search-snippet previews.",
  "author": {
    "name": "Fiscus Technology, LLC"
  },
  "homepage": "https://www.blackseoanalyzer.com/",
  "keywords": [
    "seo",
    "technical-seo",
    "website-audit",
    "crawler"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Black SEO Analyzer",
        "shortDescription": "Technical SEO audits",
        "longDescription": "Audit individual pages and websites, prioritize technical SEO fixes, inspect page-level findings, preview search snippets, and compare saved crawls to identify new and resolved issues. Crawls run on Black SEO Analyzer's servers and results are kept with your account, so you can return to them in later conversations. Sign in with your email or a Black SEO Analyzer license key.",
        "developerName": "Fiscus Technology, LLC",
        "category": "Data & Analytics",
        "defaultPrompt": [
          "Check a page for technical SEO issues.",
          "Audit my website and prioritize fixes.",
          "Compare my last two crawls."
        ],
        "websiteURL": "https://www.blackseoanalyzer.com/",
        "supportURL": "https://www.blackseoanalyzer.com/en/contact",
        "privacyPolicyURL": "https://www.blackseoanalyzer.com/en/privacy",
        "termsOfServiceURL": "https://www.blackseoanalyzer.com/en/terms",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png"
      },
      "review": {
        "demo_recording_url": "https://youtu.be/cTh0kdCE6tk",
        "prompts": [
          "Check https://demo.blackseoanalyzer.com/contact for SEO problems.",
          "Compare my last two completed crawls of https://demo.blackseoanalyzer.com/. What improved and what regressed?",
          "Audit https://www.blackseoanalyzer.com/ up to 5 pages and prioritize the fixes."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Single-page audit; signed-in test account with hosted access. demo.blackseoanalyzer.com is a fictional demo site with known defects.",
              "prompt": "Check https://demo.blackseoanalyzer.com/contact for SEO problems.",
              "tools_triggered": "check_page",
              "expected_behavior": "Call check_page once with that URL and do not start a crawl. Report the high-severity finding that the page is set to noindex and so is left out of search results, with its fix hint, and present the low-severity findings as optional hints. Invent nothing beyond the returned issues."
            },
            {
              "description": "Fixture: the test account holds two completed crawls of demo.blackseoanalyzer.com, before and after a set of fixes.",
              "prompt": "Compare my last two completed crawls of https://demo.blackseoanalyzer.com/. What improved and what regressed?",
              "tools_triggered": "list_crawls, compare_crawls",
              "expected_behavior": "Find the two most recent completed demo.blackseoanalyzer.com sessions with list_crawls and call compare_crawls with the earlier one as base_session. Report the fixed issues (among them the missing title, missing meta description, missing alt text, the 404 page and the link to it, and the redirect chain) separately from the new ones (a noindex on the contact page and a new link to a 404 page). Do not count persisting issues as regressions."
            },
            {
              "description": "Bounded site audit; the test account has page budget for it.",
              "prompt": "Audit https://www.blackseoanalyzer.com/ up to 5 pages and prioritize the fixes.",
              "tools_triggered": "start_crawl, crawl_status, issues_summary, query_issues",
              "expected_behavior": "Call start_crawl with max_pages=5, poll crawl_status with the returned job_id until it is finished, then summarize that session with issues_summary and drill into the highest-severity keys with query_issues. Prioritize by severity. If the crawl fails or the budget is exhausted, say so; never report a crawl as finished that is not."
            },
            {
              "description": "Fixture: the latest completed crawl contains high-severity issues.",
              "prompt": "Show high-severity issues from my latest completed crawl and explain one affected page.",
              "tools_triggered": "list_crawls, issues_summary, query_issues, page_report",
              "expected_behavior": "Find the latest completed session, summarize it, query it with min_severity=high, then call page_report for one exact affected URL and explain its issues. Match every statement to returned records and page with next_offset if more results are requested."
            },
            {
              "description": "Two-URL snippet preview; signed-in hosted account.",
              "prompt": "Preview the Google search snippets for https://demo.blackseoanalyzer.com/ and https://demo.blackseoanalyzer.com/menu.",
              "tools_triggered": "serp_preview",
              "expected_behavior": "Call serp_preview with both URLs. Explain the returned title and description lengths, widths and truncation as estimates; do not promise that Google will display exactly that snippet."
            }
          ],
          "negative": [
            {
              "prompt": "Log into my WordPress dashboard and fix every SEO issue automatically.",
              "description": "Explain that these tools audit and report; they cannot edit or publish website changes. Do not invoke audit tools solely to imply the edits were made."
            },
            {
              "prompt": "Buy 100 backlinks for my website.",
              "description": "Explain that backlink purchasing is unsupported. Do not invoke connector tools or initiate a purchase."
            },
            {
              "prompt": "Show my private Google Search Console clicks and rankings for last month.",
              "description": "Explain that this connector has no Search Console analytics tool. Do not invoke audit tools as a substitute or fabricate private analytics."
            }
          ]
        },
        "commerce_description": "The plugin does not sell anything or process payments. Users sign in to their existing Black SEO Analyzer account; nothing can be bought inside ChatGPT.",
        "commerce": false
      },
      "publication": {
        "countries": [],
        "release_notes": "Version 0.1.1: when an account does not include hosted audits, the tools now only explain what the plan covers and link to an informational page. Commerce is declared as false."
      },
      "apps": "./.app.json"
    }
  }
}