plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "klar",
  "description": "Read-only access to Klar ecommerce reports: revenue and profit, marketing performance, attribution, and influencer performance for the shops your Klar login can access.",
  "author": {
    "name": "Klar",
    "url": "https://www.getklar.com"
  },
  "homepage": "https://www.getklar.com",
  "keywords": [
    "klar",
    "ecommerce",
    "analytics",
    "attribution",
    "contribution-margin",
    "marketing-performance",
    "roas",
    "shopify"
  ],
  "version": "1.0.0",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Klar",
        "shortDescription": "Ecommerce profit and ad data",
        "longDescription": "Klar connects your ecommerce store, marketing channels and costs in one place. This plugin lets you ask questions about that data in plain language and get answers from your own Klar reports.\n\nWhat you can do:\n- Revenue and profit: gross and net revenue, orders, AOV and contribution margin by product, channel, customer type, payment method, shipping country, discount code, UTM fields, period or custom categories. Filter by new or returning customers and by order or customer tags.\n- Marketing performance: ad spend, ROAS, CAC, CPO, sessions, clicks, impressions and conversion rate by channel, campaign, country or period.\n- Attribution: compare how orders, revenue, new customers and margin attribute to touchpoints under last touch, first touch, data-driven, linear, U-shape or time decay models, with a lookback window you choose.\n- Influencer performance: costs, attributed orders and revenue, ROAS, CAC, CPM and cost per follower by influencer, campaign, platform or discount code.\n- List the shops your login can access and switch between them.\n\nWho it is for: ecommerce founders, marketers, performance and finance teams who already use Klar.\n\nLimitations: requires an existing Klar account. Access is read-only, so nothing in your Klar account can be created, changed or deleted. You only see shops and data your own Klar user is permitted to see. Attribution reports require the attribution feature on your Klar plan.",
        "developerName": "Klar",
        "category": "Data & Analytics",
        "capabilities": [
          "Read revenue and profit reports",
          "Read marketing performance reports",
          "Read attribution reports",
          "Read influencer performance reports",
          "List accessible shops",
          "Read report schemas",
          "Switch Klar accounts"
        ],
        "websiteURL": "https://www.getklar.com",
        "supportURL": "https://help.getklar.com",
        "privacyPolicyURL": "https://legal-docs.getklar.com/privacy-policy-platform.en.html",
        "termsOfServiceURL": "https://legal-docs.getklar.com/terms-and-conditions.en.html",
        "defaultPrompt": [
          "What was our net revenue and contribution margin by product last month?",
          "Show ad spend and orders by channel for the last two weeks.",
          "Which influencers drove the most new customers last quarter, and at what CAC?"
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "brandColor": "#3C327F"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Top products by revenue and contribution margin",
              "prompt": "In Klar's Ad Account & Influencer Store, what were the top 10 products by revenue last month, with net revenue and contribution margin?",
              "tools_triggered": "query_revenue_and_profit",
              "expected_behavior": "Reports on 2026-09-01 to 2026-09-30 for the Impersonate account. Lists the top 10 of 94 products, led by Sleeveless Knit Vest (net revenue 2,473,306.06, CM2 1,773,490.91), Longline Trench Coat (940,712.27 / 560,524.97) and Cuffed Selvedge Jeans (748,916.16 / 453,539.18). Notes that one order can contain several products, so product rows overlap and should be used for ranking, not summed."
            },
            {
              "description": "Ad spend and orders by channel",
              "prompt": "In Klar's Ad Account & Influencer Store, show ad spend and orders by marketing channel for the last two weeks.",
              "tools_triggered": "query_marketing_flex",
              "expected_behavior": "Reports on 2026-09-17 to 2026-09-30 with total spend of 1,043,464.18 across 18 channels. Top spend: Meta Paid 485,970.32 (778 orders), Influencer - Sheet Data v2.0 330,135.84, Google Generic Paid Search 101,059.76 (5,577 orders), Influencer - Sheet Data 66,530.46, TikTok Paid 35,146.68. Shows the shop's currency as returned, without assuming a symbol."
            },
            {
              "description": "Attribution model comparison",
              "prompt": "In Klar's Ad Account & Influencer Store, how do channels compare under first-touch versus last-touch attribution last month?",
              "tools_triggered": "query_attribution_deep_dive",
              "expected_behavior": "Reports on 2026-09-01 to 2026-09-30 with 216,080 attributed orders under both models. First touch credits Referral most (87,265 orders, net revenue 4,130,681.30), then Google Generic Paid Search and Meta Paid. Last touch credits Influencer - Sheet Data v2.0 most (152,958 orders, 7,226,116.97), then Referral (22,151). Names both models and explains that the same orders are split differently."
            },
            {
              "description": "Influencer performance",
              "prompt": "In Klar's Ad Account & Influencer Store, which influencers drove the most new customers last quarter, and at what CAC?",
              "tools_triggered": "query_influencer_flex",
              "expected_behavior": "Reports on 2026-07-01 to 2026-09-30, ranking 548 influencers by new customers. Top: elanhelo (263,556 new customers, CAC 7.09), gloria.glumac / gloriaschwesinger (10,827, CAC 11.08), hanna_wol (7,533, CAC 11.01). Overall: 324,623 new customers at CAC 13.67."
            },
            {
              "description": "List accessible shops",
              "prompt": "Which Klar shops can you see?",
              "tools_triggered": "list_shops",
              "expected_behavior": "Lists the 14 demo shops in the Impersonate account, including Klar's Ad Account & Influencer Store, Klar's German Based Business, Klar's UK Based Business and Klar's Switzerland Based Business. Shows no shops outside that account."
            }
          ],
          "negative": [
            {
              "description": "Write action not supported",
              "prompt": "Change the COGS of my best-selling product to 12 euros in Klar."
            },
            {
              "description": "Unrelated request",
              "prompt": "What's the weather in Berlin tomorrow?"
            },
            {
              "description": "Data outside the connected account",
              "prompt": "Show me the revenue of a competitor's Shopify store."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It only reads analytics data from the user's existing Klar account.",
        "demo_recording_url": "https://www.loom.com/share/a976325dc4cd4816a8ecfd2713386a01"
      },
      "publication": {
        "release_notes": "Initial release of the Klar plugin. Read-only access to Klar revenue and profit, marketing performance, attribution and influencer performance reports, plus listing accessible shops, reading report schemas and switching Klar accounts."
      },
      "apps": "./.app.json"
    }
  }
}