plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "erank",
  "version": "1.0.0",
  "description": "Research Etsy keywords, trends, listings, and shops with eRank, and review the Etsy shops connected to your eRank account.",
  "author": {
    "name": "ERANK LTD",
    "email": "support@erank.com",
    "url": "https://erank.com"
  },
  "homepage": "https://erank.com",
  "license": "Proprietary",
  "keywords": [
    "etsy",
    "ecommerce",
    "SEO"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "eRank",
        "shortDescription": "Etsy keyword and shop research",
        "longDescription": "Use eRank in ChatGPT to research what shoppers search for on Etsy and how listings and shops compare. Look up statistics for one keyword or compare up to 20 at once, find related searches, see which listings rank for a keyword, and explore Trend Buzz keyword trends by marketplace, country, and period. You can also read the keyword lists you've saved in eRank.\n\nFor the Etsy shops connected to your eRank account, you can review the current shop's profile and sales ranks, browse its listings with eRank Listing Audit grades, analyze a listing's tags, and check recent sales for the competitor shops you track in eRank. You can also look up the public summary and active listings of any Etsy shop by its exact name.\n\neRank learning resources, news, product updates, and your account's plan and remaining usage are available too.\n\nWhat you can access depends on your eRank account. Some data and daily search allowances vary by plan, and results say when data isn't available on your plan or a daily limit has been reached. Information about other shops is limited to public Etsy data and eRank's research data. It never includes their private orders, customers, or account details.\n\nWhen you ask, the plugin can change which of your connected shops is active in eRank. It doesn't create, edit, publish, or delete Etsy listings, and it doesn't change Etsy shop settings.",
        "developerName": "ERANK LTD",
        "category": "Data & Analytics",
        "capabilities": [
          "Keyword statistics for one keyword or up to 20 at once",
          "Related searches and top-ranking listings for a keyword",
          "Trend Buzz keyword trends by marketplace and country",
          "Saved eRank keyword lists",
          "Current shop profile, sales ranks, and listings",
          "Listing Audit grades and tag analysis",
          "Recent sales for tracked competitor shops",
          "Public summaries and listings for any Etsy shop",
          "Active eRank shop selection",
          "eRank learning resources, news, and product updates",
          "Account plan and usage limits"
        ],
        "websiteURL": "https://erank.com",
        "supportURL": "https://members.erank.com/contact",
        "privacyPolicyURL": "https://erank.com/legal/privacy-policy",
        "termsOfServiceURL": "https://erank.com/legal/terms-of-service",
        "defaultPrompt": [
          "Research the Etsy keyword personalized wedding gift, including related searches and the listings that rank for it.",
          "List my current shop's listings and help me pick one to audit and analyze its tags.",
          "Summarize recent sales for the competitor shops I track in eRank."
        ],
        "brandColor": "#004936",
        "brandColorDark": "#00B887",
        "composerIcon": "./assets/icon.svg",
        "composerIconDark": "./assets/icon-dark.svg",
        "logo": "./assets/logo.svg",
        "logoDark": "./assets/logo-dark.svg"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Onboarding: check the connection, shops, and usage limits",
              "prompt": "Help me get started with eRank. Show my current shop, my connected shops, and my account usage limits.",
              "tools_triggered": "get_current_shop, list_user_shops, get_account_limits",
              "expected_behavior": "Names the currently selected shop, lists the Etsy shops connected to the test account, and summarizes the plan and remaining daily searches. Does not change the selected shop or recommend upgrading."
            },
            {
              "description": "Compare three keywords, then research the strongest one",
              "prompt": "Compare personalized wedding gift, custom wedding gift, and wedding keepsake on Etsy. Then find related searches and top-ranking listings for the strongest one.",
              "tools_triggered": "get_bulk_keyword_stats, list_related_keywords, list_keyword_top_listings",
              "expected_behavior": "Compares the three keywords using the metrics eRank returns and picks the strongest candidate based only on those metrics. Then lists related searches and summarizes the top-ranking listings for it. Reports any metric that isn't available on the account's plan as unavailable, not as zero, and makes no promises about traffic or sales."
            },
            {
              "description": "Explore current Etsy keyword trends",
              "prompt": "What keywords are trending on Etsy in the US right now? Summarize the main themes.",
              "tools_triggered": "list_trend_buzz_keywords",
              "expected_behavior": "Returns current Etsy Trend Buzz keywords for the USA and summarizes notable themes using only the returned rankings and metrics."
            },
            {
              "description": "Audit a listing in the connected shop",
              "prompt": "Find my listing Mini Rainbow Cowl Scarf, listing ID 499401137. Explain its eRank audit grade, and analyze its tags.",
              "tools_triggered": "list_current_shop_listings, get_listing_details, get_listing_tag_analysis",
              "expected_behavior": "Finds the listing in the current test shop by title, reports its details and eRank Listing Audit grade (A to E, or not yet graded), analyzes its tags using the returned metrics, and suggests possible improvements. Does not edit the listing."
            },
            {
              "description": "Research a tracked competitor",
              "prompt": "Show recent sales for AstralWeekend, a competitor I track in eRank, then summarize its public shop details and listings.",
              "tools_triggered": "list_competitor_sales, get_shop_public_summary, list_shop_public_listings",
              "expected_behavior": "Returns recent daily sales for AstralWeekend from the account's tracked shops, then summarizes its public shop summary and active listings. Presents the figures as eRank research data, not as private Etsy data."
            }
          ],
          "negative": [
            {
              "description": "Unsupported listing edit. No tool can edit or publish Etsy listings, so no eRank tool should run and the reply must not claim that anything changed. It should explain that eRank can analyze the listing and suggest a title and tags for the user to apply on Etsy.",
              "prompt": "Change the title and tags on my Etsy listing Mini Rainbow Cowl Scarf, listing ID 499401137, and publish the changes."
            },
            {
              "description": "Private data about another shop. eRank provides only public shop and listing data, so it can't return another shop's customers, email addresses, or orders. No eRank tool should be used to suggest otherwise; the reply should explain that only public shop research is available.",
              "prompt": "Show me the customer names, email addresses, and order details for my competitor AstralWeekend."
            },
            {
              "description": "Unrelated request. The question has nothing to do with eRank, Etsy, shops, listings, or keywords, so no eRank tool should run. ChatGPT should answer with a built-in capability or another available tool.",
              "prompt": "What will the weather be in Paris tomorrow?"
            }
          ]
        },
        "demo_recording_url": "https://erank.com/plugin-demo",
        "commerce": false,
        "commerce_description": "The plugin gives access to research and account data from an existing eRank account. It doesn't sell anything, process payments, or start or change subscriptions."
      },
      "publication": {
        "release_notes": "First release: Etsy keyword and trend research, listing audits and tag analysis, connected shop insights, competitor and public shop research, saved keyword lists, and eRank learning resources and updates."
      },
      "apps": "./.app.json"
    }
  }
}