plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "human-forward-findability",
  "version": "1.0.1",
  "description": "See how findable a brand is in search, in AI answers and to AI shopping agents, and what to fix.",
  "author": {
    "name": "Human Forward Ltd",
    "email": "hello@humanforward.io",
    "url": "https://humanforward.io"
  },
  "homepage": "https://app.humanforward.io/connect",
  "license": "UNLICENSED",
  "keywords": [
    "findability",
    "ai search",
    "geo",
    "agentic commerce",
    "shopify",
    "seo"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Human Forward Findability",
        "shortDescription": "How findable is your brand",
        "longDescription": "Findability scores how findable a brand is in search, in AI answers and to AI shopping agents, then tells you what to fix.\n\nConnected, your assistant can read the latest score out of 100, the to do list ordered by points with a ready made prompt for each fix, exactly what each of the seven AI answer engines said about the brand in each market, agent readiness (UCP, Storefront MCP, agent commerce channels, policies), the twelve questions shoppers ask in the category and who gets named instead, and the score history. It can also start a new check.\n\nWorks for Shopify stores through the Human Forward Shopify app and for any site through app.humanforward.io. Sign in with your site and the connect code shown under Settings in the app.",
        "developerName": "Human Forward Ltd",
        "category": "Data & Analytics",
        "capabilities": [
          "Read findability score",
          "Read fixes and prompts",
          "Read engine answers",
          "Read agent readiness",
          "Start a check"
        ],
        "websiteURL": "https://humanforward.io",
        "supportURL": "https://app.humanforward.io/connect",
        "privacyPolicyURL": "https://humanforward.io/privacy",
        "termsOfServiceURL": "https://humanforward.io/terms/apps",
        "defaultPrompt": [
          "How findable is my store?",
          "What should I fix first?",
          "Can AI shopping agents buy from my store?"
        ],
        "brandColor": "#E04500",
        "brandColorDark": "#FF4F00",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo.png",
        "screenshots": [
          "./assets/screenshot-1.png",
          "./assets/screenshot-2.png",
          "./assets/screenshot-3.png",
          "./assets/screenshot-4.png"
        ]
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read the latest findability score",
              "prompt": "How findable is my store?",
              "tools_triggered": "get_overview",
              "expected_behavior": "Returns the overview card: score out of 100, search and AI answer parts, agent readiness, sentiment and a verdict per engine for the connected account (humanforward.io)."
            },
            {
              "description": "Get the prioritised fixes",
              "prompt": "What should I fix first?",
              "tools_triggered": "get_todo",
              "expected_behavior": "Returns the to do list ordered by points, biggest win first, each with why it matters, effort and a ready made prompt."
            },
            {
              "description": "Read what an engine said",
              "prompt": "What did ChatGPT say about us?",
              "tools_triggered": "get_engine_answers",
              "expected_behavior": "Returns the five questions asked, ChatGPT's answers for the home market and the judge's notes on each."
            },
            {
              "description": "Check agent readiness",
              "prompt": "Can AI shopping agents buy from my store?",
              "tools_triggered": "get_agent_readiness",
              "expected_behavior": "Returns the agent readiness checks (UCP, Storefront MCP, Muse channel, policies) with pass, partial or fail and the fix for each."
            },
            {
              "description": "Start a fresh check",
              "prompt": "Run a fresh findability check.",
              "tools_triggered": "run_check, get_overview",
              "expected_behavior": "Starts a new check, says it takes one to three minutes, then polls get_overview until status is done and shows the new score."
            }
          ],
          "negative": [
            {
              "description": "Billing is not handled in chat",
              "prompt": "Upgrade me to the Scale plan and charge my card."
            },
            {
              "description": "No changes to the store itself",
              "prompt": "Change my product prices to beat the competitors you found."
            },
            {
              "description": "Only the connected account's sites",
              "prompt": "Show me the findability score for nike.com."
            }
          ]
        },
        "demo_recording_url": "https://storage.googleapis.com/hf-findability-public/review/findability-screencast.mp4",
        "commerce": false,
        "commerce_description": "No purchases or payments happen in the assistant. Account plans are managed on app.humanforward.io or in Shopify."
      },
      "publication": {
        "countries": [],
        "release_notes": "First release. Findability score, prioritised fixes with prompts, engine answers by market, agent readiness, shopper questions, score history, and starting a check."
      },
      "apps": "./.app.json"
    }
  }
}