Back to Details

linkfox-keepa-product-history

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Keepa Product Time-Series Data Explorer

Keepa 商品时序数据探索工具

This skill guides you on how to query and analyze Amazon product historical time-series data, helping Amazon sellers track price movements, BSR trends, rating changes, and other key product metrics over time.
本技能将指导您如何查询和分析亚马逊商品的历史时序数据，帮助亚马逊卖家追踪价格变动、BSR趋势、评分变化及其他关键商品指标随时间的变化情况。

Core Concepts

核心概念

This tool provides historical time-series data for individual Amazon products (ASINs) powered by Keepa. It returns timestamped data points for various metrics, allowing trend analysis over a configurable time window (up to 365 days). Each query targets a single ASIN in a specific Amazon marketplace.
Time-series format: All data series are returned as arrays of 
{time, value}
objects, where 
time
is a timestamp and 
value
is the metric at that point. BSR data includes a 
categoryName
field along with a 
points
array.
BSR logic: A smaller BSR value means a better sales rank. Rank 1 is the top-selling product in its category. When a user says "BSR improved", it means the numeric value decreased; "BSR dropped" means the value increased.
本工具基于Keepa提供单个亚马逊商品（ASIN）的历史时序数据。它会返回带时间戳的各类指标数据点，支持在可配置的时间窗口（最长365天）内进行趋势分析。每次查询针对特定亚马逊站点中的单个ASIN。
时序数据格式：所有数据系列均以
{time, value}
对象数组形式返回，其中
time
为时间戳，
value
为该时间点的指标数值。BSR数据包含
categoryName
字段以及
points
数组。
BSR逻辑：BSR数值越小，代表销售排名越好。排名1是该品类中的畅销商品。当用户说"BSR提升"时，意味着其数值降低；"BSR下降"则意味着数值升高。

Available Data Series

可用数据系列

SeriesParameterDescription
Buy Box Price(always returned)Buy Box price over time
Lowest New PriceshowPrice=1Lowest marketplace new item price
List PriceshowPriceList=1Strikethrough / list price
Deal PriceshowPriceDeal=1Lightning deal price
Prime Exclusive PriceshowPricePrime=1Prime-exclusive new item price
FBA PriceshowPriceFba=1Third-party FBA new item price
FBM PriceshowPriceFbm=1Third-party FBM new item price
Coupon PriceshowPriceCoupon=1Post-coupon Buy Box price
Main Category BSRshowBsrMain=1Best Sellers Rank in the main (root) category
Seller CountshowSellerCount=1Number of active sellers
Rating(always returned)Product star rating over time
Rating Count(always returned)Number of ratings over time
Monthly Sales(always returned)Monthly unit sales volume
Sub-category BSR(always returned)Best Sellers Rank in sub-categories
数据系列参数描述
Buy Box价格(默认返回)随时间变化的Buy Box价格
最低全新价showPrice=1平台上全新商品的最低价格
标价showPriceList=1划掉的标价 / 建议零售价
促销价showPriceDeal=1限时秒杀价格
Prime专属价showPricePrime=1Prime会员专属的全新商品价格
FBA价格showPriceFba=1第三方卖家FBA配送的全新商品价格
FBM价格showPriceFbm=1第三方卖家自配送的全新商品价格
优惠券后价格showPriceCoupon=1使用优惠券后的Buy Box价格
主品类BSRshowBsrMain=1主（根）品类中的畅销排名
卖家数量showSellerCount=1活跃卖家数量
评分(默认返回)商品星级评分随时间的变化
评分数量(默认返回)评分总数随时间的变化
月销量(默认返回)月度商品销量
子品类BSR(默认返回)子品类中的畅销排名

Supported Marketplaces

支持的站点

Domain IDMarketplace
1Amazon.com (US)
2Amazon.co.uk (UK)
3Amazon.de (Germany)
4Amazon.fr (France)
5Amazon.co.jp (Japan)
6Amazon.ca (Canada)
8Amazon.it (Italy)
9Amazon.es (Spain)
10Amazon.in (India)
11Amazon.com.mx (Mexico)
12Amazon.com.br (Brazil)
Default marketplace is 1 (US). Use domain=1 when the user does not specify a marketplace.
域名ID站点
1Amazon.com（美国）
2Amazon.co.uk（英国）
3Amazon.de（德国）
4Amazon.fr（法国）
5Amazon.co.jp（日本）
6Amazon.ca（加拿大）
8Amazon.it（意大利）
9Amazon.es（西班牙）
10Amazon.in（印度）
11Amazon.com.mx（墨西哥）
12Amazon.com.br（巴西）
默认站点为1（美国）。当用户未指定站点时，使用domain=1。

API Usage

API使用说明

This tool calls the LinkFox tool gateway API. See 
references/api.md
for calling conventions, request parameters, and response structure. You can also execute 
scripts/keepa_product_history.py
directly to run queries.
本工具调用LinkFox工具网关API。调用规范、请求参数及响应结构请参考
references/api.md
。您也可以直接执行
scripts/keepa_product_history.py
来运行查询。

