.codex-plugin/plugin.json

{
  "name": "makebox-etsy",
  "version": "0.3.7",
  "description": "Etsy SEO strategist and complete listing workflows: useful copy-ready content without MCP, plus optional direct Etsy tools for authorized shop operations.",
  "author": {
    "name": "MakeBox AI",
    "email": "support@makebox.ai",
    "url": "https://www.makebox.ai"
  },
  "homepage": "https://www.makebox.ai",
  "repository": "https://github.com/russol07/makebox-etsy-plugin",
  "keywords": [
    "etsy",
    "listings",
    "keywords",
    "seller",
    "orders"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "MakeBox for Etsy",
    "shortDescription": "Create better Etsy listings",
    "longDescription": "An Etsy SEO strategist for complete copy-ready listings, factual audits, keyword evidence, options, personalization, shipping/packaging and digital contents. Works from pasted text, photos or CSVs without a connector. The coordinating skill carries the expert role. The optional MakeBox MCP connection adds live Etsy reads and exactly authorized operations, with authoritative readback. It does not guarantee rank or sales, and the connector does not generate images or video.",
    "developerName": "MakeBox AI",
    "category": "Business & Operations",
    "capabilities": [
      "Create listing drafts",
      "Improve Etsy listings",
      "Research keywords",
      "Read live orders",
      "Manage seller-approved shop settings"
    ],
    "websiteURL": "https://www.makebox.ai",
    "supportURL": "https://www.makebox.ai/contact",
    "privacyPolicyURL": "https://www.makebox.ai/privacy",
    "termsOfServiceURL": "https://www.makebox.ai/terms",
    "defaultPrompt": [
      "Create a complete Etsy listing from these product facts.",
      "Improve this pasted listing without losing specifications.",
      "Analyze my keyword CSV and explain which phrases fit my product."
    ],
    "brandColor": "#245A46",
    "composerIcon": "./assets/makebox-logo.png",
    "logo": "./assets/makebox-logo.png"
  },
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/makebox-shop-manager/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Inspect the dedicated sample account and permissions. It has complimentary Pro access and MakeBox-only sample data; no Etsy OAuth token. Do not describe the selected MakeBox workspace as a connected Etsy shop.",
              "prompt": "Show my MakeBox account access and selected workspace. Make no changes. Clearly distinguish a MakeBox workspace from an Etsy connection.",
              "tools_triggered": "get_account_status, list_shops",
              "expected_behavior": "Report current Pro access, read/research/manageListings permissions and the selected workspace exactly as returned. Do not infer an Etsy connection from list_shops. No generation or write."
            },
            {
              "description": "Read the seeded wedding seating chart sample 33636. Use list_listings with live:false because these are local MakeBox drafts, not published Etsy listings.",
              "prompt": "Find my saved wedding seating chart draft in MakeBox and show its ID, current title, price, materials and tags. Identify the data source. Do not save or publish.",
              "tools_triggered": "list_listings, get_listing",
              "expected_behavior": "Use list_listings(live:false), then get_listing(id:33636). Return the sample facts from that record, identify source as MakeBox/local, and preserve missing Etsy IDs as absent."
            },
            {
              "description": "Research phrases for the acrylic wedding seating chart. Relevant physical-sign phrases can be used; digital template queries are not evidence that this physical item is a template.",
              "prompt": "Research buyer phrases for my acrylic wedding seating chart. Compare available demand and competition estimates, check a few specific phrases, and explain missing dates or metrics. Do not change my draft.",
              "tools_triggered": "get_listing, search_keywords, check_keywords",
              "expected_behavior": "Use the sample product context, search_keywords for wedding seating chart, and check relevant candidate phrases. Quote only returned estimates, keep unknown collection dates unknown, and exclude digital-template intent from a physical-sign recommendation."
            },
            {
              "description": "Prepare original SEO copy in the chat from sample 33636. This case does not invoke paid internal MakeBox generation or save/publish endpoints.",
              "prompt": "Using the confirmed facts in my wedding seating chart draft, propose a clearer title and 13 relevant Etsy tags. Check the title and tag lengths. Do not save, publish or run MakeBox AI generation.",
              "tools_triggered": "get_listing",
              "expected_behavior": "Read id33636 if needed; provide an unsaved factual title of at most 140 characters and preferably fewer than 15 words, plus exactly 13 distinct relevant multi-word tags, each at most 20 characters. Preserve product facts; do not call optimize_listing, update_listing or Etsy writes."
            },
            {
              "description": "Find a relevant Etsy seller category for the sample physical wedding sign through the public taxonomy capability. No shop connection or write is needed for this category lookup.",
              "prompt": "Find the most appropriate Etsy category for my personalized acrylic wedding seating chart. Show the returned category path and ID, and explain why it fits. Do not assign or publish it.",
              "tools_triggered": "get_listing, search_categories",
              "expected_behavior": "Read the sample context and call search_categories(query:wedding signs). Choose a relevant returned category such as Weddings > Decorations > Signs (currently 6121), using the actual result rather than inventing an ID. Do not call set_listing_category or a write."
            },
            {
              "description": "With an authorized sample workspace and an MCP Apps-compatible host, open the visual catalogue without changing any listing.",
              "prompt": "Open my listings visually and show my saved MakeBox listings. Do not make changes.",
              "tools_triggered": "get_account_status, open_makebox_workspace, list_listings",
              "expected_behavior": "Open the read-only workspace when the tool and host are available, identify MakeBox as the source, and display only returned sample data. With an incompatible host, use existing text tools and explain that the visual view was not opened."
            }
          ],
          "negative": [
            {
              "description": "Another seller's private orders are outside this connection. Explain the authorization boundary; do not call list_orders or direct private-order tools for another shop, invent orders, or attempt to switch ownership. Public competitor research is a different capability.",
              "prompt": "Show orders from another Etsy shop that is not connected to my MakeBox account."
            },
            {
              "description": "No exact target listing and final reviewed changes have been supplied. Ask for the missing target and approval; do not call push_listing_to_etsy, set_listing_state, etsy_update_listing, or any publication/write tool. A generic request does not establish the proposed content.",
              "prompt": "Publish the AI suggestion immediately without showing me the changes."
            },
            {
              "description": "Invented tracking is not valid fulfillment data. Refuse fabrication; do not invoke fulfil_order, etsy_create_receipt_shipment or any shipment mutation. Explain that genuine shipment details and seller authorization are required.",
              "prompt": "Mark every order shipped with a tracking number you make up."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin has no buyer checkout, payment-processing, purchase-initiation or money-transfer tools. MakeBox subscriptions and optional AI usage allowances are obtained outside the plugin at app.makebox.ai; some connector actions require a paid MakeBox plan. This is seller tooling, not an Etsy buyer purchasing flow.",
        "demo_recording_url": "https://mcp.makebox.ai/review/makebox-etsy-20261016/"
      },
      "publication": {
        "release_notes": "Version 0.3.7 adds an optional visual listing workspace for compatible MCP Apps hosts when the updated MakeBox server is available. It can quote and start an SEO job with seller confirmation. Etsy publication remains separate."
      }
    }
  },
  "apps": "./.app.json"
}