cx-keepa 0.1.5 → 0.1.6

package/README.md

@@ -1 +1,19 @@
-Keepa tracks price, BSR, Buy Box, offers, coupons and estimated monthly sales across eleven Amazon marketplaces.
+# Keepa
+
+Keepa has followed Amazon products for years. With this plugin, cx can read that history for you: a product's price, sales rank (BSR), Buy Box owner, offers, coupons and estimated monthly sales, day by day, on Amazon US, UK, DE, FR, JP, CA, IT, ES, IN, MX and BR.
+
+An Amazon page shows you only today. Keepa shows what happened before it, so cx can answer questions like these:
+
+- When did my rank start to fall, and what changed that day: the price, the Buy Box, the stock?
+- Which products sell best for a search, and at what price, rating and monthly sales?
+- Is this product selling more or less than at this time last year?
+
+cx finds a product by its ASIN or by its name. Given a name, it searches, checks the title and model of what it finds, and asks you to choose where more than one product matches.
+
+## What it costs
+
+Each product cx reads is billed to your ComChatX balance. The plugin's page shows the price of one product, and Usage shows every purchase and its cost.
+
+## What it needs
+
+Keepa installs with cx-sources, which buys and reads data for cx.

package/README.zh-CN.md

@@ -0,0 +1,19 @@
+# Keepa
+
+Keepa 多年来一直在记录亚马逊商品的数据。装上这个插件，cx 就能替你查这些历史：商品每天的价格、销售排名（BSR）、Buy Box 归属、报价、优惠券和月销量预测，覆盖亚马逊美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥和巴西站。
+
+亚马逊页面只显示今天的数据。Keepa 能看到之前发生了什么，所以 cx 可以回答这样的问题：
+
+- 我的排名是从哪一天开始下滑的？那天价格、Buy Box 或库存有什么变化？
+- 某个搜索词下哪些商品卖得最好？它们的价格、评分和月销量各是多少？
+- 这个商品现在的销量比去年同期高还是低？
+
+cx 可以按 ASIN 或商品名称查找商品。给出名称时，cx 会先搜索，核对找到的商品标题和型号；如果有多个商品都符合，会请你选择。
+
+## 费用
+
+cx 每读取一个商品，都会从你的 ComChatX 余额扣款。插件页面会显示读取一个商品的价格，「用量」页列出每一笔购买和费用。
+
+## 依赖
+
+Keepa 会和 cx-sources 一起安装，cx-sources 负责替 cx 购买和读取数据。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cx-keepa",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Amazon price and BSR history.",
   "license": "MIT",
   "author": "ComChatX",
@@ -17,10 +17,15 @@
   "pi": {
     "skills": [
       "./skills"
+    ],
+    "prompts": [
+      "./prompts"
     ]
   },
   "files": [
-    "skills"
+    "skills",
+    "prompts",
+    "README.zh-CN.md"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -28,8 +33,9 @@
   },
   "comchatx": {
     "name": "Keepa",
-    "about": "亚马逊商品的历史价格和 BSR 走势。",
-    "description": "Keepa 提供 11 个亚马逊站点的历史价格、BSR、Buy Box、报价、优惠券和月销量预测。",
+    "description": {
+      "zh": "亚马逊商品的历史价格和 BSR 走势。"
+    },
     "mark": {
       "logo": "keepa"
     },
@@ -39,53 +45,20 @@
       "en": "Investigate the history of price changes, Buy Box ownership and seasonal rank movement, and assess product opportunities. Available for Amazon US, UK, DE, FR, JP, CA, IT, ES, IN, MX and BR.",
       "zh": "查看价格变化、Buy Box 归属和季节性排名的历史记录，并评估选品机会。数据涵盖亚马逊美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥和巴西站。"
     },
-    "tryIt": [
-      {
-        "en": "My power bank {asin} went from rank 800 to 2,300 in Electronics over the last two weeks. Pull its price, Buy Box and stock history for that stretch and show me the day things turned.",
-        "zh": "我的充电宝 {asin} 在电子类目的排名两周内从 800 掉到 2300。查看这段时间的价格、Buy Box 和库存记录，找出从哪一天开始变化。"
-      },
-      {
-        "en": "Find the ten best-selling 20,000 mAh power banks on Amazon US, with each one's price, rating, review count and monthly sales, in one table.",
-        "zh": "找出亚马逊美国站销量最高的十款 20000 mAh 充电宝，把每款的价格、评分、评论数和月销量放进一张表格。"
-      },
-      {
-        "en": "Is {asin} on Amazon JP selling more or less than it did at this time last year?",
-        "zh": "亚马逊日本站的 {asin} 现在销量比去年同期高还是低？"
-      }
-    ],
-    "builds": [
-      "cx-sources"
-    ],
     "skills": {
       "keepa": {
-        "about": {
-          "en": "Looks up products on Keepa by ASIN or name across eleven Amazon marketplaces.",
-          "zh": "按 ASIN 或名称查询 11 个亚马逊站点的 Keepa 数据。"
-        },
-        "when": [
-          {
-            "en": "Checking what a product sells for now, or how its price moved",
-            "zh": "查看商品当前价格和历史变化"
-          },
-          {
-            "en": "Finding out who holds the Buy Box, and since when",
-            "zh": "查看 Buy Box 归属及变更时间"
-          },
-          {
-            "en": "Seeing which products sell best for a search or in a category",
-            "zh": "查看搜索结果或类目中的畅销商品"
-          }
-        ],
-        "tryIt": [
-          {
-            "en": "My power bank {asin} went from rank 800 to 2,300 in Electronics over the last two weeks. Pull its price, Buy Box and stock history for that stretch and show me the day things turned.",
-            "zh": "我的充电宝 {asin} 在电子类目的排名两周内从 800 掉到 2300。查看这段时间的价格、Buy Box 和库存记录，找出从哪一天开始变化。"
-          },
-          {
-            "en": "Find the ten best-selling 20,000 mAh power banks on Amazon US, with each one's price, rating, review count and monthly sales, in one table.",
-            "zh": "找出亚马逊美国站销量最高的十款 20000 mAh 充电宝，把每款的价格、评分、评论数和月销量放进一张表格。"
-          }
-        ]
+        "zh": "按 ASIN 或名称查询 11 个亚马逊站点的商品价格、排名、Buy Box 和销量历史，也能查卖家信息。"
+      }
+    },
+    "prompts": {
+      "rank-drop": {
+        "zh": "从价格、Buy Box 和库存记录中找出商品排名开始变化的那一天"
+      },
+      "top-ten": {
+        "zh": "把亚马逊美国站某个搜索词下的十款畅销商品放进一张表格对比"
+      },
+      "year-on-year": {
+        "zh": "查看商品现在的销量比去年同期高还是低"
       }
     },
     "source": {
@@ -111,6 +84,9 @@
     },
     "mcp": "keepa"
   },
+  "dependencies": {
+    "cx-sources": "^0.1.3"
+  },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "1.4.0",
     "@types/node": "26.2.0",

package/prompts/rank-drop.md

@@ -0,0 +1,5 @@
+---
+description: Find the day a product's rank turned, from its price, Buy Box and stock history
+argument-hint: "<asin> [marketplace]"
+---
+My product $1 on Amazon ${2:-US} has lost sales rank over the last two weeks. Read its price, sales rank, Buy Box and stock history for the last 30 days from Keepa, and show me the day things turned. For that day, say what changed: its own price, a competitor's price or coupon, who held the Buy Box, or whether it ran out of stock. End with what I should change this week.

package/prompts/top-ten.md

@@ -0,0 +1,4 @@
+---
+description: Compare the ten best sellers for a search on Amazon US in one table
+---
+Find the ten best-selling ${@:-20,000 mAh power banks} on Amazon US with Keepa. Put each one's ASIN, title, price, rating, review count and estimated monthly sales in one table, best seller first. Under the table, say what the best sellers have in common, and at what price and rating a new product would have room.

package/prompts/year-on-year.md

@@ -0,0 +1,5 @@
+---
+description: See whether a product sells more or less than at this time last year
+argument-hint: "<asin> [marketplace]"
+---
+Is $1 on Amazon ${2:-US} selling more or less than it did at this time last year? From Keepa, compare its estimated monthly sales, sales rank and price over the same four weeks of this year and last year, in a table, and say what most likely explains the difference.