Skip to main content
skill CX Codex

linkfox-sorftime-amazon-product-query: Claude Code skill

linkfox-sorftime-amazon-product-query — a skill for Claude Code, Codex, and Cursor that queries Amazon products across 14 marketplaces using Sorftime metrics. Discovers items by category, brand, and historical snapshots.

MIT 231 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-query -a claude-code
Open on GitHub

What linkfox-sorftime-amazon-product-query does

The skill constructs structured queries against Sorftime data across 14 Amazon regions. Filters cover similar ASINs, categories, sellers, brands, ABA search terms, seasonal spikes, and historical monthly records.

Execution relies on the bundled runner python scripts/sorftime_product_search.py. Query results save directly to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/, explicitly barring /tmp paths. When the response exceeds 8 KB, standard output receives a concise summary to prevent context bloat, while jq handles field inspection from the saved JSON file.

Queries cost Sorftime internal calls multiplied by 6, meaning execution halts without a valid LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY. While identical queries stay cached for 24 hours, the tool excludes review sentiment mining, trademark checks, and detailed single-ASIN historical trend lines.

What it helps with

  • find competing items matching a given ASIN across Amazon marketplaces
  • filter category listings by monthly sales thresholds and review scores
  • compare current pricing and BSR figures against past monthly snapshots
  • pull the entire product catalog for a specific merchant or brand

Example prompts for the agent

  • Find wireless chargers with monthly sales over 1000 and rating above 4 stars
  • Show competing items for ASIN B08N5WRWNW on the US marketplace
  • Compare prices and sales in this category against last November

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

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about linkfox-sorftime-amazon-product-query

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

Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-query -a claude-code. The definition is stored at ~/.claude/skills/linkfox-sorftime-amazon-product-query/SKILL.md.

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

It queries Amazon catalog metrics via Sorftime across 14 locales, filtering products by sales, revenue, BSR, and historical monthly snapshots.

What authentication is required before running queries?

Set LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY in your environment. Without a valid key and available balance, requests return 401 or 402 HTTP errors.

Source text

SKILL.md · MIT
---
name: linkfox-sorftime-amazon-product-query
description: 基于 Sorftime 数据搜索和筛选亚马逊商品,覆盖 14 个站点,支持按相似 ASIN、类目、品牌、卖家、ABA 关键词、标题属性、价格、销量、季节性等条件发现和对比商品,并回看历史月份快照。适用于选品探索、竞品发现、类目研究、新品筛选和卖家商品组合研究,无需明确提及 Sorftime。不适用于单个 ASIN 的详细历史趋势、ABA 搜索量或搜索词排名、广告策略、评论正文分析或专利商标核查。
---

# Sorftime 亚马逊产品搜索

## 适用范围

### 适用

按多种条件发现、筛选和比较亚马逊商品,或将历史月份快照与当前数据进行对照。
用户说“竞品分析”或“市场调研”时,若需要从类目、品牌、卖家或其他条件出发寻找商品,使用本技能。

**场景速查**

| 用户表达 | 查询场景 |
|----------|----------|
| 找一下这个类目下卖得好的产品 | 类目探索。 |
| Anker 品牌有哪些热销产品 | 品牌商品组合研究。 |
| 这个 ASIN 的竞品有哪些 | 相似商品发现。 |
| 帮我找一些季节性产品 | 按旺季月份寻找商品。 |
| 新品中月销量超过 500 的有哪些 | 新品与销量组合筛选。 |
| 去年双十一这个类目的价格快照 | 历史月份快照对比。 |
| 这个卖家还卖了什么产品 | 按卖家名称或 ID 查商品组合。 |
| 帮我筛选利润率高于 30% 的 FBA 产品 | 先查配送条件,再按已返回的利润指标整理。 |
| 月销量 1000 以上,评分 4 星以上的产品 | 多条件组合筛选。 |
| 标题包含 wireless charger 的产品 | 标题或属性匹配。 |
| 用 ABA 关键词 Power Bank 找产品 | 按 ABA 关键词寻找商品。 |

### 边界

- 单个 ASIN 的销量、价格、BSR 历史趋势转交 Sorftime 商品详情技能;相似 ASIN 搜索用于发现竞品。
- ABA 搜索量或搜索词排名转交 ABA 数据探索技能。
- 广告或 PPC 策略、评论正文分析、专利或商标核查不属于本技能范围。

## 前置条件

确定查询目标与站点,准备用户提供的 ASIN、类目编号、品牌、卖家或筛选条件。构造请求前阅读 `references/api.md`,核对查询模式、条件格式与历史回看支持范围。

## 查询流程

1. 确定用户要发现哪些商品,以及是否需要历史快照。未指定站点时采用接口定义中的默认站点约定。
2. 根据单一目标或组合条件选择查询方式,按 `references/api.md` 构造条件;核对单位、范围表达和组合条件的字段大小写。
3. 调用前说明动态算力成本,并由用户决定是否继续;同一参数优先复用已有结果或本地缓存。
4. 发起查询并查看摘要,按需读取已保存文件中的商品数据;仅在用户明确要求时翻页。失败或空结果时先解释原因,后续查询遵守成本约束。
5. 需要历史对照时,先核对站点支持范围,在用户已决定承担额外消耗的范围内,分别查询历史月份与当前数据,再对照价格、排名及销量。

## 执行方式

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

### 输出策略

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

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

## 执行规则

### 算力消耗预估

消耗算力 = Sorftime 内部查询次数 × 6。不同查询条件可能需要不同次数,具体次数由 Sorftime 决定。

本服务按倍数动态计费,单次可能消耗大量算力;必须在调用前提醒用户,并由用户决定是否继续。

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

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

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

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

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

### 约束与建议

- **理解查询能力**:支持多维度单条件或 AND 组合查询。历史快照用于比较不同月份的商品状态,不等同于单个 ASIN 的连续趋势曲线。
- **明确数据覆盖**:可查看商品基本资料、图片与变体,价格和利润,销量和销售额,BSR 与类目排名,评分、上架信息、Buybox 卖家与配送,以及 A+、视频和品牌店标记。完整字段及计算口径见 `references/api.md`。
- **清晰展示数据**:用表格展示查询结果,不附加主观商业建议;价格、销售额和利润注明站点币种,排名说明数值越小越好。
- **说明估算口径**:销量与销售额不可估算时展示“无法预估”,避免把占位值解释为实际负销量;具体取值约定见接口定义。
- **利润筛选**:依据返回的利润指标整理已取得的商品;服务端支持的筛选条件以接口定义为准,不添加未定义参数,也不把单页结果推断为全市场结果。
- **说明分页情况**:结果较多时先展示重点和本次返回范围,再提醒用户可以继续查看;分页上限见接口定义,后续调用遵守成本约束。
- **解释失败**:按接口文档判断响应,结合 `msg`、`errmsg` 或脚本保留的错误信息解释原因,建议用户核对查询条件;不得自动连续试探。

## 使用示例

### 发现竞品或浏览品牌、类目、卖家

用户:找这个 ASIN 的相似产品,再看看指定品牌或卖家有哪些商品。

根据用户指定目标逐项构造查询,展示匹配商品及返回范围。常见条件格式与示例见 `references/api.md`。

### 寻找新品、季节性商品或低价高销量商品

用户:找新品中销量较高的 FBA 商品,或者寻找第四季度旺季产品。

确定用户需要的条件组合,核对条件与单位后查询,按返回数据列出商品,不自动扩展筛选条件。

### 对比历史与当前数据

用户:对比这个类目去年十一月与现在的价格和销量。

核对历史回看支持范围,说明两次查询的动态消耗,在用户决定继续后获取两个时间口径的数据并列表对照。

## 使用反馈

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

---

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

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

Similar skills

All skills for Marketing and content →
product-selection vivy-yi product-selection — a skill for Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI that walks through Xiaohongshu product evaluation across four criteria: demand, competition, margin and supplier reliability. CX Codex +1 331installs amazon-competitor-analysis nexscope-ai amazon-competitor-analysis is a Claude Code skill that compares Amazon products against direct rivals. It activates for ASIN research, pricing checks, review analysis, and competitor positioning. CX Codex +1 1,500installs amazon-global-selling nexscope-ai amazon-global-selling — a skill that helps an Amazon seller compare overseas marketplaces and build a staged expansion plan with verification gates. CX Codex +1 1,200installs amazon-competitor-analyzer browser-act amazon-competitor-analyzer pulls product data from Amazon by ASIN and compares pricing, specs, and reviews across competitors. Identifies weak points in rival strategies and uncovers market gaps for your own product. CX Codex +1 133installs muapi-amazon-product-listing SamurAIGPT muapi-amazon-product-listing — a Claude Code skill that produces a full Amazon listing image set: a white-background hero shot, a lifestyle photo, a feature infographic, and a macro detail closeup. All four run in parallel through MUAPI. CX Codex +1 671installs Easyparser — Amazon Product & Seller Data easyparser-com Easyparser — Amazon Product & Seller Data is an MCP server for Claude Code: it gives your agent Amazon product pages, seller offers and sales history across 21 marketplaces. CX Codex +1

From the same set74

The whole set →
linkfox-ai-mode-google-search linkfox-ai-mode-google-search — a skill for Claude Code and Codex that pulls Google AI Overview and AI Mode summaries with citations. It runs for market research, tech comparisons, and public opinion checks. CX Codex +1 232installs linkfox-ruiguan-utility-patent-detection The linkfox-ruiguan-utility-patent-detection Claude Code skill finds similar utility model and invention patents from product details and a target market. It flags records to review before launch. CX Codex +1 232installs linkfox-echotik-get-video-download-url linkfox-echotik-get-video-download-url — a skill for Claude Code, Codex, and Cursor that parses TikTok URLs into direct download links, preview streams, and covers. It requires an existing video link to trigger extraction. CX Codex +1 232installs linkfox-seerfar-ozon-product-report-search linkfox-seerfar-ozon-product-report-search — a skill for Claude Code and Codex that filters Ozon listings via Seerfar by sales and conversion metrics. It outputs SKU-level reports and saves the full JSON locally. CX Codex +1 231installs linkfox-jiimore-get-niche-info-by-keyword linkfox-jiimore-get-niche-info-by-keyword — a skill for Claude Code and Codex analyzes Amazon product niches by search keyword. It inspects customer demand, sales volume, brand concentration, and ad costs. CX Codex +1 231installs linkfox-shopee-store-logistics linkfox-shopee-store-logistics — a skill for Claude Code, Codex, and Cursor. Fulfills Shopee store shipments, generates shipping labels, and queries tracking numbers. CX Codex +1 231installs linkfox-shopee-store-livestream The linkfox-shopee-store-livestream skill for Claude Code and Codex manages Shopee store livestreams. It handles session setup, product lists, comments, and stream metrics. CX Codex +1 231installs linkfox-echotik-batch-product-detail linkfox-echotik-batch-product-detail — a skill for Claude Code and Codex that pulls EchoTik analytics for batches of TikTok Shop items. Compares revenue, sales volumes, listing status, and livestream performance. CX Codex +1 231installs

Project sponsors

Companies that keep this analytics open