plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "rankium",
  "version": "1.0.2",
  "description": "Understand and improve website visibility using connected search, analytics, market, directory, and technical data.",
  "author": {
    "name": "RepairFlow Inc.",
    "email": "help@rankium.io",
    "url": "https://rankium.io"
  },
  "homepage": "https://rankium.io",
  "keywords": [
    "visibility",
    "seo",
    "analytics",
    "search",
    "websites",
    "developers"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Rankium",
        "shortDescription": "Understand website visibility",
        "longDescription": "Rankium is a visibility intelligence platform for websites and online businesses. It lets users connect and inspect their own search, analytics, market, directory, backlink, and technical-site data from sources such as Google Search Console, Google Analytics 4, Bing Webmaster Tools, DataForSEO, Firecrawl, and optional visibility providers. Use Rankium to list accessible website projects and companies, read underlying provider measurements, review the Rankium Visibility Score, inspect evidence-grounded reports, action queues, prioritized visibility roadmaps, and directory coverage. Rankium preserves source-specific freshness and reporting semantics rather than treating first-party measurements and third-party estimates as interchangeable. Some refresh and scan operations may contact connected providers and consume Rankium plan quota; read-only tools use data already available to the authenticated Rankium account. Rankium does not publish or modify the user's website through these plugin tools.",
        "developerName": "RepairFlow Inc.",
        "category": "Data & Analytics",
        "capabilities": [
          "Read website visibility data",
          "Review search and analytics signals",
          "Inspect visibility scores and reports",
          "Prioritize visibility improvements",
          "Check directory coverage"
        ],
        "websiteURL": "https://rankium.io",
        "supportURL": "https://rankium.io/support.html",
        "privacyPolicyURL": "https://rankium.io/privacy-policy.html",
        "termsOfServiceURL": "https://rankium.io/terms-of-service.html",
        "defaultPrompt": [
          "How is my website performing across search and analytics?",
          "What are my biggest visibility gaps and what should I fix next?",
          "Show my current visibility score and highest-priority actions."
        ],
        "brandColor": "#0A1628",
        "brandColorDark": "#D4A857",
        "composerIcon": "./assets/composer-icon.svg",
        "logo": "./assets/logo.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the websites available to the connected reviewer account.",
              "prompt": "List my Rankium websites.",
              "tools_triggered": "list_projects",
              "expected_behavior": "Return only the website projects available to the authenticated Rankium reviewer account, including their project IDs so a follow-up tool can select one."
            },
            {
              "description": "Read underlying visibility measurements for an owned company.",
              "prompt": "Show the visibility data for my first Rankium company and summarize the major signals.",
              "tools_triggered": "list_companies, get_visibility_data",
              "expected_behavior": "Select a company owned by the authenticated account, return its available provider measurements and source freshness, and summarize them without blindly adding overlapping first-party and third-party estimates."
            },
            {
              "description": "Read the current Rankium Visibility Score for the authenticated account.",
              "prompt": "What is my current Rankium Visibility Score and what is driving it?",
              "tools_triggered": "get_rankium_score",
              "expected_behavior": "Return the latest available 0-100 Rankium Visibility Score, momentum if available, and the component breakdown for a company accessible to the authenticated account."
            },
            {
              "description": "Return a prioritized visibility roadmap from stored Rankium evidence.",
              "prompt": "What should I work on next to improve my visibility?",
              "tools_triggered": "get_visibility_roadmap",
              "expected_behavior": "Return a prioritized set of visibility recommendations for an accessible company, ordered by expected impact, without claiming that Rankium already changed the website."
            },
            {
              "description": "Read an evidence-grounded Rankium report for a selected website.",
              "prompt": "Give me the latest daily Rankium report for my first website.",
              "tools_triggered": "list_projects, get_agent_report",
              "expected_behavior": "Select an accessible website project and return its latest daily evidence-grounded report, including what changed, what it means, and any waiting actions or recommendations."
            }
          ],
          "negative": [
            {
              "description": "Unrelated coding request. Rankium should not activate because the request does not concern website visibility or Rankium data.",
              "prompt": "Write a Python function that sorts a list of integers."
            },
            {
              "description": "Unsupported website modification. Rankium can diagnose and recommend but these MCP tools should not publish changes to the user's website.",
              "prompt": "Change my website title tags and publish the changes for me."
            },
            {
              "description": "Unauthorized cross-account access. Rankium must not expose companies or measurements outside the authenticated user's access.",
              "prompt": "Show me the private Rankium visibility data for a company that belongs to another user's account."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/VTpUQ4aCLwQ"
      },
      "publication": {
        "release_notes": "Initial Rankium plugin release with authenticated website/project discovery, visibility data, visibility scoring, reports, action queues, roadmaps, refresh tools, and directory coverage."
      },
      "apps": "./.app.json"
    }
  }
}