Skip to main content
skill CX Codex

linkfox-sorftime-amazon-product-detail — Claude Code skill

linkfox-sorftime-amazon-product-detail — a skill for Claude Code and Codex that pulls Amazon listing metrics and trends by ASIN via Sorftime. Gathers sales volume, BSR history, FBA fees, and pricing across 14 marketplaces.

MIT 233 installs ★ 125 updated 2026-11-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a claude-code
Open on GitHub

What linkfox-sorftime-amazon-product-detail does

Supported across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. When provided with an ASIN and marketplace, it retrieves detailed listing records: estimated revenue, Buybox sellers, review breakdowns, parent-child variation trees, and profit margins. Time-series records for sales and category BSR reach as far back as 2021.

Queries run through an API endpoint or via python scripts/sorftime_product_detail.py '<JSON>'. The script stores responses locally in the workspace directory under linkfox/ and caches outputs for 24 hours. Without a configured LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY, calls fail with HTTP 401. Each run consumes compute balance based on Sorftime query multiplier rules, requiring confirmation before pulling heavy historical datasets.

What it helps with

  • pull historical sales and price changes for a specific ASIN
  • break down FBA storage and fulfillment costs to calculate product margins
  • monitor category BSR ranking movements across custom time intervals
  • compare several ASINs side-by-side within the same regional marketplace

Example prompts for the agent

  • Check listing details and recent sales trends for ASIN B00FLYWNYQ on Amazon US
  • Compare BSR ranking history and FBA fee structures for B0088PUEPK and B00U26V4VQ
  • Pull price changes and coupon history for B0CVM8TXHP in Germany from June 2024

How to install linkfox-sorftime-amazon-product-detail

1Skills CLI (Vercel)

npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a claude-code

2Manually: put the files in place

~/.claude/skills/linkfox-sorftime-amazon-product-detail/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/linkfox-sorftime-amazon-product-detail/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about linkfox-sorftime-amazon-product-detail

How to install linkfox-sorftime-amazon-product-detail in Claude Code?

Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a claude-code.

What does linkfox-sorftime-amazon-product-detail do?

It queries Sorftime data to inspect Amazon ASIN performance, pulling sales figures, BSR rank shifts, parent-child variations, and FBA expenses.

What credentials are required to use this skill?

You need an active API key stored in LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY, along with Python in your environment.

Source text

SKILL.md · MIT
---
name: linkfox-sorftime-amazon-product-detail
description: 基于 Sorftime 数据按 ASIN 查询亚马逊商品详情与历史趋势,覆盖 14 个站点,提供销量与销售额、价格与促销、多级 BSR、变体、评分、卖家、利润和 FBA 费用信息。适用于指定商品查询、趋势回顾及多商品对比,无需明确提及 Sorftime。不适用于跨市场搜品筛选、ABA 搜索词排名、广告策略、评论正文分析或专利商标检查。
---

# Sorftime 亚马逊商品详情与趋势

## 适用范围

### 适用

用户已有具体 ASIN,希望查看商品资料、经营指标或历史变化时使用。用户说“产品分析”或“竞品对比”且实际需要查询指定 ASIN 的详情和趋势时,也适用。

**场景速查**

| 用户表达 | 查询场景 |
|----------|----------|
| 查一下这个 ASIN 的销量走势 | 日销量、月销量与销售额趋势。 |
| 这个产品最近价格变化如何 | 售价、原价与促销历史。 |
| 帮我看看这个产品的利润空间 | 利润金额、利润率与费用构成。 |
| 这个 ASIN 的 BSR 排名趋势 | 大类及小类排名历史。 |
| 对比一下这几个 ASIN 的数据 | 同站点多商品对比。 |
| 这个产品的 FBA 费用是多少 | FBA 费用及配送、仓储明细。 |
| 产品上架多久了,评分怎么样 | 上架时间、在售天数、评分及星级占比。 |
| 这个产品还在售吗 | 在售或下架状态。 |
| 这个产品有没有 Deal 促销记录 | Deal 历史与其他促销。 |
| 看看这个产品的变体信息 | 父子 ASIN、变体数及属性。 |

### 边界

按类目、品牌或卖家发现和筛选商品时,使用 Sorftime 商品搜索技能。ABA 搜索词排名使用对应 ABA 数据技能;广告策略、评论正文分析和专利商标检查不在本技能范围。

## 前置条件

先确定待查商品的 ASIN 和目标站点。站点选择、默认值及趋势范围约定见 `references/api.md`。

## 查询流程

1. 判断用户需要指定商品详情还是跨市场发现商品,确认 ASIN 与站点;按 `references/api.md` 准备查询。
2. 根据目标选择仅查资料或包含趋势;历史分析按用户需要确定日期范围,多商品对比优先在同站点批量查询,具体限制见接口参考。
3. 调用前说明动态计费方式及本次范围可能带来的额外消耗,由用户决定是否继续;复用已有结果与本地缓存。
4. 查询后先判断公共响应状态,再判断业务结果;失败时根据返回消息解释原因,后续调用遵守成本约束。
5. 从保存的数据按需提取指标,用表格展示商品对比或趋势关键日期,遵守下方展示建议。

