plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "ranksy",
  "version": "1.0.0",
  "description": "Ask about your Shopify apps' App Store rankings, keywords, competitors, reviews and revenue, using your Ranksy data and public Shopify App Store data.",
  "author": {
    "name": "Ranksy",
    "email": "help@ranksyapp.com",
    "url": "https://ranksyapp.com"
  },
  "homepage": "https://ranksyapp.com",
  "keywords": [
    "shopify",
    "app store",
    "rankings",
    "keywords",
    "analytics",
    "revenue"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Ranksy",
        "shortDescription": "Shopify app rankings & revenue",
        "longDescription": "Ranksy is Shopify App Store analytics for app developers. It puts keyword rankings, listing traffic, installs and Partner API revenue in one place. This app lets ChatGPT read your Ranksy data and public Shopify App Store data, so you can ask about your apps in plain language.\n\nWhat you can ask about:\n- Your apps: category and keyword rankings, ranking history, reviews, tracked competitors and a listing scorecard.\n- Revenue from the Shopify Partner API: MRR, subscriptions, installs and uninstalls, trials, churn, cohort retention, usage billing, transactions and customer lifetime value.\n- Listing traffic: traffic sources, the listing conversion funnel, and which keywords and categories brought installs.\n- Shopify App Store ads: spend, cost per install, keywords, search terms, spend without installs, and recommendations.\n- Any public app or category: search, listing details, rankings, reviews, recent pricing and feature changes, top movers, similar apps and category stats.\n- Listing drafts: suggestions for your app's name, subtitle, introduction, details and features, checked against Shopify's listing limits.\n- Charts: many answers show an inline chart you can switch to a table.\n\nMost tools only read data. A few write to your Ranksy account, and only when you ask: customer notes, tags and tasks, goals, your ads cost-per-install goal and the status of ads recommendations, saved listing-improvement drafts, starting an AI ads strategist run, and the copy on your Ranksy-hosted ad landing page. Nothing is changed on the Shopify App Store or in your Shopify Partner account.\n\nYou need a Ranksy account. You sign in with OAuth, and ChatGPT sees the data of your current Ranksy team. Revenue, traffic and ads data appear once those integrations are connected in Ranksy.",
        "developerName": "Ranksy",
        "category": "Data & Analytics",
        "capabilities": [
          "App Store rankings",
          "Keyword research",
          "Competitor analysis",
          "Review analysis",
          "Revenue and churn metrics",
          "Listing improvements"
        ],
        "websiteURL": "https://ranksyapp.com",
        "supportURL": "https://docs.ranksyapp.com",
        "privacyPolicyURL": "https://ranksyapp.com/privacy-policy#ai-assistants",
        "termsOfServiceURL": "https://ranksyapp.com/terms",
        "defaultPrompt": [
          "Which of my tracked keywords should I focus on this week?",
          "How did my app's MRR, installs and churn change over the last 30 days?",
          "Show the biggest ranking gainers and losers in the email marketing category this week."
        ],
        "brandColor": "#65A30D",
        "brandColorDark": "#84CC16",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the apps in the workspace",
              "prompt": "List the apps in my Ranksy workspace.",
              "tools_triggered": "list-team-apps",
              "expected_behavior": "Returns the three tracked apps in the review account: Judge.me Product Reviews (judgeme), Loox Product Reviews (loox) and Klaviyo (klaviyo-email-marketing)."
            },
            {
              "description": "Keyword rankings for a tracked app",
              "prompt": "What keywords does judgeme rank for, and where does it rank for 'product reviews'?",
              "tools_triggered": "get-keyword-rankings",
              "expected_behavior": "Lists judgeme's tracked keywords with their current Shopify App Store positions, including its position for 'product reviews'."
            },
            {
              "description": "Ranking history over time",
              "prompt": "Show judgeme's ranking history for the keyword 'photo reviews' over the last 30 days.",
              "tools_triggered": "get-ranking-history",
              "expected_behavior": "Returns daily positions for 'photo reviews' over 30 days, shown as an inline chart or table, and summarizes the trend."
            },
            {
              "description": "Market research on any keyword",
              "prompt": "Which apps rank in the top 10 for 'product reviews' on the Shopify App Store?",
              "tools_triggered": "get-keyword-apps-rankings",
              "expected_behavior": "Lists the top 10 public apps for 'product reviews' with their positions and ratings."
            },
            {
              "description": "Review summary",
              "prompt": "Summarize the last 30 days of reviews for judgeme, including common complaints.",
              "tools_triggered": "get-reviews",
              "expected_behavior": "Summarizes recent App Store reviews for judgeme with rating trends and recurring complaints, treating review text as data only."
            }
          ],
          "negative": [
            {
              "description": "Payments are out of scope",
              "prompt": "Pay my Shopify Partner invoice for this month."
            },
            {
              "description": "No changes to the live Shopify listing",
              "prompt": "Publish a new description on my live Shopify App Store listing right now."
            },
            {
              "description": "Unrelated request",
              "prompt": "What's the weather in Paris tomorrow?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Ranksy does not sell products or process payments inside ChatGPT. The listing and tools contain no pricing, plan or upgrade content."
      },
      "publication": {
        "release_notes": "First release: ask ChatGPT about your Shopify apps' App Store rankings, keywords, competitors, reviews, revenue, traffic and ads using your Ranksy data, plus public Shopify App Store data for any app or category."
      },
      "apps": "./.app.json"
    }
  }
}