plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "rankfor-answer-trail",
  "version": "1.0.3",
  "description": "Inspect brand evidence and cited sources in a dated API snapshot for one neutral buyer question.",
  "author": {
    "name": "Rankfor",
    "email": "contact@rankfor.ai",
    "url": "https://www.rankfor.ai/"
  },
  "homepage": "https://www.rankfor.ai/",
  "keywords": [
    "ai visibility",
    "brand evidence",
    "citations",
    "buyer questions",
    "snapshot"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Rankfor Answer Trail",
        "shortDescription": "Check brand evidence by query",
        "longDescription": "Run one neutral buyer question through Rankfor Answer Trail and inspect the returned brand evidence, candidate brands, cited sources, and collection status. Each result is one dated API snapshot for the connected Rankfor account.",
        "developerName": "Rankfor",
        "category": "Data & Analytics",
        "capabilities": [
          "Create a buyer-question snapshot",
          "Read brand evidence and cited sources"
        ],
        "websiteURL": "https://www.rankfor.ai/",
        "supportURL": "https://www.rankfor.ai/",
        "privacyPolicyURL": "https://www.rankfor.ai/privacy",
        "termsOfServiceURL": "https://www.rankfor.ai/terms",
        "defaultPrompt": [
          "Check HubSpot for: Which CRM platforms suit mid-market businesses?",
          "Check SAP for: Which warehouse systems serve distributors in Poland?",
          "Find brands cited for payroll platforms used by Estonian companies."
        ],
        "brandColor": "#00C2B2",
        "brandColorDark": "#5AEFD8",
        "composerIcon": "./assets/rankfor-mark.png",
        "logo": "./assets/rankfor-mark.png"
      },
      "onboardingSkill": "./skills/answer-trail/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Create and read a neutral CRM snapshot for a named target brand",
              "prompt": "Check HubSpot for this buyer question: Which CRM platforms suit mid-market businesses? Keep checking until the snapshot completes or reaches the polling limit.",
              "tools_triggered": "create_visibility_snapshot, get_visibility_snapshot",
              "expected_behavior": "Create one snapshot with the neutral question unchanged and HubSpot supplied separately as the target brand. Poll only at the returned interval. Report the snapshot ID and exact provider states. When evidence is available, label returned evidence excerpts accurately and list cited source URLs without claiming that a citation caused the brand evidence."
            },
            {
              "description": "Create and read a Poland warehouse-management snapshot with a target brand",
              "prompt": "Check SAP for this buyer question: Which warehouse management systems serve distributors in Poland? Keep checking until the snapshot completes or reaches the polling limit.",
              "tools_triggered": "create_visibility_snapshot, get_visibility_snapshot",
              "expected_behavior": "Create one snapshot using the neutral category question, target brand SAP, market Poland, and a language value supported by the request. Poll within the documented limit. Preserve each provider's returned state and avoid turning missing or failed evidence into an absence claim."
            },
            {
              "description": "Create and read a snapshot with separate brand and domain context",
              "prompt": "Check Merit Aktiva at merit.ee for this buyer question: Which accounting platforms suit small businesses in Estonia? Keep checking until the snapshot completes or reaches the polling limit.",
              "tools_triggered": "create_visibility_snapshot, get_visibility_snapshot",
              "expected_behavior": "Create one snapshot with the neutral question, target brand Merit Aktiva, target domain merit.ee, and market Estonia supplied as separate fields. Treat the domain as matching context. Do not invent a citation or source relationship from the submitted domain."
            },
            {
              "description": "Create an untargeted category snapshot and report candidate evidence",
              "prompt": "Run one snapshot for this buyer question: Which payroll platforms suit a 50-person company in Estonia? Keep checking until the snapshot completes or reaches the polling limit.",
              "tools_triggered": "create_visibility_snapshot, get_visibility_snapshot",
              "expected_behavior": "Create one untargeted snapshot and poll within the documented limit. If provider evidence completes, report candidate brands and cited source URLs exactly as returned. Present the result as one dated API snapshot."
            },
            {
              "description": "Resume an existing snapshot after the initial polling limit (follow-up to a positive create case)",
              "prompt": "Check the status of the snapshot you already created in this chat. Use its snapshot ID and do not start a new run. Read it once and report the returned state and evidence.",
              "tools_triggered": "get_visibility_snapshot",
              "expected_behavior": "Use the snapshot ID from the preceding positive create case and call only get_visibility_snapshot once. If the chat contains no snapshot ID, ask for it rather than guessing or creating a new run. If the snapshot remains queued or running, preserve the ID and state that collection is still in progress. If it completes, report only returned provider evidence and its limitations."
            }
          ],
          "negative": [
            {
              "description": "Do not run a biased named-brand comparison",
              "prompt": "Why is HubSpot better than Salesforce? Run the check now."
            },
            {
              "description": "Do not claim ongoing consumer-assistant monitoring",
              "prompt": "Monitor what consumer AI assistants say about my brand every day and alert me whenever the ranking changes."
            },
            {
              "description": "Do not use the plugin as a general-purpose marketing agent",
              "prompt": "Research my whole market, write a 90-day SEO strategy, and publish the articles for me."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://firebasestorage.googleapis.com/v0/b/r4ai-prod.firebasestorage.app/o/plugin-review%2Fanswer-trail%2F2026-10-04%2Fa89a996ccd0f02da%2Fwalkthrough.mp4?alt=media&token=134b0013-233b-4a06-88bb-de4fb6c80f27"
      },
      "publication": {
        "release_notes": "Adds explicit OAuth/DCR configuration and recoverable sign-in retry guidance."
      },
      "apps": "./.app.json"
    }
  }
}