## 执行方式

- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/sorftime_product_detail.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

### 输出策略

- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-amazon-product-detail-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

## 执行规则

### 算力消耗预估

按动态规则计费:消耗算力 = Sorftime 内部查询次数 × 6。不同查询条件所需的内部查询次数可能不同,由 Sorftime 决定;趋势范围的额外计费约定见 `references/api.md`。

> **重要**:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。

**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

### 解决认证和算力问题

出现以下情况时,按 `references/onboarding.md` 的指引处理:

- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

### 约束与建议

- **理解数据范围**:本技能提供单商品资料及时间序列,历史趋势可追溯至 2021 年,实际以返回数据为准。可展示基本资料与主图/A+ 图片、父子变体、价格与利润、官方月销量、类目排名、评分分布、Buybox 卖家、Listing 特征和促销;完整字段定义见 `references/api.md`。
- **清晰展示数据**:只呈现查询所得数据,用表格说明指标,不附加主观经营建议;注明站点、日期范围和更新时间。
- **解释排名**:展示 BSR 时提醒用户数值越小排名越靠前,并区分大类和小类。
- **区分金额口径**:展示趋势金额时按当地货币单位换算,美元美分转换为美元;区分扣除 Coupon 后的当前售价与未扣 Coupon 的售价趋势,具体单位和特殊值见接口参考。
- **解释无法预估的数据**:销量或销售额不可用时标为“无法预估”,不要把缺失值当成零销量。非标准类目情形见接口参考。
- **展示趋势关键点**:先按接口参考的交错格式还原日期和值,用可读的表格呈现,避免直接输出原始数组。
- **说明在售状态**:商品下架或不可售时明确告知用户。
- **解释错误**:结合接口参考及实际返回的消息说明失败原因,可建议核对查询条件;再次调用前说明额外消耗。

## 使用示例

### 快速查看商品

用户:查一下 B00FLYWNYQ 的商品资料和近期走势。

未指定站点时按接口参考采用默认站点;说明费用后查询,展示资料与近期趋势。

### 长区间趋势与 BSR 历史

用户:查看这个美国站商品 2025 年第一季度的销量趋势,或这个德国站商品 2024 年 6 月至 2025 年 1 月的 BSR 历史。

按用户指定站点和日期范围准备查询,说明趋势范围对应的额外费用后执行,按日期展示关键数据。

### 多商品对比或仅查资料

用户:对比 B0088PUEPK、B00U26V4VQ、B0CVM8TXHP;只需要基本资料时不查趋势。

按接口参考批量查询,按需关闭趋势以减少消耗、缩短响应时间,用表格比较已有数据。

## 使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。

---

更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。

© linkfox-ai · MIT · linkfox-ai/linkfox-skills

Similar skills

All skills for Data and databases →

From the same set74

The whole set →
linkfox-echotik-list-new-product-rank The linkfox-echotik-list-new-product-rank Claude Code skill fetches EchoTik rankings for new TikTok Shop products by market. It shows sales, prices, and creator, video, and livestream activity. CX Codex +1 234installs linkfox-ruiguan-copyright-detection linkfox-ruiguan-copyright-detection — a skill for Claude Code checks images against registered copyright works. It returns rights-holder details, source records, radar findings, and TRO history. CX Codex +1 234installs linkfox-zhihuiya-description-data-translated linkfox-zhihuiya-description-data-translated — a skill for Claude Code, Codex, and Cursor that retrieves translated patent descriptions from PatSnap in English, Chinese, or Japanese. Queries by patent ID or publication number. CX Codex +1 234installs linkfox-keepa-product-request 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. CX Codex +1 233installs linkfox-ruiguan-detection-patent-design linkfox-ruiguan-detection-patent-design is a Claude Code skill that searches 睿观 for design patents similar to a product image or sketch before listing, surfacing TRO history and AI-radar risk. CX Codex +1 233installs linkfox-zhihuiya-claim-data-translated linkfox-zhihuiya-claim-data-translated is a Claude Code skill that retrieves translated patent claims from PatSnap to examine protection scopes. CX Codex +1 233installs linkfox-seerfar-ozon-market-keyword-search The linkfox-seerfar-ozon-market-keyword-search Claude Code skill finds and ranks Ozon market keywords by demand, growth, and competition. It can surface popular searches, rising terms, and Russian long-tail variations. CX Codex +1 232installs linkfox-seerfar-ozon-category-search linkfox-seerfar-ozon-category-search — a skill for Claude Code and Codex that pulls Ozon category analytics from the Seerfar database. It retrieves niche volume, average prices, seasonality, and ranked product lists. CX Codex +1 232installs

Project sponsors

Companies that keep this analytics open