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

linkfox-keepa-product-series — скилл для Claude Code: установка

Скилл linkfox-keepa-product-series для Claude Code запрашивает историю товара Amazon по ASIN: цены, Buy Box, BSR, рейтинг, продавцов и продажи. Анализирует заданный период и нужный сайт.

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

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

Что делает linkfox-keepa-product-series

Скилл получает временные ряды Keepa для конкретного ASIN: цены, Buy Box, скидки и купоны, FBA/FBM, BSR, рейтинг, число оценок, продавцов и месячные продажи. По сохранённому JSON агент описывает изменения по датам и валюте сайта.

Для вызова нужны ASIN, сайт, период и показатели сравнения. Скилл может запускать python scripts/keepa_product_history.py '<JSON параметров>' [--inline], сохранять полный ответ и брать отдельные поля через jq или ConvertFrom-Json. Данные не следует трактовать как выровненные дневные значения: это наблюдения временных рядов.

Запросы тарифицируются по Keepa token: расход вычисляется как 0.045 × costToken, поэтому перед продолжением агент должен показать оценку пользователю. Для аутентификации используются LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY; при ошибках 401 или 402 скилл обращается к инструкциям onboarding.

Какие задачи решает

  • сравнить цены FBA, FBM и Buy Box за период
  • найти снижения цены и изменения промо
  • проследить BSR по большой и малой категории
  • оценить динамику рейтинга и числа оценок
  • сопоставить продавцов и месячные продажи

Примеры запросов агенту

  • Покажи историю цен для ASIN B0XXXXXXX на сайте Amazon US за последний месяц.
  • Сравни для этого ASIN цены FBA, FBM и Buy Box на заданном периоде.
  • Разбери динамику BSR, рейтинга, числа продавцов и месячных продаж по сохранённым данным.

Как установить linkfox-keepa-product-series

1Через Skills CLI (Vercel)

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

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о linkfox-keepa-product-series

Как установить linkfox-keepa-product-series в Claude Code?

Выполните npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a claude-code, затем проверьте файл ~/.claude/skills/linkfox-keepa-product-series/SKILL.md.

Что делает linkfox-keepa-product-series?

Скилл запрашивает исторические ряды Keepa для конкретного ASIN и помогает разобрать цены, Buy Box, BSR, рейтинг, продавцов и месячные продажи. Он также сравнивает FBA и FBM и выделяет изменения по датам.

Что нужно для работы скилла и сколько стоит запрос?

Нужны ASIN, сайт, исторический период, показатели и один из ключей LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Расход считается по формуле 0.045 × costToken, а перед запросом пользователь выбирает, продолжать ли работу.

Исходный текст

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

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

Все скиллы по теме «Данные и базы» →
amazon-sales-estimator nexscope-ai Скилл amazon-sales-estimator для Claude Code и Codex, оценивает объёмы продаж на Amazon по BSR, ASIN или ключевому слову на 12 маркетплейсах без API-ключей. CX Codex +1 1 300установок competitor-price-tracker nexscope-ai Скилл competitor-price-tracker помогает выстроить мониторинг цен конкурентов и отслеживать скидки на Amazon, Shopify или eBay. Пригодится e-commerce проектам для защиты от демпинга и контроля минимальных цен. CX Codex +1 1 200установок Easyparser — Amazon Product & Seller Data easyparser-com Easyparser — Amazon Product & Seller Data — MCP-сервер для Claude Code: агент получает карточки товаров, офферы продавцов и историю продаж Amazon в 21 маркетплейсе. CX Codex +1 Time Series Analysis aj-geddes Скилл Time Series Analysis для Claude Code разбирает временные ряды: ищет тренды, сезонность и автокорреляцию. Помогает строить прогнозы по историческим значениям. CX Codex +1 617установок analyzing-time-series https-deeplearning-ai Скилл analyzing-time-series считает статистику по CSV с временным рядом и объясняет, стационарен ли он, есть ли сезонность и нужны ли разности — до того, как вы выберете модель прогноза. CX Codex +1 1установок Asin asindotdev MCP-сервер Asin для Claude Code следит за товарами Amazon и их ценами. Через него агент ищет товары, ведёт список отслеживания и получает историю цен, предложения и оповещения. CX Codex +1

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

Весь набор →
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установок linkfox-seerfar-ozon-category-search Скилл linkfox-seerfar-ozon-category-search для Claude Code и Codex выгружает аналитику категорий Ozon из базы Seerfar. Находит объёмы продаж, средний чек, сезонность и список лидеров ниши. CX Codex +1 232установок linkfox-ai-mode-google-search Скилл linkfox-ai-mode-google-search для Claude Code и Codex запрашивает сводки Google AI Overview и AI Mode со ссылками на источники. Включается при анализе рынков, сравнении технологий и изучении мнений. CX Codex +1 232установок linkfox-ruiguan-utility-patent-detection Скилл linkfox-ruiguan-utility-patent-detection для Claude Code ищет похожие патенты на полезные модели и изобретения по данным товара и рынку. Помогает провести проверку до выхода на рынок. CX Codex +1 232установок linkfox-echotik-get-video-download-url Скилл linkfox-echotik-get-video-download-url для Claude Code, Codex и Cursor извлекает прямые ссылки на скачивание роликов TikTok, включая варианты без водяного знака и обложки. Нужен готовый URL видео перед вызовом. CX Codex +1 232установок linkfox-seerfar-ozon-product-report-search Скилл linkfox-seerfar-ozon-product-report-search для Claude Code и Codex подбирает товары на Ozon через Seerfar по продажам и конверсии. Возвращает отчёт по конкретным SKU и сохраняет JSON в локальную папку. CX Codex +1 231установок

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

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