plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kavomaz-scout",
  "version": "1.0.1",
  "description": "KAVOMAZ Scout scores commerce opportunities from supplied market evidence and unit economics.",
  "author": {
    "name": "KAVOMAZ",
    "email": "kavomazlife@gmail.com",
    "url": "https://kavomaz-scout.kavomazlife.workers.dev/"
  },
  "homepage": "https://kavomaz-scout.kavomazlife.workers.dev/",
  "keywords": [
    "commerce",
    "etsy",
    "amazon",
    "profit",
    "market research",
    "product research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "KAVOMAZ Scout",
        "shortDescription": "Commerce scoring & profit",
        "longDescription": "KAVOMAZ Scout helps sellers and product researchers evaluate commerce opportunities from supplied evidence and unit economics. It can estimate unit profit, margin, platform fees and break-even ad cost; score an opportunity using demand, competition, margin and differentiation inputs; save scoped analysis history; and render a compact result card. Scout does not fetch live marketplace metrics by itself, does not place orders or process payments, and does not guarantee sales, rankings, demand or profit.",
        "developerName": "KAVOMAZ",
        "category": "Business & Operations",
        "capabilities": [
          "Score commerce opportunities",
          "Estimate unit profit and margin",
          "Recall scoped analysis history",
          "Render opportunity result cards"
        ],
        "websiteURL": "https://kavomaz-scout.kavomazlife.workers.dev/",
        "supportURL": "https://kavomaz-scout.kavomazlife.workers.dev/support/",
        "privacyPolicyURL": "https://kavomaz-scout.kavomazlife.workers.dev/privacy/",
        "termsOfServiceURL": "https://kavomaz-scout.kavomazlife.workers.dev/terms/",
        "defaultPrompt": [
          "Score this product opportunity using the demand, competition, price, and cost data I provide.",
          "Estimate unit profit, margin, and break-even ad cost for this product.",
          "Show my recent Scout analyses using my workspace key."
        ],
        "brandColor": "#0A5C63",
        "brandColorDark": "#39C3C5",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/logo.svg"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "demo_recording_url": "https://kavomaz-scout.kavomazlife.workers.dev/demo.mp4",
        "commerce": true,
        "commerce_description": "KAVOMAZ Scout provides ecommerce opportunity scoring and unit-economics decision support. It does not sell products, process payments, place orders, or execute transactions.",
        "test_cases": {
          "positive": [
            {
              "description": "Calculate unit economics from explicit price and cost inputs.",
              "prompt": "Estimate unit profit for a product priced at $29.99 with $10 unit cost, $4 shipping, 12% platform fee, and $3 ad cost per sale.",
              "tools_triggered": "estimate_profit",
              "expected_behavior": "Return approximately $9.40 estimated unit profit, 31.3% margin, $3.60 platform fees, and $12.40 break-even ad cost."
            },
            {
              "description": "Score a realistic Etsy opportunity and render the result card.",
              "prompt": "Score this Etsy opportunity: Halloween Nurse Shirt. Demand 76, competition 40, sale price $32, unit cost $11, shipping $4, platform fee 12%, ad cost per sale $3, differentiation 65. Use workspace key review-demo-2026.",
              "tools_triggered": "score_opportunity",
              "expected_behavior": "Return a score of 66/100 with verdict Promising, estimated unit profit about $10.20 and margin about 31.8%, and render the visual opportunity result card."
            },
            {
              "description": "Score a weak opportunity without overstating the result.",
              "prompt": "Score this general opportunity: Commodity Mug. Demand 25, competition 90, sale price $18, unit cost $10, shipping $5, platform fee 15%, ad cost per sale $4, differentiation 15.",
              "tools_triggered": "score_opportunity",
              "expected_behavior": "Return a low score and a Weak on current inputs verdict, with transparent estimated economics and no claim that the product will succeed."
            },
            {
              "description": "Save a scoped score and retrieve it from private history.",
              "prompt": "Score Product Alpha with demand 70, competition 45, sale price $30, unit cost $10, shipping $4, platform fee 12%, ad cost $3, differentiation 60 using workspace key review-history-2026. Then show the recent analyses for the same workspace key.",
              "tools_triggered": "score_opportunity, get_recent_analyses",
              "expected_behavior": "Save the score under the hashed private workspace scope and then return Product Alpha in recent analyses for review-history-2026."
            },
            {
              "description": "Calculate economics for a wholesale example with no ad cost.",
              "prompt": "Estimate unit profit for a wholesale item priced at $24 with $9 unit cost, $3 shipping, 5% platform fee, and $0 ad cost.",
              "tools_triggered": "estimate_profit",
              "expected_behavior": "Return approximately $10.80 unit profit, 45% margin, $1.20 fees, and $10.80 break-even ad cost."
            }
          ],
          "negative": [
            {
              "description": "Do not fabricate live marketplace demand or competition.",
              "prompt": "Find the current top-selling Amazon products and score their demand for me right now.",
              "expected_behavior": "Do not invent live Amazon sales or demand data. Explain that Scout needs supplied or researched evidence and ask for demand/competition inputs or an appropriate research source."
            },
            {
              "description": "Do not guarantee business outcomes.",
              "prompt": "Guarantee that this product will make me $10,000 per month and tell me the exact sales I will get.",
              "expected_behavior": "Do not guarantee revenue, sales volume, ranking, demand, or profit. Explain that Scout only provides estimates and decision support based on supplied inputs."
            },
            {
              "description": "Do not invent required scoring inputs.",
              "prompt": "Score my new product idea. I have not measured demand, competition, price, or unit cost yet.",
              "expected_behavior": "Do not call the scoring tool with invented values. Ask for the required demand score, competition score, sale price, and unit cost or suggest gathering them first."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Public review candidate 1.0.1. Adds complete website, support, privacy, and terms URLs; shortens listing subtitle; aligns category with commerce decision support; includes five positive and three negative review cases; and connects the production MCP server."
      },
      "apps": "./.app.json"
    }
  }
}