Xpersona
卖

卖家精灵-竞品查询

CLAWHUB · Unverified

使用卖家精灵数据在亚马逊上查找和分析竞品，覆盖12个站点，包含销量、BSR、定价、评分和增长趋势等商品指标。当用户提到竞品查询、竞品分析、ASIN反查、竞争商品研究、查找相似商品、市场竞品发现、商品对标、竞品销量估算、分析竞争Listing、competitor analysis, ASIN reverse lookup, competitor sales, competitor research, SellerSprite, market competitor discovery, competitor trends时触发此技能。即使用户未明确提及"卖家精灵"或"竞品查询"，只要其需求涉及通过ASIN、关键词、卖家名称、品牌或品类发现和分析亚马逊竞品，也应触发此技能。 Skill: 卖家精灵-竞品查询 Owner: linkfox-ai Summary: 使用卖家精灵数据在亚马逊上查找和分析竞品，覆盖12个站点，包含销量、BSR、定价、评分和增长趋势等商品指标。当用户提到竞品查询、竞品分析、ASIN反查、竞争商品研究、查找相似商品、市场竞品发现、商品对标、竞品销量估算、分析竞争Listing、competitor analysis, ASIN reverse lookup, competitor sales, competitor research, SellerSprite, market competitor discovery, competitor trends时触发此技能。即使用户未明确提及"卖家精灵"或"竞品查询"，只要其需求涉及通过ASIN、关键词、卖家名称、品牌或品类发现和分析亚马逊竞品，也应触发此技能。 Tags: latest:1.0.7 Version history:

62
Rank
84
Safety
977
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 977 downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-sellersprite-competitor-lookup
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-competitor-lookup/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

129,014 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-sellersprite-competitor-lookup
description: 使用卖家精灵数据在亚马逊上查找和分析竞品，覆盖12个站点，包含销量、BSR、定价、评分和增长趋势等商品指标。当用户提到竞品查询、竞品分析、ASIN反查、竞争商品研究、查找相似商品、市场竞品发现、商品对标、竞品销量估算、分析竞争Listing、competitor analysis, ASIN reverse lookup, competitor sales, competitor research, SellerSprite, market competitor discovery, competitor trends时触发此技能。即使用户未明确提及"卖家精灵"或"竞品查询"，只要其需求涉及通过ASIN、关键词、卖家名称、品牌或品类发现和分析亚马逊竞品，也应触发此技能。
---

# SellerSprite Competitor Lookup

This skill guides you on how to query and analyze Amazon competitor product data, helping Amazon sellers discover competing products, benchmark performance, and extract actionable competitive intelligence.

## Core Concepts

The SellerSprite Competitor Lookup tool provides comprehensive Amazon product data across 12 marketplaces. It allows querying products by ASIN, keyword, seller name, brand, or category, and returns detailed metrics including monthly sales volume, revenue, BSR ranking, pricing, ratings, and growth trends.

**Data snapshots**: The tool supports both real-time data (last 30 days) and historical monthly snapshots. Use `nearly` (default) for current data or a `yyyyMM` format (e.g., `202501`) for historical snapshots. Historical snapshots capture all active listings for that month, enabling year-over-year and seasonal comparisons.

**Category hierarchy**: Amazon category names support multi-level paths separated by colons (`:`). For example, `Electronics:Computers & Accessories:Monitors`. Convert user-provided category descriptions into the proper colon-separated format.

## Supported Marketplaces

US (United States), UK (United Kingdom), DE (Germany), FR (France), JP (Japan), CA (Canada), IT (Italy), ES (Spain), MX (Mexico), AU (Australia), TR (Turkey), IN (India)

Default marketplace is **US**. Use US when the user does not specify a marketplace.

## Parameter Guide

### Search Filters

