К основному содержанию
скилл CX Codex

linkfox-keepa-product-request — скилл для Claude Code

Скилл linkfox-keepa-product-request для Claude Code, Codex, Cursor и других клиентов запрашивает параметры товаров Amazon через Keepa. Извлекает цены, габариты, продажи и FBA-комиссии по списку ASIN.

MIT 233 установок ★ 125 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-request -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/linkfox-keepa-product-request/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Данные и базы» →
Ecommerce Data API ecommercedataapi MCP-сервер Ecommerce Data API предоставляет ИИ-ассистентам сведения о товарах, поисковом спросе, продажах и товарных знаках Amazon. Помогает оценивать ниши и конкурентов прямо в чате. CX Codex +1 amazon-sales-estimator nexscope-ai Скилл amazon-sales-estimator для Claude Code и Codex, оценивает объёмы продаж на Amazon по BSR, ASIN или ключевому слову на 12 маркетплейсах без API-ключей. CX Codex +1 1 300установок amazon-product-research nexscope-ai Скилл amazon-product-research анализирует спрос, конкуренцию и маржинальность товаров на маркетплейсах Amazon. Помогает оценить нишу и затраты на FBA перед закупкой партии. CX Codex +1 78 400установок Easyparser — Amazon Product & Seller Data easyparser-com Easyparser — Amazon Product & Seller Data — MCP-сервер для Claude Code: агент получает карточки товаров, офферы продавцов и историю продаж Amazon в 21 маркетплейсе. CX Codex +1 muapi-amazon-product-listing SamurAIGPT Скилл muapi-amazon-product-listing для Claude Code, который собирает полный набор изображений для карточки товара на Amazon: главное фото на белом фоне, lifestyle-кадр, инфографику с характеристиками и макроснимок деталей. CX Codex +1 671установок Canopy API canopy-api MCP-сервер Canopy API подключает Claude Code к данным Amazon: поиску товаров, ценам, отзывам и предложениям продавцов. Он помогает исследовать товары и проверять ASIN. CX Codex +1 ★ 4звёзд репо

Из того же набора74

Весь набор →
linkfox-ruiguan-text-trademark-detection Скилл linkfox-ruiguan-text-trademark-detection для Claude Code и Codex проверяет названия, описания и ключевые слова товаров на совпадения с текстовыми товарными знаками. Отдаёт оценку риска, данные регистрации и списки исключений. CX Codex +1 235установок linkfox-echotik-list-new-product-rank Скилл linkfox-echotik-list-new-product-rank для Claude Code показывает рейтинги новых товаров TikTok Shop по региональным рынкам. Выводит продажи, цены и показатели продвижения авторами, видео и трансляциями. CX Codex +1 234установок linkfox-ruiguan-copyright-detection Скилл linkfox-ruiguan-copyright-detection для Claude Code проверяет изображения на совпадения с зарегистрированными произведениями. Показывает правообладателей, источники, сигналы риска и историю TRO. CX Codex +1 234установок linkfox-zhihuiya-description-data-translated Скилл linkfox-zhihuiya-description-data-translated для Claude Code, Codex и Cursor загружает перевод описания патента из PatSnap на китайском, английском или японском языке. Ищет по ID или номеру публикации, включая патентные семейства. CX Codex +1 234установок linkfox-sorftime-amazon-product-detail Скилл linkfox-sorftime-amazon-product-detail для Claude Code и Codex выгружает данные о товаре на Amazon по коду ASIN через Sorftime. Собирает историю продаж, динамику BSR, комиссии FBA и цены на 14 региональных сайтах площадки. CX Codex +1 233установок linkfox-ruiguan-detection-patent-design Скилл linkfox-ruiguan-detection-patent-design для Claude Code, Codex, Cursor и других агентов ищет похожие патенты на внешний вид по фотографии или эскизу продукта через базу 睿观. CX Codex +1 233установок linkfox-zhihuiya-claim-data-translated Скилл linkfox-zhihuiya-claim-data-translated для Claude Code, Codex и Cursor, запрашивающий переводы формулы изобретения из базы PatSnap. Помогает изучать объём патентных прав на китайском, английском или японском языке. CX Codex +1 233установок linkfox-seerfar-ozon-market-keyword-search Скилл linkfox-seerfar-ozon-market-keyword-search для Claude Code ищет и сортирует ключевые слова Ozon и Wildberries по спросу, росту и конкуренции, помогая находить популярные запросы и русскоязычные длинные хвосты. CX Codex +1 232установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой