cx-amazon-sp-api 0.1.4 → 0.1.6

package/README.md

@@ -1 +1,21 @@
-Lets cx work in your own Amazon store through Amazon's SP-API, in the marketplaces you authorise. cx can read your orders, listings, inventory and reports, and can make changes within what you authorise. Neither Amazon nor ComChatX charges for it.
+# Amazon SP-API
+
+This plugin connects cx to your own Amazon store through Amazon's Selling Partner API (SP-API). Once you connect a store, cx can read your orders, listings, inventory, reports and finances, and make changes in the marketplaces you authorised, such as updating a listing or a price.
+
+Some things you can ask:
+
+- How many orders came in today, and which are pending or cancelled?
+- Which of my FBA listings will run out of stock in the next two weeks?
+- What is wrong with this listing, and how do I fix it?
+
+## Connecting your store
+
+Open the plugin's Settings and connect a store for each region you sell in: North America, Europe or the Far East. Amazon's guide to self-authorisation shows where to find what Settings asks for. Your keys stay on the ComChatX platform and are never given to cx.
+
+## What it costs
+
+Nothing. Neither Amazon nor ComChatX charges for SP-API calls.
+
+## What it needs
+
+It installs with cx-sources, through which cx reaches every data source.

package/README.zh-CN.md

@@ -0,0 +1,19 @@
+这个插件通过亚马逊的销售伙伴 API（SP-API）把 cx 连接到你自己的亚马逊店铺。连接店铺后，cx 可以读取你的订单、Listing、库存、报告和财务数据，并在你授权的站点内进行修改，比如更新 Listing 或价格。
+
+你可以这样问：
+
+- 今天来了多少订单？哪些还在等待处理或已取消？
+- 我的哪些 FBA Listing 会在两周内断货？
+- 这个 Listing 有什么问题，要怎么修复？
+
+## 连接店铺
+
+打开插件的「设置」，为你开店的每个区域连接一个店铺：北美、欧洲或远东。亚马逊的自授权指南说明了在哪里找到「设置」需要填写的内容。你的密钥保存在 ComChatX 平台上，不会交给 cx。
+
+## 费用
+
+免费。亚马逊和 ComChatX 都不对 SP-API 调用收费。
+
+## 依赖
+
+它会和 cx-sources 一起安装，cx 通过 cx-sources 使用所有数据源。

package/package.json

@@ -1,40 +1,60 @@
 {
   "name": "cx-amazon-sp-api",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Reads and updates your own Amazon store.",
-  "author": "ComChatX",
   "license": "MIT",
+  "author": "ComChatX",
+  "homepage": "https://github.com/comchatx/cx-amazon-sp-api#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/HS-Jack-YZY/ComChatX.git",
-    "directory": "src/source-packages/cx-amazon-sp-api"
+    "url": "git+https://github.com/comchatx/cx-amazon-sp-api.git"
   },
+  "bugs": "https://github.com/comchatx/cx-amazon-sp-api/issues",
   "keywords": [
     "pi-package"
   ],
+  "type": "module",
   "pi": {
     "skills": [
       "./skills"
+    ],
+    "prompts": [
+      "./prompts"
     ]
   },
+  "files": [
+    "skills",
+    "prompts",
+    "README.zh-CN.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
   "comchatx": {
     "name": "Amazon SP-API",
-    "about": "读取并更新你自己的亚马逊店铺。",
-    "description": "授权后，cx 可以通过亚马逊 SP-API 访问你的店铺，范围以你授权的站点为限。cx 可以读取订单、listing、库存和报告，并在授权范围内进行修改。亚马逊和 ComChatX 均不为此收费。",
+    "description": {
+      "zh": "读取并更新你自己的亚马逊店铺。"
+    },
     "mark": {
       "line": "layout"
     },
     "section": "data",
     "order": 20,
-    "builds": [
-      "cx-sources"
-    ],
     "skills": {
       "amazon-sp-api": {
-        "about": {
-          "en": "Connects cx to your orders, listings, inventory, reports and finances.",
-          "zh": "连接 cx 与你的订单、Listing、库存、报告和财务数据。"
-        }
+        "zh": "通过 SP-API 读取和修改你自己的亚马逊店铺：订单、Listing、库存、报告、Feed 和财务数据，覆盖你授权的每个区域。"
+      }
+    },
+    "prompts": {
+      "orders-today": {
+        "zh": "按站点查看店铺今天的订单"
+      },
+      "low-stock": {
+        "zh": "找出两周内会断货的 FBA Listing"
+      },
+      "listing-check": {
+        "zh": "检查 Listing 上亚马逊标出的问题，并给出修复方案"
       }
     },
     "source": {
@@ -42,5 +62,14 @@
       "help": "https://developer-docs.amazon/sp-api/docs/self-authorization",
       "aspects": {}
     }
+  },
+  "dependencies": {
+    "cx-sources": "^0.1.3"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "1.4.0",
+    "@types/node": "26.2.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
   }
 }

package/prompts/listing-check.md

@@ -0,0 +1,5 @@
+---
+description: Check a listing for the issues Amazon flags, and propose fixes
+argument-hint: "<sku>"
+---
+Read my listing for SKU $1 and every issue Amazon reports on it: suppression, missing or invalid attributes, and image or price problems. For each issue, say what it means for the listing and the change that would fix it. Make no change until I confirm which ones to make.

package/prompts/low-stock.md

@@ -0,0 +1,4 @@
+---
+description: Find the FBA listings that will run out of stock within two weeks
+---
+Which of my FBA listings will run out of stock within ${1:-14} days at the rate they sold over the last 30 days? For each, show the SKU, its title, the units available and inbound, the units sold a day, and the day it runs out, soonest first. Change nothing in my store.

package/prompts/orders-today.md

@@ -0,0 +1,4 @@
+---
+description: See today's orders in your store, marketplace by marketplace
+---
+List today's orders in my Amazon store, marketplace by marketplace: how many there are, their total in each marketplace's currency, and which are still pending or were cancelled. Use the time zone of each marketplace for "today".