linkfox-keepa-product-request — Claude Code skill: setup & use
linkfox-keepa-product-request — a skill for Claude Code, Codex, Cursor, and related agents to pull Amazon product specs via Keepa. It extracts pricing, dimensions, sales history, and FBA fees directly by ASIN.
MIT 233 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-codeWhat linkfox-keepa-product-request does
The tool retrieves Amazon ASIN metadata, including current price, Item Highlights, release dates, package weight, category ranking, parent-variation relationships, and 12-month sales figures. Execution runs via python scripts/keepa_product_detail.py, utilizing a 24-hour local cache to avoid duplicate API calls.
Payloads are written under <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-keepa-product-request-<timestamp>.json. Responses larger than 8 KB print only top-level fields and sample counts to standard output unless the --inline flag is set.
A configured LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY environment variable is required. Queries consume paid Keepa units calculated as 0.045 per token, requiring explicit user approval before execution.
What it helps with
- extract dimensions, materials, and weight for an Amazon ASIN
- compare prices, variants, and FBA fees across multiple competitor ASINs
- check monthly sales trends over the past 12 months for a target product
- isolate Item Highlights without parsing full description copy
Example prompts for the agent
- Look up item details, price, and dimensions for ASIN B0088PUEPK on the US store
- Compare historical sales and FBA fees for ASINs B0088PUEPK and B00U26V4VQ on domain 3
- Get category, rating, and itemHighlights for ASIN B09V3KXJPB on Amazon Japan
How to install linkfox-keepa-product-request
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-keepa-product-request/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-keepa-product-request/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a codex2Manually: put the files in place
.agents/skills/linkfox-keepa-product-request/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a cursor2Manually: put the files in place
.cursor/skills/linkfox-keepa-product-request/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-keepa-product-request2Manually: put the files in place
.github/skills/linkfox-keepa-product-request/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-keepa-product-requestManually: put the files in place
.devin/skills/linkfox-keepa-product-request/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-keepa-product-request
How to install linkfox-keepa-product-request in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-code. The file will be written to ~/.claude/skills/linkfox-keepa-product-request/SKILL.md.
What does linkfox-keepa-product-request do?
It queries Keepa endpoints for specified Amazon ASINs across international domains. The skill returns structured metrics covering pricing, monthly sales trends, ratings, and dimensions.
What credentials are required to run this skill?
You need an active LinkFox token exported as LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY. Missing keys result in 401 errors.
Source text
SKILL.md · MIT
---
name: linkfox-keepa-product-request
description: 根据一个或多个亚马逊 ASIN 查询 Keepa 商品详情,获取价格、标题、Item Highlights(商品亮点)、图片、上架时间、材质、尺寸重量、月销量及近 12 个月销量、销售排名、评分、类目、变体和 FBA 费用。适用于指定 ASIN 的商品核验、批量对比和销量趋势分析,无需明确提及 Keepa。不适用于关键词选品、无 ASIN 的市场研究、完整描述或评论正文获取、生成 Listing 文案、广告或店铺分析,以及价格或 Buy Box 历史图表。
---
# Keepa 亚马逊商品详情
## 适用范围
### 适用
用户已提供具体 ASIN,希望取得商品结构化数据,或比较多个竞品的价格、销量、规格及类目时,使用本技能。“选品调研”“竞品分析”也按是否具有明确 ASIN 和商品数据需求判断。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| 查这个 ASIN 的商品详情、价格或规格 | 单品核验:标题、价格、品牌、材质及尺寸重量。 |
| 查标题之外的 Item Highlights / itemHighlights | 单独展示已有商品亮点。 |
| 比较这几个 ASIN | 批量对比商品指标。 |
| 这个商品一个月卖多少,过去一年趋势如何 | 当前销量与历史月销量分析。 |
| 这个商品属于什么类目,评分和评论数多少 | 类目、销售排名及评价数量核验。 |
| 什么时候上架,有多少变体 | 上架时间、父 ASIN 与变体信息核验。 |
| 采用 FBA 还是 FBM,FBA 费用多少 | 配送方式及可用费用数据核验。 |
## 前置条件
先确定用户要查询的 ASIN 与站点,按需读取 `references/api.md` 中的站点映射、参数及接口使用限制;查询历史趋势前明确用户需要历史数据。
## 查询流程
1. 核对 ASIN、站点和所需数据范围,按接口定义准备当前信息或历史信息查询;默认值与具体参数约定见 `references/api.md`。
2. 按“算力消耗预估”中的动态计费规则提醒用户,并由用户决定是否继续;在已明确的查询范围内复用同一参数的已有结果,避免重复消耗。
3. 执行查询,先看摘要;需要商品亮点或其他具体字段时,读取已保存的完整响应。
4. 按接口参考判断响应,展示商品对比与可用趋势。错误或空结果时解释原因并建议核对 ASIN、站点;后续查询遵守成本约束。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/keepa_product_detail.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具按“算力消耗预估”中的动态公式消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
### 输出策略
- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-keepa-product-request-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `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`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **区分商品信息**:Item Highlights 是标题之外的短商品信息,与五点描述(`features`)及完整描述不同;从完整响应的 `products[].itemHighlights` 读取,不能只看标准输出摘要或 `columns`。
- **忠实展示亮点**:将原始 Item Highlights 与 `title` 分开展示。缺失、`null` 或空白时标注“未返回/不可用”,不得推断亚马逊页面没有亮点,也不得用标题、五点或描述拼造。
- **分组展示数据**:用表格归类价格、销量、尺寸与费用;批量结果先给汇总表,再按用户需要展开单品。价格同时显示响应中的币种,有 `imageUrl` 时展示图片辅助识别。
- **说明趋势与时效**:历史数据可用时,用表格展示各月销量并说明增长、下降或稳定;标明 `lastUpdate`,区分当前值与历史均值,不把缺失月份补成零销量。
- **保持单位明确**:毫米尺寸可同时换算为厘米或英寸,重量按克展示。字段约定为不可用的 `0`、`-1` 值应标为“不适用/不可用”或省略,不作为实际测量值展示。
- **尊重数据范围**:可返回字段、历史数据范围及 Item Highlights 可用性等接口限制见 `references/api.md`,不承诺响应未提供的数据。
## 使用示例
### 查询美国站单品当前信息
```json
{"asin": "B0088PUEPK", "domain": "1"}
```
### 查询历史销量
```json
{"asin": "B0088PUEPK", "domain": "1", "history": 1}
```
### 对比德国站多个 ASIN
```json
{"asin": "B0088PUEPK,B00U26V4VQ,B07M68S376", "domain": "3", "history": 1}
```
### 查询日本站商品
```json
{"asin": "B09V3KXJPB", "domain": "5", "history": 0}
```
### 对比美国站竞品
```json
{"asin": "B0CXYZ1234,B0CXYZ5678,B0CXYZ9012,B0CXYZABCD", "domain": "1", "history": 1}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills