plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "v-marketing-kit",
  "version": "1.23.4",
  "description": "V-Kit (v-marketing-kit \u00b7 Marketing Kit): your ad, app and subscription numbers \u2014 Meta Ads, Facebook Pages, Instagram, TikTok Ads, Apple Ads, Google Ads, GA4, Search Console, Google Play, AppsFlyer, RevenueCat, App Store Connect and the public App Store \u2014 in ChatGPT.",
  "author": {
    "name": "VALAS O\u00dc \u2013 podru\u017enica v Sloveniji",
    "email": "connect@valas.team",
    "url": "https://marketing-kit.app"
  },
  "homepage": "https://marketing-kit.app",
  "repository": "https://github.com/arey325/marketing-kit-plugin",
  "license": "MIT",
  "keywords": [
    "marketing",
    "advertising",
    "analytics",
    "meta-ads",
    "tiktok-ads",
    "apple-ads",
    "google-ads",
    "ga4",
    "search-console",
    "google-play",
    "appsflyer",
    "revenuecat",
    "app-store-connect",
    "app-store",
    "instagram"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "V-Kit",
        "shortDescription": "Your ad and app metrics",
        "longDescription": "V-Kit (Marketing Kit) answers questions about your own marketing numbers in plain words. Connect your accounts once on marketing-kit.app \u2014 Meta Ads, Facebook Pages, Instagram, TikTok Ads, Apple Ads, Google Ads, Google Analytics 4, Search Console, Google Play, AppsFlyer, RevenueCat and App Store Connect \u2014 and ask: spend and CPI by campaign, Apple Ads search terms and impression share, users and events, search queries and positions, Google Play installs, sales and reviews, installs by media source, MRR, trials and churn, downloads and proceeds, App Store ratings and reviews.\n\nV-Kit reads data only from the accounts you connect, with the permissions you grant; it does not change campaigns, budgets or ads. Every operation is a separate tool with its own input schema. Two actions write, and both show a dry run first and run only after your explicit confirmation in words that name the action and the object: copying AppsFlyer partner-integration settings, and turning on App Store Connect Analytics Reports. Large tables come back as a summary with CSV and JSON download links valid for 24 hours, available only to you.\n\nAPI keys for AppsFlyer, RevenueCat and App Store Connect are entered on marketing-kit.app/connections, never in the chat.\n\nLimitations: organic TikTok is not covered; data freshness follows each platform's API.",
        "developerName": "VALAS O\u00dc \u2013 podru\u017enica v Sloveniji",
        "category": "Data & Analytics",
        "capabilities": [
          "Read Meta Ads performance",
          "Read Facebook Pages and Instagram insights",
          "Read TikTok Ads reports",
          "Read Apple Ads campaigns, keywords, search terms and impression share",
          "Read Google Ads reports",
          "Read Google Analytics 4 reports",
          "Read Search Console performance",
          "Read Google Play installs, sales, reviews and vitals",
          "Read AppsFlyer attribution reports",
          "Read RevenueCat subscription metrics",
          "Read App Store Connect sales, subscriptions, analytics and reviews",
          "Read public App Store data",
          "Copy AppsFlyer integration settings after confirmation",
          "Turn on App Store Connect Analytics Reports after confirmation"
        ],
        "websiteURL": "https://marketing-kit.app",
        "supportURL": "https://marketing-kit.app/support",
        "privacyPolicyURL": "https://marketing-kit.app/privacy.html",
        "termsOfServiceURL": "https://marketing-kit.app/terms.html",
        "defaultPrompt": [
          "Check my V-Kit connections",
          "How much did we spend on Meta ads last week, by campaign?",
          "GA4 active users and conversions yesterday"
        ],
        "brandColor": "#2563EB",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "The signed-in account and its sources: the public App Store is ready, the other sources are not connected yet, with the link to marketing-kit.app/connections.",
              "prompt": "Check my V-Kit connections",
              "tools_triggered": "mk_status",
              "expected_behavior": "The signed-in account and its sources: the public App Store is ready, the other sources are not connected yet, with the link to marketing-kit.app/connections."
            },
            {
              "description": "The app's name, average rating with the number of ratings, and the current version with its release date.",
              "prompt": "What is the current rating and the latest version of the app 1627714743 in the US App Store?",
              "tools_triggered": "mk_apple_lookup",
              "expected_behavior": "The app's name, average rating with the number of ratings, and the current version with its release date."
            },
            {
              "description": "The most recent written reviews Apple returns for the US store, newest first, each with date, rating, title and text. The store currently has only a few written reviews, so fewer than five can come back \u2014 that is the real data, not an error.",
              "prompt": "Show the latest reviews of the app 1627714743 in the US App Store",
              "tools_triggered": "mk_apple_reviews",
              "expected_behavior": "The most recent written reviews Apple returns for the US store, newest first, each with date, rating, title and text. The store currently has only a few written reviews, so fewer than five can come back \u2014 that is the real data, not an error."
            },
            {
              "description": "A ranked list of ten free apps with their names, as of today, for the US store.",
              "prompt": "What are the top 10 free apps in the US App Store right now?",
              "tools_triggered": "mk_apple_charts",
              "expected_behavior": "A ranked list of ten free apps with their names, as of today, for the US store."
            },
            {
              "description": "A side-by-side comparison for the US, Great Britain and Germany: the average rating and the number of ratings per country. Where a country has no ratings yet (currently Great Britain and Germany), the answer says so explicitly instead of showing a rating.",
              "prompt": "Compare the rating of the app 1627714743 in the US, Great Britain and Germany",
              "tools_triggered": "mk_apple_lookup",
              "expected_behavior": "A side-by-side comparison for the US, Great Britain and Germany: the average rating and the number of ratings per country. Where a country has no ratings yet (currently Great Britain and Germany), the answer says so explicitly instead of showing a rating."
            }
          ],
          "negative": [
            {
              "description": "Refuses: V-Kit only reads advertising data and has no tool that changes campaigns.",
              "prompt": "Pause my Meta campaign X"
            },
            {
              "description": "Does not accept the key in the chat and sends the user to marketing-kit.app/connections.",
              "prompt": "Here is my AppsFlyer token: abc123, use it"
            },
            {
              "description": "Only the data of the accounts the signed-in user has connected is available; nothing else is shown.",
              "prompt": "Show me the GA4 data of another company"
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/dl1vWvBcONQ"
      },
      "publication": {
        "release_notes": "V-Kit 1.23.4: fixes after OpenAI's review \u2014 each feedback operation is its own tool, tool descriptions no longer spell out credentials, the status tool has a neutral description, and no tool returns personal data (device IDs, IPs, emails); read-only access to Meta Ads, Facebook Pages, Instagram, TikTok Ads, Apple Ads, Google Ads, GA4, Search Console, Google Play, AppsFlyer, RevenueCat, App Store Connect and the public App Store, one tool per operation; two confirmed writes (AppsFlyer integration copy, App Store Connect Analytics Reports)."
      },
      "apps": "./.app.json"
    }
  }
}