Parameter Guide

参数指南

Required Parameters

必填参数

  • asin: The Amazon Standard Identification Number to query. Only a single ASIN per request is supported.
  • domain: The Amazon marketplace domain ID (see table above). Always map the user's marketplace mention to the correct numeric ID.
  • asin：要查询的亚马逊标准识别码（ASIN）。每次请求仅支持单个ASIN。
  • domain：亚马逊站点的域名ID（见上表）。需将用户提及的站点映射为正确的数字ID。

Optional Parameters

可选参数

  • days: Number of historical days to retrieve (1-365, default 90). Use 30 for short-term, 90 for medium-term, 365 for long-term analysis.
  • show* flags: Set any 
    show*
    parameter to 
    1
    to include that data series. By default, only the core series (Buy Box price, rating, rating count, monthly sales, sub-category BSR) are returned.
  • days：要获取的历史天数（1-365，默认90）。短期分析用30天，中期用90天，长期分析用365天。
  • show 标志*：将任意
    show*
    参数设为
    1
    即可包含对应的数据系列。默认仅返回核心数据系列（Buy Box价格、评分、评分数量、月销量、子品类BSR）。

How to Choose Parameters

参数选择方法

  1. Price analysis: Enable 
    showPrice
    , 
    showPriceList
    , 
    showPriceDeal
    , 
    showPriceCoupon
    as needed for the specific price comparison the user wants.
  2. FBA vs FBM comparison: Enable both 
    showPriceFba
    and 
    showPriceFbm
    .
  3. BSR deep-dive: Enable 
    showBsrMain
    to get the root category BSR alongside the always-returned sub-category BSR.
  4. Competitive landscape: Enable 
    showSellerCount
    to see how many sellers are competing.
  5. Full product overview: Enable all show flags for a comprehensive historical snapshot.
  1. 价格分析：根据用户所需的具体价格对比需求，启用
    showPrice
    、
    showPriceList
    、
    showPriceDeal
    、
    showPriceCoupon
    。
  2. FBA与FBM对比：同时启用
    showPriceFba
    和
    showPriceFbm
    。
  3. BSR深度分析：启用
    showBsrMain
    ，在默认返回的子品类BSR之外获取根品类BSR数据。
  4. 竞争态势分析：启用
    showSellerCount
    查看当前竞争的卖家数量。
  5. 商品全面概览：启用所有show标志，获取完整的历史快照。

Usage Examples

使用示例

1. Basic price history for a US product
asin: B0XXXXXXXX, domain: 1, days: 90
2. Long-term BSR trend (1 year) on the German marketplace
asin: B0XXXXXXXX, domain: 3, days: 365, showBsrMain: 1
3. Price comparison across fulfillment channels
asin: B0XXXXXXXX, domain: 1, days: 30, showPriceFba: 1, showPriceFbm: 1, showPrice: 1
4. Deal and coupon price tracking
asin: B0XXXXXXXX, domain: 1, days: 90, showPriceDeal: 1, showPriceCoupon: 1
5. Full product health check
asin: B0XXXXXXXX, domain: 1, days: 90, showPrice: 1, showPriceList: 1, showPriceDeal: 1, showPricePrime: 1, showPriceFba: 1, showPriceFbm: 1, showPriceCoupon: 1, showBsrMain: 1, showSellerCount: 1
1. 美国站点商品的基础价格历史查询
asin: B0XXXXXXXX, domain: 1, days: 90
2. 德国站点商品的长期BSR趋势（1年）
asin: B0XXXXXXXX, domain: 3, days: 365, showBsrMain: 1
3. 不同配送渠道的价格对比
asin: B0XXXXXXXX, domain: 1, days: 30, showPriceFba: 1, showPriceFbm: 1, showPrice: 1
4. 促销与优惠券价格追踪
asin: B0XXXXXXXX, domain: 1, days: 90, showPriceDeal: 1, showPriceCoupon: 1
5. 商品健康状况全面检查
asin: B0XXXXXXXX, domain: 1, days: 90, showPrice: 1, showPriceList: 1, showPriceDeal: 1, showPricePrime: 1, showPriceFba: 1, showPriceFbm: 1, showPriceCoupon: 1, showBsrMain: 1, showSellerCount: 1

Display Rules

