.codex-plugin/plugin.json

{
  "author": {
    "name": "Adzviser LLC"
  },
  "description": "Connect your Shopify store data to ChatGPT with Adzviser. Ask questions in plain language to track sales, see what's selling, and understand how your store is performing over time.\n\nCompare gross sales, returns, discounts, shipping, and taxes across date ranges. Break results down by product, SKU, order, or customer. Turn your store data into clear reports, spot trends, and see which products and periods are driving revenue.",
  "interface": {
    "capabilities": [],
    "category": "Data & Analytics",
    "defaultPrompt": [
      "How much revenue did my Shopify store make last week?",
      "Generate a monthly Shopify sales report covering the last 3 months",
      "Show me my top selling Shopify products for the last 14 days"
    ],
    "developerName": "Adzviser LLC",
    "displayName": "Adzviser Shopify",
    "longDescription": "Connect your Shopify store data to ChatGPT with Adzviser. Ask questions in plain language to track sales, see what's selling, and understand how your store is performing over time.\n\nCompare gross sales, returns, discounts, shipping, and taxes across date ranges. Break results down by product, SKU, order, or customer. Turn your store data into clear reports, spot trends, and see which products and periods are driving revenue.",
    "privacyPolicyURL": "https://docs.adzviser.com/privacy",
    "shortDescription": "Talk to your sales data",
    "supportURL": "https://adzviser.com/contact-us",
    "termsOfServiceURL": "https://docs.adzviser.com/terms",
    "websiteURL": "https://adzviser.com",
    "logo": "./assets/adzviser-directory-light.png",
    "composerIcon": "./assets/adzviser-directory-light.png"
  },
  "name": "app-6aa0684226208191b41f6cf373ea6cce",
  "skills": "./skills",
  "version": "1.0.0",
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "countries": [],
        "release_notes": "Explore your Shopify sales and orders. Find top-selling products, compare sales channels and monthly performance, and review daily sales trends."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Shopify connection. Resolve relative dates from the review date. Check monthly total sales and order count while preserving currency and adjustments. Demo includes currency-unspecified rows, which must be disclosed.",
              "prompt": "What were our Shopify total sales and order count last month in Demo?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_shopify, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact Shopify field names, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.shopify_request. Do not invoke preview widgets or set_reporting_mode. Read the Shopify data header and all returned rows. Request metrics=[Total sales, Orders], breakdowns=[Currency], one inclusive date range for the previous complete calendar month, and no time_granularity. Report the exact dates, returned Total sales and Orders. Do not substitute Gross sales or Net sales or add returned component columns to Total sales again. Preserve negative adjustments. Keep each known currency separate. Treat null, blank or literal None currency as unspecified; show those amounts separately without guessing their currency, silently discarding them, or combining them into a currency-labelled total. Flag that missing currency limits a complete store-wide monetary total. "
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Shopify connection. Resolve relative dates from the review date. Check product grouping and ranking by reported item count. Demo includes an unidentified product group, which must be shown separately.",
              "prompt": "Which five Shopify products had the most items sold last month in Demo?",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_shopify, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact Shopify field names, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.shopify_request. Do not invoke preview widgets or set_reporting_mode. Read the Shopify data header and all returned rows. Request metrics=[Items], breakdowns=[Product ID, Product title], and the previous complete calendar month. Group by Product ID and rank identifiable products by returned Items descending; break equal-count ties by product title then ID or clearly explain ties. Show up to five identifiable products and their reported item counts. Label missing product IDs/titles as an unidentified group and report its item count separately, without inventing a name or silently dropping it. Do not request customer fields, sales amounts, arbitrary sort or limit arguments, or confuse Items with Orders."
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Shopify connection. Resolve relative dates from the review date. Check a sales-channel breakdown, preserving unknown channels and currency. Verify additive totals against the returned channel rows only.",
              "prompt": "Show our Shopify total sales and orders by sales channel last month in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_shopify, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact Shopify field names, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.shopify_request. Do not invoke preview widgets or set_reporting_mode. Read the Shopify data header and all returned rows. Request metrics=[Total sales, Orders], breakdowns=[Channel, Currency], and the previous complete calendar month. Show every returned channel/currency group, including an unknown-channel group when Channel is missing or None. Do not relabel it Online Store. Calculate any totals from the returned rows and preserve negative adjustments. Keep each known currency separate. Treat null, blank or literal None currency as unspecified; show those amounts separately without guessing their currency, silently discarding them, or combining them into a currency-labelled total. Flag that missing currency limits a complete store-wide monetary total. "
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Shopify connection. Resolve relative dates from the review date. Check two complete calendar months and calculate the net-sales change without confusing net and total sales.",
              "prompt": "Compare our Shopify net sales last month with the month before in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_shopify, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact Shopify field names, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.shopify_request. Do not invoke preview widgets or set_reporting_mode. Read the Shopify data header and all returned rows. Request metrics=[Net sales], breakdowns=[Currency], separate inclusive date_ranges for the previous complete calendar month and the month before it, and no time_granularity. Report both dates and Net sales, then calculate recent minus earlier and (recent minus earlier)/earlier*100 for each known currency with a valid positive baseline. State when a zero or negative baseline makes the percentage unavailable or misleading. Do not substitute Total sales or recalculate deductions twice. Keep each known currency separate. Treat null, blank or literal None currency as unspecified; show those amounts separately without guessing their currency, silently discarding them, or combining them into a currency-labelled total. Flag that missing currency limits a complete store-wide monetary total. "
            },
            {
              "description": "Use a fresh Data Mode conversation with access to Demo and its Shopify connection. Resolve relative dates from the review date. Check daily time grouping over the previous complete week. Allow the report to complete; do not issue identical duplicate queries while waiting.",
              "prompt": "Show our daily Shopify total sales and orders last week in Demo.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_shopify, retrieve_reporting_data",
              "expected_behavior": "Select workspace_name=Demo, discover exact Shopify field names, and call retrieve_reporting_data with only the necessary report fields and assorted_requests.shopify_request. Do not invoke preview widgets or set_reporting_mode. Read the Shopify data header and all returned rows. Request metrics=[Total sales, Orders], breakdowns=[Currency], time_granularity=Date, and the inclusive previous complete Monday-Sunday week unless otherwise specified. Show dates and daily figures, keeping separate currency groups for each day. Any weekly totals must equal the returned daily rows within each currency group. Do not add Date to breakdowns, fabricate zero rows for absent days, or ignore negative adjustments. Keep each known currency separate. Treat null, blank or literal None currency as unspecified; show those amounts separately without guessing their currency, silently discarding them, or combining them into a currency-labelled total. Flag that missing currency limits a complete store-wide monetary total. "
            }
          ],
          "negative": [
            {
              "description": "Refunds and order cancellation are unsupported. Explain that the plugin retrieves reports and cannot issue refunds or cancel orders. Do not invoke reporting/preview/preference tools to simulate the write or claim that money was refunded.",
              "prompt": "Refund Shopify order #1001 in Demo and cancel the order now."
            },
            {
              "description": "Product deletion and inventory changes are unsupported. Explain the limitation without requesting customer data, calling reporting tools as a substitute, or claiming that products were deleted.",
              "prompt": "Delete every out-of-stock product from the Shopify store in Demo."
            },
            {
              "description": "Sending marketing messages is unsupported. Explain that this plugin cannot send emails or run campaigns. Do not fetch customer email addresses, invoke report/preview tools for the unsupported send, or claim any message was delivered.",
              "prompt": "Email a 20% discount offer to every Shopify customer in Demo right now."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/eHS1xu8Rhfc",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website. This plugin provides Shopify reporting and analysis; it does not offer purchases, checkout or refunds inside the plugin."
      }
    }
  },
  "apps": "./.app.json"
}