| Parameter | Description | Example |
|-----------|-------------|---------|
| marketplace | Amazon marketplace code | `US`, `UK`, `DE`, `JP` |
| keyword | Search keyword (translate to the marketplace language) | `wireless earbuds` |
| asinList | One or more ASINs, comma-separated (max 40) | `B072MQ5BRX,B08N5WRWNW` |
| sellerName | Seller name to filter by | `Anker Direct` |
| brand | Brand name to filter by | `Anker` |
| nodeLabel | Amazon category name (colon-separated levels) | `Electronics:Headphones` |
| nodeIdPath | Amazon category ID path | `172282` |
| matchType | Keyword match mode: 1 = phrase, 2 = fuzzy, 3 = exact (default 1) | `1` |
| showVariation | Show product variations: `Y` or `N` (default `N`) | `N` |
| dataSnapshotMonth | Data snapshot month (`nearly` for real-time, or `yyyyMM`) | `nearly` |

### Pagination & Sorting

| Parameter | Description | Example |
|-----------|-------------|---------|
| page | Page number, starting from 1 | `1` |
| size | Results per page, 10-100 (default 50) | `50` |
| order.field | Sort field (see sort options below) | `total_units` |
| order.desc | Sort direction: `true`

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-sellersprite-competitor-lookup",
  "version": "1.0.7",
  "publishedAt": 1789363479498
}

references/api.md

# 卖家精灵-查竞品 API 参考

## 调用规范

- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/competitor-lookup`
- **请求方式**：POST，Content-Type: application/json
- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）

## 请求参数

POST Body（JSON）：

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| marketplace | string | 否 | 亚马逊站点代码，默认 `US`。可选值：US、UK、DE、FR、JP、CA、IT、ES、MX、AU、TR、IN |
| keyword | string | 否 | 搜索关键词。请尽量翻译为对应国家的语言，比如美国用英语关键词，德国用德语关键词等 |
| asinList | string | 否 | ASIN，多个ASIN使用英文逗号分隔，最多40个。格式：`^[A-Z0-9]+(,[A-Z0-9]+){0,39}$` |
| sellerName | string | 否 | 卖家名称筛选 |
| brand | string | 否 | 品牌名称筛选 |
| nodeLabel | string | 否 | 亚马逊类目名称，支持多层级类目名称，层级之间用英文冒号 `:` 分割，例如 `Electronics:Headphones` |
| nodeIdPath | string | 否 | 亚马逊类目ID路径 |
| matchType | integer | 否 | 匹配方式。1 = 词组匹配（默认），2 = 模糊匹配，3 = 精准匹配 |
| showVariation | string | 否 | 是否查询变体。`Y` = 是，`N` = 否（默认） |
| dataSnapshotMonth | string | 否 | 亚马逊商品数据快照年月。默认 `nearly`（查询最近30天实时数据）。使用 `yyyyMM` 格式查询历史快照（如 `202412` 表示2024年12月）。仅支持已存在的历史快照，不支持未来日期。建议季节性分析时查询去年同期快照进行对比 |
| page | integer | 否 | 页码，从1开始（默认1） |
| size | integer | 否 | 每页条数，返回10-100条数据（默认50） |
| order | object | 否 | 排序配置（见下方说明） |

### 排序对象（order）

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| field | string | 是 | 排序字段。可选值：`total_units`（月销量）、`total_amount`（月销售额）、`bsr_rank`（BSR排名）、`price`（价格）、`rating`（评分）、`reviews`（评分数）、`profit`（毛利率）、`reviews_rate`（留评率）、`available_date`（上架时间）、`questions`（Q&A数）、`total_units_growth`（月销量增长率）、`total_amount_growth`（月销售额增长率）、`reviews_increasement`（月新增评分数）、`bsr_rank_cv`（近7天BSR增长数）、`bsr_rank_cr`（近7天BSR增长率）、`amz_unit`（子体销量）。默认：`total_units` |
| desc | string | 是 | 排序方向。`true` = 降序，`false` = 升序。默认：`true` |

## 响应结构

| 字段 | 类型 | 说明 |
|------|------|------|
| total | integer | 匹配结果总数 |
| sourceType | string | 来源类型（如 `amazon`） |
| message | string | 执行消息或错误描述 |
| type | string | 渲染样式 |
| nodeLabel | string | 类目名称回显 |
| columns | array | 渲染的列定义 |
| products | array | 竞品列表（见下方说明） |
| costToken | integer | 消耗token |

### 竞品对象字段（products）

| 字段 | 类型 | 说明 |
|------|------|------|
| asin | string | 商品ASIN |
| title | string | 商品标题 |
| price | number | 当前价格 |
| primePrice | number | Prime价格 |
| averagePrice | number | 平均价格 |
| currency | string | 币种 |
| monthlySalesUnits | integer | 月销量（件数） |
| monthlySalesRevenue | number | 月销售额 |
| monthlySalesUnitsGrowthRate | number | 月销量增长率 |
| bsr | integer | BSR排名 |
| bsrGrowthRate | number | BSR增长率 |
| bsrGrowthCount | integer | BSR增长数 |
| rating | number | 评分 |
| ratings | integer | 评分数 |
| ratingsGrowth | integer | 月新增评分数 |
| ratingsRate | number | 留评率 |
| brand | string | 品牌 |
| brandUrl | string | 品牌URL |
| sellerName | string | BuyBox卖家名称 |
| sellerId | string | BuyBox卖家ID |
| sellerNation | string | BuyBox卖家国籍 |
| sellerNum | integer | 卖家数 |
| fulfillment | string | 配送方式：AMZ、FBA、FBM |
| availableDate | string | 上架时间（日期格式） |
| av

references/onboarding.md

# 解决认证和算力问题

调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。

**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。
1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册
2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册
3. 手机号路径：
   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements
   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`
   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：
     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY "<key>"`
     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.zshrc && source ~/.zshrc`
     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.bashrc && source ~/.bashrc`
     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可

**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。
- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选
- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）
- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）
- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询

排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。

skill-card.md

## Description:

This skill helps agents query SellerSprite-backed Amazon competitor product data across 12 marketplaces, including sales, revenue, BSR, pricing, ratings, seller, brand, category, variation, and growth metrics.

This skill is ready for commercial/non-commercial use.

## Publisher:

[linkfox-ai](https://clawhub.ai/user/linkfox-ai)

### License/Terms of Use:

MIT-0

## Use Case:

External Amazon sellers and ecommerce analysts use this skill to discover competing products, benchmark product performance, and review market signals by ASIN, keyword, seller, brand, or category.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill handles LinkFox API keys, phone-number based onboarding, and paid credit usage.

Mitigation: Install only when the user trusts LinkFox with this data, obtain and store the API key through the official site when possible, and confirm additional paid-credit usage before repeated calls.

Risk: Endpoint override environment variables can redirect API or onboarding requests away from the default LinkFox services.

Mitigation: Avoid setting endpoint override variables unless the destination is intentionally reviewed and trusted.

Risk: Saved output and cache files may contain Amazon research data and query results.

Mitigation: Clear local LinkFox cache and output files after use in shared environments.

Risk: Automatic feedback submission may disclose task context or user reactions to the publisher.

Mitigation: Disable or avoid automatic feedback submission when the task context is sensitive.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-competitor-lookup)
- [卖家精灵-查竞品 API 参考](references/api.md)
- [解决认证和算力问题](references/onboarding.md)

## Skill Output:

**Output Type(s):** [Analysis, API Calls, Files, Shell commands, Guidance]

**Output Format:** [Markdown summaries and tables with saved JSON data files and inline shell commands]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Full API responses are saved under a LinkFox session data directory; large responses are summarized unless inline output is requested.]

## Skill Version(s):

1.0.7 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to 卖家精灵-竞品查询 and adjacent AI workflows.