← 全部技能
Keepa 数据1 积分/次

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
参数类型必填说明默认
asinstring是

商品 ASIN(10 位字母数字)

无
domainstring否

站点,见下方取值表

com
dataTypesarray否

要哪些序列,见下方取值表

["AMAZON","NEW","SALES"]
daysint否

只取最近 N 天,1~3650

90
maxPointsPerSeriesint否

每条序列降采样到最多几个点,10~1000。首尾必定保留

150
refreshIfOlderThanHoursint否

数据源数据超过 N 小时则去亚马逊重取。0=每次实时,-1=绝不刷新

数据源默认

价格走势图(PNG)

--graphPOST /v2/keepa/get-price-graph
参数类型必填说明默认
asinstring是

商品 ASIN(10 位字母数字)

无
domainstring否

站点。这个端点不支持 `com.br`

com
rangeDaysint否

图表天数,1~3650

90
amazonbool否

画 Amazon 自营价线

true
newbool否

画第三方新品价线

true
usedbool否

画二手价线

false
salesRankbool否

画排名线

false
buyBoxbool否

画 Buy Box 价线

false
widthint否

宽度像素,300~1000

800
heightint否

高度像素,150~1000

400

返回值

ASIN 历史走势

POST /v2/keepa/get-price-history
字段怎么用
series.<类型>.current

该序列的当前值

series.<类型>.min / max

区间内最低最高

series.<类型>.weightedAverage

按时间加权的平均价,比简单平均更准(一个价格挂了半年权重就大)

series.<类型>.changeCount

变价次数。频繁变价说明这个位置在打价格战

series.<类型>.unit

该序列的货币单位(价格类序列才有)

series.<类型>.points[]

数据点数组,每个含 date(ISO-8601)与 value。阶梯函数:值有效到下一个点;null = 当时无报价

rangeDays

实际返回的天数

价格走势图(PNG)

--graphPOST /v2/keepa/get-price-graph
字段怎么用
mimeType

固定 image/png

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

同类技能