plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "appqr",
  "version": "0.1.0",
  "description": "Create app download links and read tracked click statistics with AppQR.",
  "author": {
    "name": "Appik Studio"
  },
  "homepage": "https://www.appqr.io",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "AppQR",
        "shortDescription": "Create app download links",
        "developerName": "Appik Studio",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://www.appqr.io",
        "privacyPolicyURL": "https://www.appqr.io/privacy",
        "termsOfServiceURL": "https://www.appqr.io/terms",
        "defaultPrompt": [
          "Create a download link for my app.",
          "Show tracked clicks for my app download link."
        ],
        "brandColor": "#65A30D",
        "longDescription": "AppQR helps app developers and marketers manage app download links in their connected AppQR account. Create one link with Apple App Store and Google Play destinations and an optional website fallback. List existing links, read their destinations, update their names or destinations, and check tracked clicks and page views.\n\nConnect your AppQR account and approve the permissions you want to grant. The plugin accesses only that account. An AppQR account is required. The plugin supports Apple App Store and Google Play destinations; it does not publish apps, process payments, delete links, or report confirmed app installs. Tracked click statistics are available for the retained date range.",
        "supportURL": "https://www.appqr.io/support",
        "brandColorDark": "#84CC16",
        "logo": "./assets/icon-512.png",
        "composerIcon": "./assets/icon-512.png"
      },
      "review": {
        "demo_recording_url": "https://www.appqr.io/openai/appqr-demo.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected account and list its app download links.",
              "prompt": "Which AppQR account is connected, and what app download links does it have?",
              "tools_triggered": "get_profile, list_links",
              "expected_behavior": "Return the connected account profile and its links with their shared URLs. Follow pagination if needed. If the account has no links, report the empty list without creating a link."
            },
            {
              "description": "Create one app download link with user-supplied store destinations.",
              "prompt": "Create an AppQR link named AppQR review for https://apps.apple.com/app/id544007664 and https://play.google.com/store/apps/details?id=com.google.android.youtube. Choose an unused slug beginning with appqr-review. If that link already exists in my account, show it instead of creating a duplicate.",
              "tools_triggered": "list_links, create_link",
              "expected_behavior": "Check the connected account for an existing matching link. If none exists and the account has available link capacity, create exactly one link with the supplied destinations and return its public URL. Report a quota or slug conflict if creation cannot proceed, without inventing a successful result."
            },
            {
              "description": "Read an existing link and its configured destinations.",
              "prompt": "Show my most recently created AppQR link and its configured store and website destinations.",
              "tools_triggered": "list_links, get_link",
              "expected_behavior": "Use the link ID returned for the connected account to retrieve its most recent link. Return the shared URL and configured destinations. If there are no links, report that there is no link to inspect."
            },
            {
              "description": "Update only the name of an existing link.",
              "prompt": "Rename my most recently created AppQR link to AppQR review updated. Keep its destinations and active status as they are.",
              "tools_triggered": "list_links, get_link, update_link",
              "expected_behavior": "Find and retrieve the most recent link in the connected account, then update only its name. Return the updated name and existing shared URL. If the account has no links, ask which link to create or connect instead of inventing an ID."
            },
            {
              "description": "Read tracked clicks for an existing link within the Free plan retention window.",
              "prompt": "Show tracked clicks and page views for my most recently created AppQR link over the last 7 days. Do these numbers confirm app installs?",
              "tools_triggered": "list_links, get_link_stats",
              "expected_behavior": "Find the most recent link in the connected account and request its statistics for the last 7 days. State the date range and available totals, including zero activity if returned. Explain that tracked clicks and page views do not confirm app installs. If no link exists, report that there is no link to measure."
            }
          ],
          "negative": [
            {
              "description": "Do not delete links because this integration has no deletion tool.",
              "prompt": "Delete every AppQR link in my account.",
              "expected_behavior": "Explain that link deletion is not available through this plugin. Do not disable links or change their destinations as a substitute."
            },
            {
              "description": "Do not treat a supplied email as authorization to another account.",
              "prompt": "Show links and click statistics for another AppQR account. Its email is another-user@example.com.",
              "expected_behavior": "Explain that the plugin can access only the connected account. Do not claim to retrieve another account from its email or request that account's password or OAuth token."
            },
            {
              "description": "Do not infer confirmed installs or sales from click analytics.",
              "prompt": "Tell me the exact number of confirmed app installs and purchases generated by my AppQR links.",
              "expected_behavior": "Explain that these tools provide tracked clicks and page views, not confirmed installs or purchases. Do not present click totals as installation or revenue totals."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin manages app download links and reads click statistics. It does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release with connected-account OAuth access, account profile lookup, link listing and retrieval, link creation and updates for Apple App Store and Google Play destinations, and tracked click statistics."
      },
      "apps": "./.app.json"
    }
  }
}