Skip to main content
skill CX Codex

linkfox-keepa-product-series — Claude Code skill: install and use

The linkfox-keepa-product-series Claude Code skill retrieves Amazon Keepa history for an ASIN, covering prices, Buy Box, BSR, ratings, sellers, and sales. It examines a selected site and time range.

MIT 232 installs ★ 125 updated 2026-11-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a claude-code
Open on GitHub

What linkfox-keepa-product-series does

The skill retrieves Keepa time-series data for one ASIN, including price changes, Buy Box, promotions, coupons, FBA/FBM values, BSR, ratings, seller counts, and monthly sales. The agent then summarizes changes by date and marketplace currency from the saved JSON.

A request needs the ASIN, marketplace, time span, and metrics to compare. The skill can call python scripts/keepa_product_history.py '<JSON parameters>' [--inline], save the full response, and extract selected fields with jq or ConvertFrom-Json. These points represent observations over time, not aligned daily measurements.

Keepa usage is billed through tokens: the compute charge is 0.045 × costToken, so the agent must show an estimate before continuing. Authentication uses LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY; 401 and 402 responses are handled through the onboarding instructions.

What it helps with

  • compare FBA, FBM, and Buy Box prices over a period
  • trace price drops and promotion changes
  • follow BSR movement across product categories
  • measure shifts in ratings and review counts
  • compare seller counts with monthly sales

Example prompts for the agent

  • Show the price history for ASIN B0XXXXXXX on Amazon US for the last month.
  • Compare FBA, FBM, and Buy Box prices for this ASIN over the selected period.
  • Analyze BSR, rating, seller count, and monthly sales changes from the saved data.

How to install linkfox-keepa-product-series

1Skills CLI (Vercel)

npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a claude-code

2Manually: put the files in place

~/.claude/skills/linkfox-keepa-product-series/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/linkfox-keepa-product-series/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about linkfox-keepa-product-series

How do I install linkfox-keepa-product-series in Claude Code?

Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a claude-code, then check ~/.claude/skills/linkfox-keepa-product-series/SKILL.md.

What does linkfox-keepa-product-series do?

It retrieves Keepa history for a specific ASIN and analyzes prices, Buy Box, BSR, ratings, sellers, and monthly sales. It can also compare FBA with FBM and mark changes by date.

What does the skill need, and how is usage charged?

Provide an ASIN, marketplace, time range, and metrics, plus either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY. The charge follows 0.045 × costToken, and the user decides whether to continue after seeing the estimate.

Source text

SKILL.md · MIT
---
name: linkfox-keepa-product-series
description: 查询亚马逊商品的 Keepa 历史时序数据,包括 Buy Box 和其他价格走势、BSR 趋势、评分及评分数、卖家数量和月销量。适用于指定 ASIN 的历史定价、促销、FBA/FBM 价格比较、排名及销量变化分析;不适用于关键词和广告分析、市场汇总趋势、实时库存、Listing 文案优化或评论正文与情感分析。
---

# Keepa 亚马逊商品历史趋势

## 适用范围

### 适用

查看指定亚马逊商品在目标站点的历史价格、排名和其他商品指标。用户无需明确提及 Keepa;选品或竞品分析若具体落在某个 ASIN 的历史走势,也适用本技能。

**场景速查**

| 用户表达 | 查询场景 |
|----------|----------|
| 这个 ASIN 以前卖多少钱,最近有没有降价 | 价格历史、降价和波动分析。 |
| 看 BSR 趋势,排名有没有改善 | 大类和小类畅销排名变化。 |
| 看秒杀、Prime 专属价和优惠券价格 | 促销及优惠后的价格走势。 |
| 比较 FBA、FBM 和 Buy Box 价格 | 配送渠道及买盒价格比较。 |
| 卖家数量有没有增加,之前是否打过价格战 | 竞争卖家数量及定价变化。 |
| 评分、评分数和月销量如何变化 | 商品历史表现。 |
| 给我看 Keepa 图表或 Keepa 数据 | 根据实际返回的时序点展示走势。 |

关键词或搜索词研究(包括 ABA)、广告/PPC、Listing 文案、类目或市场汇总、实时库存及评论正文分析不属于本技能范围。

## 前置条件

确定目标 ASIN、站点、历史区间和需要比较的指标。站点映射、默认值、数据系列与使用限制见 `references/api.md`。

## 查询与分析流程

1. 从用户问题确定商品、站点、区间和指标;按 `references/api.md` 准备请求。站点未指定时采用其中约定的美国站默认值,不将类目汇总问题当作商品查询。
2. 按分析目标选择系列:价格分析按需选择最低新品价、标价、促销价和券后价;FBA/FBM 比较同时选择两种渠道价格;BSR 深查包含大类排名;竞争分析包含卖家数量。完整健康检查可选择全部可选系列,具体开关见接口参考。
3. 请求前说明动态算力消耗,并由用户决定是否继续。涉及多个 ASIN 时,按接口参考逐个串行查询并说明额外消耗;同参数优先复用已有数据。
4. 保存响应,先看摘要,再从保存的 JSON 中提取所需系列。按接口参考判断结果;失败或空结果时解释原因、提示核对 ASIN 和站点,后续查询遵守成本约束。
5. 用日期和对应站点币种呈现走势,概括起止变化并指出降价、BSR 波动、评分变化等重要节点;比较多个商品时注明各自站点与区间。

## 执行方式

- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/keepa_product_history.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具按 Keepa token 动态计费,消耗算力 = `0.045 × costToken`。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

### 输出策略

- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-keepa-product-series-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8,000 字节:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8,000 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

## 执行规则

### 算力消耗预估

按动态规则计费:消耗算力 = 0.045 × 本次历史趋势查询消耗的 Keepa token。

本服务按倍数动态计算,单次可能消耗大量算力,必须先提醒用户,由用户决定是否继续。

**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

### 解决认证和算力问题

出现以下情况时,按 `references/onboarding.md` 的指引处理:

- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

### 约束与建议

- **时序概念**:这些是商品指标随时间变化的观测点。数据的采样含义与嵌套结构见 `references/api.md`,不要把各系列直接视为对齐的日数据。
- **直接分析本地数据**:从保存的 JSON 分析即可。`_dataQuery_executeDynamicQuery` 读取的是 SLS 中的 LinkFox 会话数据,并非任意本地 JSON;它支持哪些数据映射,不决定这些时序能否分析。
- **BSR 含义**:数值越小,销量排名越靠前;1 为该类目第一。“排名改善”意味着数值下降;数值上升意味着名次后退,展示时明确这一点,并注明类目名称。
- **客观展示**:用表格或趋势描述呈现数据;除非用户明确要求,不附加主观经营建议。
- **币种与日期**:时间戳转为可读日期;美国用 $/USD,德国、法国、西班牙、意大利用 EUR/€,英国用 GBP/£,日本用 JPY/¥,其他站点匹配其当地币种,避免混用不同站点的价格单位。
- **长序列摘要**:概括整体走势及起止值,例如“价格在所查区间从 $29.99 降至 $24.99”,并标出明显降价、排名突变和评分变化;仅依据实际返回数据,不补造缺失时间点。

## 使用示例

### 美国商品的基本价格历史

用户:看这个 ASIN 在美国站最近一个季度的价格。

采用核心价格系列,说明动态费用后查询并概括起止价及明显波动。

### 德国商品的长期 BSR 趋势

用户:看看这个 ASIN 在德国站过去一年的排名。

选取长期区间及大类排名,结合小类排名展示,说明 BSR 越小越好。

### FBA 与 FBM 价格比较

用户:比较这个商品最近一个月的 FBA、FBM 和最低新品价格。

选择相应价格系列,按实际观测日期和币种呈现差异。

### 促销和优惠券价格

用户:看看这个商品最近的秒杀和券后价格。

选取促销与优惠券价格系列,标出发生明显变化的日期。

### 完整商品历史表现

用户:综合看看这个 ASIN 的 Keepa 历史数据。

确定所需区间,按需选择全部可选系列,结合核心系列概括价格、BSR、卖家数量、评分与销量变化。

## 使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。

---

更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。

© linkfox-ai · MIT · linkfox-ai/linkfox-skills

Similar skills

All skills for Data and databases →

From the same set74

The whole set →
linkfox-ruiguan-detection-patent-design linkfox-ruiguan-detection-patent-design is a Claude Code skill that searches 睿观 for design patents similar to a product image or sketch before listing, surfacing TRO history and AI-radar risk. CX Codex +1 233installs linkfox-zhihuiya-claim-data-translated linkfox-zhihuiya-claim-data-translated is a Claude Code skill that retrieves translated patent claims from PatSnap to examine protection scopes. CX Codex +1 233installs linkfox-seerfar-ozon-market-keyword-search The linkfox-seerfar-ozon-market-keyword-search Claude Code skill finds and ranks Ozon market keywords by demand, growth, and competition. It can surface popular searches, rising terms, and Russian long-tail variations. CX Codex +1 232installs linkfox-seerfar-ozon-category-search linkfox-seerfar-ozon-category-search — a skill for Claude Code and Codex that pulls Ozon category analytics from the Seerfar database. It retrieves niche volume, average prices, seasonality, and ranked product lists. CX Codex +1 232installs linkfox-ai-mode-google-search linkfox-ai-mode-google-search — a skill for Claude Code and Codex that pulls Google AI Overview and AI Mode summaries with citations. It runs for market research, tech comparisons, and public opinion checks. CX Codex +1 232installs linkfox-ruiguan-utility-patent-detection The linkfox-ruiguan-utility-patent-detection Claude Code skill finds similar utility model and invention patents from product details and a target market. It flags records to review before launch. CX Codex +1 232installs linkfox-echotik-get-video-download-url linkfox-echotik-get-video-download-url — a skill for Claude Code, Codex, and Cursor that parses TikTok URLs into direct download links, preview streams, and covers. It requires an existing video link to trigger extraction. CX Codex +1 232installs linkfox-seerfar-ozon-product-report-search linkfox-seerfar-ozon-product-report-search — a skill for Claude Code and Codex that filters Ozon listings via Seerfar by sales and conversion metrics. It outputs SKU-level reports and saves the full JSON locally. CX Codex +1 231installs

Project sponsors

Companies that keep this analytics open