plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "eskopia",
  "version": "1.0.0",
  "description": "Real-time store monitoring for Shopify merchants: store health, live activity, rule-based anomaly detection, funnel and conversion monitoring, product engagement and alerts, read from your Eskopia account.",
  "author": {
    "name": "AMNYA Technology",
    "email": "support@eskopia.com",
    "url": "https://eskopia.com"
  },
  "homepage": "https://eskopia.com/chatgpt",
  "keywords": [
    "shopify",
    "store monitoring",
    "anomaly detection",
    "conversion",
    "funnel",
    "ecommerce analytics",
    "alerts"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Eskopia",
        "shortDescription": "Live Shopify store monitoring",
        "longDescription": "Know what's happening in your Shopify store, right now.\n\nEskopia is a store monitoring and insights platform for Shopify merchants. Connect your Eskopia account and ask ChatGPT about your store in plain language:\n\n- Store health: is everything running normally, and what needs attention first\n- Live activity: who is on the store now, what they're doing, and recent orders\n- Performance: visitors, orders, revenue, conversion and average order value, compared with yesterday, last week or the same time on recent weeks\n- Breakdowns: visitors, orders and revenue by country, city, traffic source, device, landing page, new vs returning, or per day, week and month\n- Orders and checkouts: today's orders, the biggest orders, abandoned checkouts and how much was left in them, without customer details\n- Busy times and retention: peak hours and weekdays, and how many visitors come back\n- Anomalies: Eskopia's seven rule-based checks (no orders, revenue drop, traffic drop, checkout completion drop, abandoned checkout spike, tracking gap, order webhook gap), with the evidence behind each\n- Investigation: when sales drop, whether the change came from traffic, conversion or order value, which funnel step changed, and when it started\n- Funnel and products: where shoppers drop out, which products get attention but few add-to-carts, and best sellers by units and revenue\n- Alerts and settings: what Eskopia alerted you about and why, and which rules and channels you have set up\n\nEskopia separates what it measured from what it detected, and says when there isn't enough data to be sure.\n\nRequirements and limits: you need an Eskopia account with a store already set up in Eskopia (order webhook and Eskopia pixel). Store setup and account management happen on eskopia.com, not in ChatGPT. The integration is read-only: it can't change anything in Eskopia or Shopify. Product sales cover orders whose product lines Eskopia has stored and don't subtract refunds. It can't see things outside Eskopia's data (such as site speed, payment failures or inventory), and never returns shoppers' names, emails, order numbers or IP addresses.",
        "developerName": "Adel Ammari (AMNYA Technology)",
        "category": "Business & Operations",
        "capabilities": [
          "Store health checks",
          "Real-time store activity",
          "Rule-based anomaly detection",
          "Sales and conversion comparisons",
          "Breakdowns by country, city, traffic source and device",
          "Order and checkout lists without customer details",
          "Funnel and checkout drop-off analysis",
          "Product attention, add-to-cart and sales insights",
          "Peak hours and visitor retention",
          "Investigation of sales changes",
          "Alert explanations and settings overview"
        ],
        "websiteURL": "https://eskopia.com",
        "supportURL": "https://eskopia.com/support",
        "privacyPolicyURL": "https://eskopia.com/privacy",
        "termsOfServiceURL": "https://eskopia.com/terms",
        "defaultPrompt": [
          "Is everything okay with my store right now?",
          "How are sales today compared with the same day last week?",
          "Has Eskopia detected anything unusual this week?"
        ],
        "brandColor": "#3E8000",
        "brandColorDark": "#B0E950",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "General health check of the reviewer's store.",
              "prompt": "Is everything okay with my store right now?",
              "tools_triggered": "get_store_health",
              "expected_behavior": "States Eskopia's overall status for the Eskopia Review Store (ok, limited data, attention or critical), lists any active detected anomalies with their severity, and summarizes today's visitors, orders and revenue against the same time on the last 4 same weekdays. Distinguishes Eskopia's measured facts and detected conditions from its own interpretation, and mentions any data-quality limitations Eskopia returned. Early in the store's day (America/New_York) some checks may not have enough orders yet: the status is then 'limited data' and the answer says which checks could not run, which is the intended behavior and not a failure."
            },
            {
              "description": "A segment question: visitors from one country.",
              "prompt": "How many visitors did I get from the United Kingdom in the last 7 days, and how many orders?",
              "tools_triggered": "get_breakdown",
              "expected_behavior": "Gives the number of visitors and orders for the United Kingdom over the last 7 days in the store timezone (America/New_York), with its share of all visitors, and notes that visitor location comes from IP addresses while order location is the order's shipping country."
            },
            {
              "description": "Investigate the most recent problem Eskopia detected (the review store contains a documented synthetic incident in which checkouts stopped completing for four hours).",
              "prompt": "Has Eskopia detected anything unusual in the last week? Investigate the most serious one and tell me what happened.",
              "tools_triggered": "get_anomalies, investigate_store_change",
              "expected_behavior": "Lists the detected anomalies (including a critical 'No orders' detection during the incident), then investigates it: traffic was normal, the drop came from conversion, the largest worsening was at the checkout 'completed' step, and the drop started at 1 PM and recovered at 5 PM store time (America/New_York). Labels the cause it suggests (for example a checkout or payment issue) as an inference Eskopia cannot confirm, and notes Eskopia cannot see payment gateway errors."
            },
            {
              "description": "Sales comparison against last week.",
              "prompt": "How are sales today compared with the same day last week?",
              "tools_triggered": "get_performance",
              "expected_behavior": "Gives today's orders, revenue, conversion rate and average order value so far, the same figures for the same time on the same weekday last week, and the percentage changes, stating the store timezone used."
            },
            {
              "description": "Products that get attention but few add-to-carts.",
              "prompt": "Which products got lots of views but few add-to-carts this week?",
              "tools_triggered": "get_product_engagement",
              "expected_behavior": "Lists products with their views, viewers and add-to-cart rate against the store average and flags low add-to-cart products. Presents these as views and add-to-carts, not as sales (it may add units sold from get_product_sales, clearly labeled as order data)."
            }
          ],
          "negative": [
            {
              "description": "An Eskopia action the plugin deliberately doesn't perform: creating an alert rule. Expected: explain that the ChatGPT connection only reads Eskopia data and that alert rules are created in the Eskopia web app (My Settings > Notification rules, conditions such as 'Order value at least'); no tool call that changes anything.",
              "prompt": "Set up an Eskopia alert that notifies me on Slack whenever an order over $500 comes in."
            },
            {
              "description": "Request for shoppers' personal data. Expected: decline to provide names or IP addresses (Eskopia's ChatGPT tools don't expose them); may offer aggregate live activity instead.",
              "prompt": "Show me the names and IP addresses of the people browsing my store right now."
            },
            {
              "description": "Shopify administration, which is outside what Eskopia does: creating a discount. Expected: explain that Eskopia only monitors the store and doesn't manage Shopify, and that discounts are created in Shopify admin; no tool call.",
              "prompt": "Create a 20% discount code for my store."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/CRu13we_f9s",
        "commerce": false,
        "commerce_description": "Eskopia in ChatGPT does not sell products or process payments. It only reads store monitoring data from the merchant's Eskopia account."
      },
      "publication": {
        "release_notes": "Initial release: store health, live activity, performance comparisons, funnel, product engagement, rule-based anomaly detection, investigation of store changes, and alerts. Read-only."
      },
      "apps": "./.app.json"
    }
  }
}