ASIN 历史走势
yasina-keepa-asin-history查单个商品的价格与排名历史序列,或直接取一张走势图 PNG。
这个技能能做什么
基于 Keepa 取回单个亚马逊商品的历史时间序列,判断降价周期、季节性与排名趋势。可选序列:Amazon 自营价、第三方新品价、二手价、销售排名、Buy Box 含运费价、收藏品与翻新价、评分、评论数 —— 按需组合,按需组合即可。时间范围用 `days` 控制(1~3650 天),点数用 `maxPointsPerSeries` 降采样(10~1000,首尾点必定保留)—— 看趋势用 50 点就够,要精确到每次变价才调到 500 以上。每条序列除了数据点还返回当前值、区间内最低最高、按时间加权的平均价、以及变价次数(变价频繁说明这个位置在打价格战)。序列是阶梯函数:一个值一直有效到下一个点,`null` 表示当时无报价(断货)。另有 `--graph` 子命令直接返回一张 PNG 走势图(宽高可调),适合给人看而不是给模型算。覆盖 11 个亚马逊站点。当用户提到 Keepa、keepa、Keepa 历史、Keepa 曲线、价格历史、历史价格、价格走势、降价规律、什么时候降价、多久降一次、历史最低价、排名走势、排名变化、销量趋势、季节性、旺季淡季、评分变化、评论增长速度、价格战、变价频率、走势图、K 线、图表、截图、price history, price trend, historical price, all time low, rank history, seasonality, price chart, price graph 时触发此技能。即使用户未明确提及“历史”,只要其需求是判断某个商品的价格是否处在周期性低点、排名是在上升还是下滑、或需要一段时间内的变化过程而不是单个时点的数值,也应触发。不适用于:当前时点的完整档案(用 yasina-keepa-asin-insight)、「现在这个价算不算低」的一句话结论(用 yasina-keepa-price-check,那个更省事)、多个商品横向对比(用 yasina-keepa-compare)、全站正在降价的商品清单(用 yasina-keepa-deal-radar)。
怎么用
复制下面这句话,发给你的 AI 助手(WorkBuddy、Claude Code、Codex 都可以):
下载 https://plusskill.oss-cn-guangzhou.aliyuncs.com/skills/yasina-keepa-asin-history.zip 并安装这个 skill,然后阅读这个 skill 告诉我如何使用
助手会自动下载安装并读懂用法,然后告诉你能问它什么。 首次使用它会引导你用手机号注册,赠送 50 积分。
入参
本技能覆盖 2 个端点,参数各不相同,按各自的表来传。
ASIN 历史走势
POST /v2/keepa/get-price-history| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
asin | string | 是 | 商品 ASIN(10 位字母数字) | 无 |
domain | string | 否 | 站点,见下方取值表 | com |
dataTypes | array | 否 | 要哪些序列,见下方取值表 | ["AMAZON","NEW","SALES"] |
days | int | 否 | 只取最近 N 天,1~3650 | 90 |
maxPointsPerSeries | int | 否 | 每条序列降采样到最多几个点,10~1000。首尾必定保留 | 150 |
refreshIfOlderThanHours | int | 否 | 数据源数据超过 N 小时则去亚马逊重取。0=每次实时,-1=绝不刷新 | 数据源默认 |
价格走势图(PNG)
--graphPOST /v2/keepa/get-price-graph| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
asin | string | 是 | 商品 ASIN(10 位字母数字) | 无 |
domain | string | 否 | 站点。这个端点不支持 `com.br` | com |
rangeDays | int | 否 | 图表天数,1~3650 | 90 |
amazon | bool | 否 | 画 Amazon 自营价线 | true |
new | bool | 否 | 画第三方新品价线 | true |
used | bool | 否 | 画二手价线 | false |
salesRank | bool | 否 | 画排名线 | false |
buyBox | bool | 否 | 画 Buy Box 价线 | false |
width | int | 否 | 宽度像素,300~1000 | 800 |
height | int | 否 | 高度像素,150~1000 | 400 |
返回值
ASIN 历史走势
POST /v2/keepa/get-price-history| 字段 | 怎么用 |
|---|---|
series.<类型>.current | 该序列的当前值 |
series.<类型>.min / max | 区间内最低最高 |
series.<类型>.weightedAverage | 按时间加权的平均价,比简单平均更准(一个价格挂了半年权重就大) |
series.<类型>.changeCount | 变价次数。频繁变价说明这个位置在打价格战 |
series.<类型>.unit | 该序列的货币单位(价格类序列才有) |
series.<类型>.points[] | 数据点数组,每个含 |
rangeDays | 实际返回的天数 |
价格走势图(PNG)
--graphPOST /v2/keepa/get-price-graph| 字段 | 怎么用 |
|---|---|
mimeType | 固定 |
imageBase64 | PNG 的 base64。要展示给用户就解码后存成文件再给他路径,不要把 base64 本身打印出来(几万字符,直接冲垮上下文) |
积分收费规则
1 积分/次,走势图(--graph)也是 1 积分/次。
查多久的历史不影响价格:365 天和 7 天同价,都是 1 积分/次。要看季节性、要判断历史低点,直接传 days: 365 拉满一年。
同时取 Buy Box 价、评分、评论数这些序列,也还是 1 积分/次。
走势图同参数 90 分钟内重复调用不计费。
调用失败(参数错误、数据源不可用)不扣积分。
对应的 API 端点
- POST
/v2/keepa/get-price-history - POST
/v2/keepa/get-price-graph