mcpField
L
linkfox-keepa-product-history

linkfox-keepa-product-history

github.com/linkfox-ai营销与增长113170 次安装2 周前更新
代码仓库

关于 linkfox-keepa-product-history

该 Skill 使用 Keepa 查询单个 Amazon ASIN 最多 365 天的历史时间序列，供卖家跟踪价格、BSR、评分和销量等指标。可按需选择额外数据系列，数据点按 Keepa 记录的时间变化而非固定日频提供。

主要功能

  1. 01查询最长 365 天历史数据
  2. 02跟踪价格、BSR 和卖家数
  3. 03查看评分、评价数及月销量
  4. 04按需选择价格和排名系列
  5. 05单次查询仅支持一个 ASIN

适用场景

  1. 01查看 Amazon 商品价格变化
  2. 02跟踪商品 BSR 趋势
  3. 03比较 FBA 与 FBM 价格
  4. 04观察评分、卖家数和月销量变化

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-keepa-product-history

安装后在 Claude Code 中输入/linkfox-keepa-product-history确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
scripts/
keepa_product_history.py
response_io.py

详细介绍

Keepa 商品时间序列数据探索器

本技能指导你如何查询和分析 Amazon 商品的历史时间序列数据，帮助 Amazon 卖家跟踪价格走势、BSR 趋势、评分变化及其他关键商品指标随时间的变化。

核心概念

此工具提供由 Keepa 支持的 Amazon 单个商品（ASIN）历史时间序列数据。它会返回各种指标带时间戳的数据点，以便在可配置的时间范围内（最长 365 天）进行趋势分析。每次查询仅针对特定 Amazon 站点中的一个 ASIN。

时间序列格式：所有数据系列都以 {time, value} 对象数组的形式返回，其中 time 是时间戳，value 是该时间点的指标值。BSR 数据包含 categoryName 字段和一个 points 数组。

BSR 逻辑：BSR 数值越小，销售排名越好。排名第 1 表示该品类中的最畅销商品。当用户说“BSR improved”时，表示数值下降；“BSR dropped”表示数值上升。

可用数据系列

系列参数描述
Buy Box 价格(始终返回)Buy Box 价格随时间的变化
最低新品价格showPrice=1站点中最低的新品价格
标价showPriceList=1划线价／标价
促销价格showPriceDeal=1限时秒杀价格
Prime 专享价格showPricePrime=1Prime 专享新品价格
FBA 价格showPriceFba=1第三方 FBA 新品价格
FBM 价格showPriceFbm=1第三方 FBM 新品价格
优惠券价格showPriceCoupon=1使用优惠券后的 Buy Box 价格
主品类 BSRshowBsrMain=1主（根）品类中的畅销商品排名
卖家数量showSellerCount=1活跃卖家数量
评分(始终返回)商品星级评分随时间的变化
评分数量(始终返回)评分数量随时间的变化
月销量(始终返回)月度销量
子品类 BSR(始终返回)子品类中的畅销商品排名

支持的站点

域名 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 用法

此工具调用 LinkFox 工具网关 API。有关调用约定、请求参数和响应结构，请参阅 references/api.md。你也可以直接运行 scripts/keepa_product_history.py 来执行查询。

参数指南

必需参数
  • asin：要查询的 Amazon 标准识别号。每个请求仅支持一个 ASIN。
  • domain：Amazon 站点域名 ID（参见上表）。务必将用户提及的站点映射到正确的数字 ID。
可选参数
  • days：要检索的历史天数（1-365，默认值为 90）。短期分析使用 30，中期分析使用 90，长期分析使用 365。
  • show* 标志：将任意 show* 参数设为 1，即可包含对应的数据系列。默认情况下，仅返回核心系列（Buy Box 价格、评分、评分数量、月销量、子品类 BSR）。
如何选择参数
  1. 价格分析：根据用户所需的具体价格比较，按需启用 showPrice、showPriceList、showPriceDeal、showPriceCoupon。
  2. FBA 与 FBM 比较：同时启用 showPriceFba 和 showPriceFbm。
  3. 深入了解 BSR：启用 showBsrMain，以获取根类别 BSR，以及始终返回的子类别 BSR。
  4. 竞争格局：启用 showSellerCount，查看参与竞争的卖家数量。
  5. 全面了解商品：启用所有 show 标志，获取全面的历史快照。

