linkfox-keepa-product-series — скилл для Claude Code: установка
Скилл linkfox-keepa-product-series для Claude Code запрашивает историю товара Amazon по ASIN: цены, Buy Box, BSR, рейтинг, продавцов и продажи. Анализирует заданный период и нужный сайт.
MIT 232 установок ★ 125 обновлён 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/linkfox-keepa-product-series/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/linkfox-keepa-product-series/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a codex2Вручную: положить файлы
.agents/skills/linkfox-keepa-product-series/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a cursor2Вручную: положить файлы
.cursor/skills/linkfox-keepa-product-series/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-keepa-product-series2Вручную: положить файлы
.github/skills/linkfox-keepa-product-series/SKILL.md1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a gemini-cli2Командой платформы
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-keepa-product-seriesВручную: положить файлы
.devin/skills/linkfox-keepa-product-series/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-keepa-product-series -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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