.codex-plugin/plugin.json

{
  "author": {
    "name": "Epinium"
  },
  "description": "Ask about your ecommerce business and act on the answer, from your own data, without exporting a spreadsheet.\n\nEpinium connects your Amazon Seller Central, Vendor Central and Amazon Ads accounts, plus your Shopify and WooCommerce stores.\n\n\u2022 Performance: spend, sales, ACOS, ROAS, clicks and impressions per campaign, ad group, target, product ad and shopper search term. Seller Central sessions, Buy Box share, conversion, Best Seller Rank, Amazon fees and margin before ads. Vendor Central figures reported separately, the way the two models actually work.\n\n\u2022 Catalog: one product that merges the Seller Central, Vendor Central and Advertising views of the same ASIN, with brands and keyword clusters you can create and edit.\n\n\u2022 Advertising management: create Sponsored Products campaigns, ad groups, keywords, product targets, negatives and product ads; change bids, budgets and states one by one or in bulk; manage portfolios. Every change sent to Amazon is logged with Amazon's answer, so you can see what was applied and what was rejected.\n\n\u2022 Automations: start from Epinium's workflow templates, validate them and estimate their cost, run them on demand or as a simulation, and audit what each run decided, with version history and restore. New workflows are created paused.\n\n\u2022 Tasks: review the suggestions Epinium prepares for your products and campaigns, approve or reject them, and apply the approved ones.\n\n\u2022 Shopify: read your catalog, inventory, collections, pages and blog content live from your store. With your permission, create and edit products, variants, prices, collections, inventory, translations, images and SEO content, and publish to sales channels. Recent orders and ShopifyQL analytics are available when your store's app has Shopify's protected customer data access. Orders, customers, themes and shipping are never changed.\n\n\u2022 WooCommerce: read products, variations, categories, tags, brands, attributes and sales reports. With your permission, create, edit or trash them. Orders, customers and coupons are not accessed.\n\n\u2022 Store safeguards: Epinium reads your store live and keeps no copy, withholds customers' personal data, and logs every change it makes so you can review it for 12 months. Changes apply to your store as soon as you ask for them.\n\n\u2022 Playbooks: validated marketing playbooks for bidding, search-term harvesting, negatives, budgets, listings and the Buy Box, read before advising.\n\nReading needs only the read permissions you grant when you connect. The first time you ask for a change, ChatGPT asks you to approve the extra permission for that kind of change. Nothing changes unless you ask for it, and archiving in Amazon Ads cannot be undone.\n\nRequires an Epinium account with at least one Amazon, Shopify or WooCommerce connection. Agencies can work across all their client accounts.",
  "interface": {
    "capabilities": [
      "Analyze Amazon Ads performance by campaign, ad group, target and search term",
      "Change bids, budgets and states, one by one or in bulk",
      "Create Sponsored Products campaigns, ad groups, keywords and negatives",
      "Read Seller Central and Vendor Central sales, traffic, fees and margin",
      "Run, simulate and audit bid-optimization automations",
      "Review, approve and apply Epinium task suggestions",
      "Read and edit your Shopify catalog, inventory, collections and SEO content",
      "Read and edit your WooCommerce products, categories and attributes",
      "Read Shopify and WooCommerce sales reports",
      "Manage keyword clusters"
    ],
    "category": "Data & Analytics",
    "defaultPrompt": [
      "Which campaigns had the worst ACOS last month?",
      "Lower bids 15% on keywords with spend and no orders in the last 30 days.",
      "Which products get traffic but don't convert?"
    ],
    "developerName": "Epinium",
    "displayName": "Epinium",
    "longDescription": "Ask about your ecommerce business and act on the answer, from your own data, without exporting a spreadsheet.\n\nEpinium connects your Amazon Seller Central, Vendor Central and Amazon Ads accounts, plus your Shopify and WooCommerce stores.\n\n\u2022 Performance: spend, sales, ACOS, ROAS, clicks and impressions per campaign, ad group, target, product ad and shopper search term. Seller Central sessions, Buy Box share, conversion, Best Seller Rank, Amazon fees and margin before ads. Vendor Central figures reported separately, the way the two models actually work.\n\n\u2022 Catalog: one product that merges the Seller Central, Vendor Central and Advertising views of the same ASIN, with brands and keyword clusters you can create and edit.\n\n\u2022 Advertising management: create Sponsored Products campaigns, ad groups, keywords, product targets, negatives and product ads; change bids, budgets and states one by one or in bulk; manage portfolios. Every change sent to Amazon is logged with Amazon's answer, so you can see what was applied and what was rejected.\n\n\u2022 Automations: start from Epinium's workflow templates, validate them and estimate their cost, run them on demand or as a simulation, and audit what each run decided, with version history and restore. New workflows are created paused.\n\n\u2022 Tasks: review the suggestions Epinium prepares for your products and campaigns, approve or reject them, and apply the approved ones.\n\n\u2022 Shopify: read your catalog, inventory, collections, pages and blog content live from your store. With your permission, create and edit products, variants, prices, collections, inventory, translations, images and SEO content, and publish to sales channels. Recent orders and ShopifyQL analytics are available when your store's app has Shopify's protected customer data access. Orders, customers, themes and shipping are never changed.\n\n\u2022 WooCommerce: read products, variations, categories, tags, brands, attributes and sales reports. With your permission, create, edit or trash them. Orders, customers and coupons are not accessed.\n\n\u2022 Store safeguards: Epinium reads your store live and keeps no copy, withholds customers' personal data, and logs every change it makes so you can review it for 12 months. Changes apply to your store as soon as you ask for them.\n\n\u2022 Playbooks: validated marketing playbooks for bidding, search-term harvesting, negatives, budgets, listings and the Buy Box, read before advising.\n\nReading needs only the read permissions you grant when you connect. The first time you ask for a change, ChatGPT asks you to approve the extra permission for that kind of change. Nothing changes unless you ask for it, and archiving in Amazon Ads cannot be undone.\n\nRequires an Epinium account with at least one Amazon, Shopify or WooCommerce connection. Agencies can work across all their client accounts.",
    "privacyPolicyURL": "https://epinium.com/en/epinium-terms-of-use-privacy-policy/",
    "shortDescription": "Amazon, Shopify & WooCommerce",
    "supportURL": "https://help.epinium.com/",
    "termsOfServiceURL": "https://epinium.com/en/terms-of-service/",
    "websiteURL": "https://epinium.com",
    "logo": "./assets/icon.png",
    "composerIcon": "./assets/icon.png"
  },
  "name": "app-6a9a96187ca88191bce99bd6784e917c",
  "version": "1.1.0",
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "release_notes": "Adds Shopify and WooCommerce stores: read your catalog and sales reports live and, with your permission, edit products, prices, inventory and content. Adds Amazon Ads actions: change bids, budgets and states, create Sponsored Products campaigns, and manage automations, tasks and keyword clusters. Reading still needs only read permissions; the first change asks you to approve the matching write permission. Agencies can now pick which client account to work on."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Advertising performance analysis (read). Uses one metrics call grouped by campaign instead of paging through rows.",
              "prompt": "Which Sponsored Products campaigns had the highest ACOS last month? Show spend, sales and ACOS.",
              "tools_triggered": "epinium_whoami, epinium_list_campaign_metrics",
              "expected_behavior": "Returns the campaigns of the account ranked by ACOS for last month, with spend, sales and ACOS for each, using one metrics call grouped by campaign."
            },
            {
              "description": "Wasted spend on shopper search terms (read).",
              "prompt": "Which customer search terms spent money in the last 30 days without a single order?",
              "tools_triggered": "epinium_list_search_term_metrics",
              "expected_behavior": "Lists the search terms with spend and zero orders in the last 30 days, sorted by spend, with the campaign each one belongs to."
            },
            {
              "description": "Budget change on Amazon Ads (write). Please run write cases only in the Camaba Europa ad account: it is a test account whose ads do not serve. The other ad accounts in Epinium Demo are live, so use them for reading only.",
              "prompt": "In the Camaba Europa ad account, set the daily budget of the campaign \"Test Based Campaign_1741339100249 - Validation\" to 6 EUR.",
              "tools_triggered": "epinium_list_campaigns, epinium_update_campaign",
              "expected_behavior": "Finds the campaign, shows its current daily budget and the new one (6.00 EUR) and asks the user to confirm. If the connection lacks the write permission, ChatGPT asks to approve it first. After confirmation it applies the change and reports that Amazon accepted it. The campaign is paused, so nothing is served."
            },
            {
              "description": "Create an automation from a template (write). New workflows are always created paused, so nothing runs until the user turns it on.",
              "prompt": "Set up a bid-optimization automation for my account from one of Epinium's templates, but leave it paused.",
              "tools_triggered": "epinium_list_workflow_templates, epinium_instantiate_workflow_template",
              "expected_behavior": "Lists the available templates, creates a workflow from the bid-optimization one and confirms that it was created paused, so nothing runs until the user turns it on."
            },
            {
              "description": "Conversion analysis from Seller Central (read).",
              "prompt": "Which of my products get the most sessions but the lowest conversion rate this month?",
              "tools_triggered": "epinium_list_seller_product_metrics",
              "expected_behavior": "Returns the products with the most sessions and the lowest unit session percentage for the current month, with sessions, orders and conversion rate."
            }
          ],
          "negative": [
            {
              "description": "Unrelated general request: the plugin should not be called.",
              "prompt": "Write a short poem about the sea."
            },
            {
              "description": "Another marketplace's account that is not connected to Epinium: the plugin should not be called, or should say that eBay is not supported.",
              "prompt": "Show me my eBay sales for last week."
            },
            {
              "description": "General knowledge question that needs no account data: the plugin should not be called.",
              "prompt": "In general terms, how does the Amazon Sponsored Products auction work?"
            }
          ]
        }
      }
    }
  },
  "apps": "./.app.json"
}