linkfox-keepa-product-request — скилл для Claude Code
Скилл linkfox-keepa-product-request для Claude Code, Codex, Cursor и других клиентов запрашивает параметры товаров Amazon через Keepa. Извлекает цены, габариты, продажи и FBA-комиссии по списку ASIN.
MIT 233 установок ★ 125 обновлён 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-codeЧто делает linkfox-keepa-product-request
Инструмент извлекает структурированные данные карточек Amazon: текущую стоимость, Item Highlights, дату публикации, вес, рейтинг, категорию, варианты и динамику продаж за 12 месяцев. В пакет входит скрипт python scripts/keepa_product_detail.py, выполняющий запросы к API с локальным кэшированием на 24 часа.
Полные ответы сохраняются в файл JSON внутри рабочей директории в каталоге linkfox/<YYYY-MM-DD>/<session>/data/. Если размер ответа превышает 8 KB, в консоль выводится только короткая сводка, чтобы не перегружать контекст агента.
Для работы требуется настроенная переменная окружения LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Запросы расходуют платные токены Keepa с коэффициентом 0.045, поэтому скилл не запускается без подтверждения цены пользователем при повторных или объемных вызовах.
Какие задачи решает
- получить габариты, вес и материалы товара Amazon по ASIN
- сравнить цены и комиссии FBA для нескольких конкурирующих ASIN
- проверить динамику продаж товара за последние 12 месяцев
- извлечь блок Item Highlights без чтения полного описания листинга
Примеры запросов агенту
- Проверь параметры и габариты для ASIN B0088PUEPK на американском Amazon
- Сравни продажи и комиссии FBA для ASIN B0088PUEPK, B00U26V4VQ на немецком Amazon с историей
- Покажи Item Highlights и категорию для ASIN B09V3KXJPB на японском Amazon
Как установить linkfox-keepa-product-request
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-code2Вручную: положить файлы
~/.claude/skills/linkfox-keepa-product-request/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/linkfox-keepa-product-request/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a codex2Вручную: положить файлы
.agents/skills/linkfox-keepa-product-request/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a cursor2Вручную: положить файлы
.cursor/skills/linkfox-keepa-product-request/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-keepa-product-request2Вручную: положить файлы
.github/skills/linkfox-keepa-product-request/SKILL.md1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a gemini-cli2Командой платформы
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-keepa-product-requestВручную: положить файлы
.devin/skills/linkfox-keepa-product-request/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о linkfox-keepa-product-request
Как установить linkfox-keepa-product-request в Claude Code?
Выполните команду npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-code. Файл конфигурации сохранится в ~/.claude/skills/linkfox-keepa-product-request/SKILL.md.
Что делает linkfox-keepa-product-request?
Он отправляет запросы к Keepa по заданным ASIN и маркетплейсам Amazon. Агент получает цены, габариты, рейтинги, комиссии доставки и помесячную историю продаж.
Какие ключи нужны для работы скилла?
Нужен ключ LinkFox, указанный в переменной LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Без него сервер возвращает статус 401.
Исходный текст
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