使用示例

1. 美国商品的基本价格历史

asin: B0XXXXXXXX, domain: 1, days: 90

2. 德国站点 1 年的 BSR 长期趋势

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

显示规则

  1. 清晰呈现数据：使用表格展示时间序列数据或描述趋势；除非用户明确要求，否则避免提供主观的商业建议。
  2. 说明 BSR：展示 BSR 数据时，提醒用户数值越低，销售排名越高。
  3. 价格格式：根据站点使用正确的货币符号显示价格（美国使用 $，德国／法国／西班牙／意大利使用 EUR，英国使用 GBP，日本使用 JPY 等）。
  4. 时间格式：使用易读的日期格式显示时间戳。
  5. 趋势总结：当数据序列较长时，总结整体趋势（例如，“价格在 90 天内从 $29.99 降至 $24.99”），并突出显示价格下跌、BSR 飙升或评分变化等显著变动。
  6. 错误处理：查询失败时，说明原因并建议如何修正（例如，验证 ASIN 是否有效，检查站点域名 ID）。
  7. 单个 ASIN 的限制：如果用户询问多个 ASIN，告知用户必须一次查询一个 ASIN，并依次发起多次调用。

重要限制

  • 每次查询仅限一个 ASIN：一次只能查询一个 ASIN。比较多个 ASIN 时，请分别发起请求。
  • 最多 365 天：历史数据最多可追溯 365 天。
  • 数据粒度：数据点的间隔不固定，取决于 Keepa 记录变更的时间，而非固定的每日间隔。

用户表达与场景速查

适用——Amazon 商品级历史数据查询：

用户表达场景
"这个 ASIN 的价格历史是什么"价格趋势分析
"显示 BSR 趋势""排名怎么样"BSR 跟踪
"最近降价了吗""有优惠吗"降价／优惠检测
"这个商品有多少卖家"卖家数量趋势
"评分趋势是什么""评论数量随时间如何变化"评分／评论跟踪
"FBA 与 FBM 的价格""谁拥有 Buy Box"配送价格对比
"这个商品的月销量"销量趋势
"这个 ASIN 曾发生过价格战吗"竞争性定价分析
"显示 Keepa 图表""Keepa 数据"明确请求 Keepa 数据

不适用——需求超出商品级历史数据：

  • 搜索词／关键词分析（改用 ABA 数据）
  • 广告／PPC 活动数据
  • 商品详情文案撰写或内容优化
  • 类目级或市场级汇总趋势（此工具仅针对单个 ASIN）
  • 实时库存或库存水平查询
  • 商品评论文本或情绪分析

边界判断：当用户提到“商品调研”或“竞品分析”时，如果归根结底是要查看特定 ASIN 的历史价格、BSR 或销量数据，则适用此技能。如果用户需要关键词数据、全市场趋势或广告指标，则不适用。

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并提交反馈：

  1. 此技能描述的功能或用途与实际行为不符
  2. 此技能的结果与用户意图不符
  3. 用户表达了对该技能的不满或赞扬
  4. 你认为有任何可改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/keepa_product_history.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

将 --out-dir 设置在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。保存的响应可能包含 PII、定价或敏感认证数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并且只输出架构预览和文件路径。read 会提取指定字段；可使用 --limit/--offset 进行切片，并使用 --format json|jsonl|csv|table 指定输出格式。

优先采用此模式的情况——请根据响应特征自行判断，例如：

  • 每条记录包含很多字段，或包含不需要的字段
  • 批量／分页结果（每次调用返回多个项目）
  • 长文本字段（描述、评论、HTML、时间序列）
  • 后续步骤会复用输出，而不是立即使用

对于规模较小且只需使用一次的响应，直接调用主脚本即可。

⚠️ 预览内容是经过截断的架构与样本，并非完整数据。任何字段级判断都必须通过 read 从已保存的文件中读取。

如需了解更多高品质、专业的跨境电商技能，请访问 LinkFox Skills。

评论

支持 Markdown