展示规则

  1. Present data clearly: Show time-series data in tables or describe trends; avoid subjective business advice unless the user explicitly asks for it.
  2. BSR clarification: When showing BSR data, remind users that lower values mean better (higher) sales ranks.
  3. Price formatting: Display prices with proper currency symbols matching the marketplace ($ for US, EUR for DE/FR/ES/IT, GBP for UK, JPY for JP, etc.).
  4. Time formatting: Present timestamps in a human-readable date format.
  5. Trend summarization: When data series are long, summarize the overall trend (e.g., "price decreased from $29.99 to $24.99 over 90 days") and highlight significant changes such as price drops, BSR spikes, or rating shifts.
  6. Error handling: When a query fails, explain the reason and suggest corrections (e.g., verify the ASIN is valid, check the marketplace domain ID).
  7. Single ASIN limitation: If the user asks about multiple ASINs, inform them that queries must be made one ASIN at a time, and run multiple sequential calls.
  1. 清晰呈现数据：以表格形式展示时序数据或描述趋势；除非用户明确要求，否则避免提供主观商业建议。
  2. BSR说明：展示BSR数据时，提醒用户数值越小代表销售排名越靠前（越好）。
  3. 价格格式：显示价格时使用与站点匹配的正确货币符号（美国用$，德/法/西/意用EUR，英国用GBP，日本用JPY等）。
  4. 时间格式：以人类易读的日期格式呈现时间戳。
  5. 趋势总结：当数据系列较长时，总结整体趋势（例如：“90天内价格从$29.99降至$24.99”），并突出重大变化，如价格下跌、BSR骤变或评分波动。
  6. 错误处理：查询失败时，说明原因并建议修正方案（例如：验证ASIN是否有效，检查站点域名ID是否正确）。
  7. 单个ASIN限制：如果用户询问多个ASIN，告知用户每次查询只能针对一个ASIN，需进行多次连续查询。

Important Limitations

重要限制

  • Single ASIN per query: Only one ASIN can be queried at a time. For multi-ASIN comparisons, make separate requests.
  • Maximum 365 days: Historical data is limited to at most 365 days back.
  • Data granularity: Data points are at irregular intervals depending on when Keepa captured changes, not at fixed daily intervals.
  • 每次查询单个ASIN：每次仅能查询一个ASIN。如需多ASIN对比，请发起单独请求。
  • 最长365天：历史数据最多可追溯至365天前。
  • 数据粒度：数据点的间隔不固定，取决于Keepa捕获数据变化的时间，并非每日固定间隔。

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable -- Historical product-level data queries on Amazon:
User SaysScenario
"What's the price history for this ASIN"Price trend analysis
"Show me the BSR trend", "how is it ranking"BSR tracking
"Has the price dropped recently", "any deals"Price drop / deal detection
"How many sellers are on this listing"Seller count trend
"What's the rating trend", "review count over time"Rating / review tracking
"FBA vs FBM price", "who has the Buy Box"Fulfillment price comparison
"Monthly sales for this product"Sales volume trend
"Was there a price war on this ASIN"Competitive pricing analysis
"Show me the Keepa chart", "Keepa data"Explicit Keepa data requests
Not applicable -- Needs beyond product-level historical data:
  • Search term / keyword analysis (use ABA data instead)
  • Advertising / PPC campaign data
  • Listing copywriting or content optimization
  • Category-wide or market-level aggregate trends (this tool is per-ASIN only)
  • Real-time inventory or stock level checks
  • Product reviews text or sentiment analysis
Boundary judgment: When users say "product research" or "competitor analysis", if it boils down to examining a specific ASIN's historical price, BSR, or sales data, this skill applies. If they need keyword data, market-wide trends, or advertising metrics, it does not apply.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in 
references/api.md
. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.
适用场景 -- 亚马逊商品级历史数据查询：
用户表述场景
"这个ASIN的价格历史是怎样的"价格趋势分析
"展示BSR趋势"、"排名情况如何"BSR追踪
"最近价格有没有下降"、"有没有促销活动"降价/促销检测
"这个Listing有多少卖家"卖家数量趋势
"评分趋势如何"、"评论数量随时间变化情况"评分/评论追踪
"FBA vs FBM价格"、"谁拥有Buy Box"配送渠道价格对比
"这个商品的月销量"销量趋势
"这个ASIN有没有价格战"竞争定价分析
"展示Keepa图表"、"Keepa数据"明确请求Keepa数据
不适用场景 -- 超出商品级历史数据的需求：
  • 搜索词/关键词分析（请使用ABA数据）
  • 广告/PPC活动数据
  • Listing文案或内容优化
  • 品类或市场层面的整体趋势（本工具仅支持单ASIN查询）
  • 实时库存或库存水平查询
  • 商品评论文本或情感分析
边界判断：当用户提到"商品调研"或"竞品分析"时，如果核心需求是查看特定ASIN的历史价格、BSR或销量数据，则适用本技能；如果需要关键词数据、市场整体趋势或广告指标，则不适用。
反馈：
当出现以下任意情况时，自动检测并通过反馈API提交反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 技能结果与用户意图不符
  3. 用户表达了对本技能的不满或赞扬
  4. 任何您认为可以改进的内容
请按照
references/api.md
中的指定方式调用反馈API，不要打断用户的操作流程。
如需更多高品质、专业的跨境电商技能，请访问LinkFox Skills。