agentCLAWHUBUnverified

卖家精灵-市场统计

使用卖家精灵选市场统计能力,按类目节点输出市场统计看板,包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标,适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及"卖家精灵",只要需求是按类目节点查看聚合统计结果,也应触发此技能。 Skill: 卖家精灵-市场统计 Owner: linkfox-ai Summary: 使用卖家精灵选市场统计能力,按类目节点输出市场统计看板,包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标,适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及"卖家精灵",只要需求是按类目节点查看聚合统计结果,也应触发此技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-14T05:24:51.913Z | user Update from 1.0.7 to 1.0.8 v1.0.7 | 2026-08-14T15:00:33.374Z | user Updat

OpenClaw

Rank

62

Safety

84

Downloads

1.6k

Updated

Oct 10, 2026

Version

1.0.8

Source

CLAWHUB

About

What it does, and when to use it.

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

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.6K downloadsadoption · observed Oct 10, 2026
Latest release
1.0.8release · observed Sep 14, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-sellersprite-market-statistics
  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-market-statistics/snapshot"

Documentation

CLAWHUB

76,161 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-sellersprite-market-statistics
description: 使用卖家精灵选市场统计能力,按类目节点输出市场统计看板,包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标,适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及"卖家精灵",只要需求是按类目节点查看聚合统计结果,也应触发此技能。
---

# SellerSprite Market Statistics

This skill helps fetch node-level market statistics for Amazon categories via SellerSprite.

## Core Concepts

- **节点统计**:对指定类目节点做聚合统计,不返回完整商品明细。
- **TopN 口径**:`topN` 决定头部商品统计样本数量(默认 10)。
- **新品定义**:`newProduct` 指定“新品”按最近 N 个月定义(默认 6)。

## 调用方式

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

**输出策略(脚本默认行为)**:
- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-market-statistics-<timestamp>.json`(`<cwd>` 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;`<session>` 取自环境变量 `SESSION_ID`,按用户任务自动聚合;**禁止写入 /tmp**,当前目录不可写则报错)
- 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本)
- 加 `--inline` 强制全量打印到 stdout(同样落盘)

**读数据建议**:先看摘要判断是否足够;需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。

## 解决认证和算力问题
发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

### 异常情况
- **未配置API Key**:环境变量未配置 `LINKFOX_AGENT_API_KEY`,也未配置 `LINKFOXAGENT_API_KEY`。
- **响应401或402状态码**
- **响应提示算力或余额不足**:消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| marketplace | string | 是 | 站点编码,默认 `US` |
| nodeIdPath | string | 是 | 节点ID路径,如 `1064954:1069242:...` |
| month | string | 否 | `nearly` 或 `yyyyMM` |
| topN | integer | 否 | 头部样本数,默认 10 |
| newProduct | integer | 否 | 新品定义(月),默认 6 |

## Usage Example

```json
{
  "marketplace": "US",
  "nodeIdPath": "172282:281407",
  "month": "nearly",
  "topN": 10,
  "newProduct": 6
}
```

## Display Rules

1. 明确展示统计口径:`topN`、`newProduct`、时间范围。
2. 先输出关键总览指标,再输出扩展字段。
3. 若用户未给 `nodeIdPath`,先引导用户提供节点路径或先做类目定位。

## Important Limitations

- 必填参数:`marketplace`、`nodeIdPath`
- `nodeIdPath` 必须为合法节点路径
- 月份查询受第三方历史范围限制

## 算力消耗规则

消耗 15 算力。

> 用户会因算力消耗而支付费用。请充分评估:当需要高频调用本技能,或用户对算力消耗量预期不足时,务必提醒用户,由用户决定是否继续。

**Feedback:**

Auto-detect and report feedback via the Feedback API when any of the following apply:
1. The functionality or purpose described in this skill does not match actual behavior
2. The skill's results do not match the user's intent
3. The user expresses dissatisfaction or praise about this skill
4. Anything you believe could be improved

Call the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-sellersprite-market-statistics",
  "version": "1.0.8",
  "publishedAt": 1789363491913
}

references/api.md

# 卖家精灵-选市场统计 API 参考

本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`(见 `temp/tools20260430.txt`)对齐。

## 调用规范

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

## 请求参数

| 参数 | 类型 | 必填 | 约束 | 说明 |
|------|------|------|------|------|
| marketplace | string | 是 | maxLength 1000,默认 `US` | 站点编码,见 [marketplace](#marketplace-可选值) |
| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串,如 `1064954:1069242:1069784:1069820:1069838:1069828` |
| month | string | 否 | 见 [month](#month) | 筛选日期:`nearly` 或 `yyyyMM` |
| topN | integer | 否 | 默认 `10` | 头部 Listing 数量(用于头部相关指标口径) |
| newProduct | integer | 否 | 默认 `6` | 新品定义(月) |

### marketplace 可选值

| 取值 | 含义 |
|------|------|
| US | 美国站 USD($) |
| JP | 日本站 JPY(¥) |
| UK | 英国站 GBP(£) |
| DE | 德国站 EUR(€) |
| FR | 法国站 EUR(€) |
| IT | 意大利站 EUR(€) |
| ES | 西班牙站 EUR(€) |
| CA | 加拿大站 C$($) |
| IN | 印度站 INR(₹) |

### month

- **格式**:正则 `^(nearly|(19|20)\d{2}(0[1-9]|1[0-2]))$`
- **`nearly`**:最近 30 天
- **`yyyyMM`**:具体月份(如 `202507`);最多支持**当前月往前共 24 个月内**的月份

## 响应结构

### 顶层字段

| 字段 | 类型 | 说明 |
|------|------|------|
| total | integer | 总条数 |
| marketplace | string | 站点编码 |
| data | array | 统计结果列表(对应第三方 `data`) |
| columns | array | 渲染的列 |
| costToken | integer | 消耗 token |
| type | string | 渲染的样式 |

### data[] 元素(单条节点统计)

工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**(N 由请求参数 `topN` 决定)。

#### 节点与站点

| 字段 | 类型 | 说明 |
|------|------|------|
| nodeIdPath | string | 节点 ID 路径 |
| nodeLabelPath | string | 节点名称路径 |
| nodeLabelLocale | string | 节点名称翻译 |
| nodeLabelPathLocale | string | 节点名称路径翻译 |
| marketplace | string | 市场标志 |
| countryCode | string | 国家二简码 |
| currency | string | 该市场的货币类型 |

#### 规模与样本

| 字段 | 类型 | 说明 |
|------|------|------|
| totalProducts | integer | 商品总数 |
| products | integer | 样品商品数 |
| sellers | integer | 卖家数 |
| brands | integer | 品牌数 |
| avgSellers | number | 平均卖家数 |
| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |

#### 市场整体指标

| 字段 | 类型 | 说明 |
|------|------|------|
| avgUnits | integer | 月均销量 |
| avgRevenue | number | 月均销售额 |
| avgPrice | number | 平均价格 |
| avgRating | number | 平均星级 |
| avgRatings | integer | 平均评分数 |
| avgRatingsCv | integer | 月评论平均增长数 |
| avgBsr | integer | 平均 BSR |
| avgProfit | number | 平均利润率 |
| avgWeight | number | 平均重量(pound) |
| baseAvgWeight | number | 平均重量(g) |
| avgVolume | number | 平均体积(in³) |
| baseAvgVolume | number | 平均体积(cm³) |

#### 头部 Listing(前 N 名,N = topN)

| 字段 | 类型 | 说明 |
|------|------|------|
| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |
| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |
| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |
| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |
| hlAvgRatings | integer | 头部 Listi

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:

Fetches node-level Amazon category market statistics through SellerSprite, including top-listing averages, price, BSR, sales, seller counts, and new-product 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 sellers, ecommerce analysts, and developers use this skill to retrieve category-level Amazon market statistics for market assessment and competition analysis.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill uses LinkFox credentials and can guide phone/SMS onboarding and payment order flows.

Mitigation: Prefer manually obtaining API keys, store them in a secure secret manager, and confirm billing actions before running onboarding or order commands.

Risk: The skill writes market research responses and cache data to local session directories.

Mitigation: Review output and cache locations before use, especially when category analysis or response data is sensitive.

Risk: The skill can send feedback externally and allows endpoint override environment variables.

Mitigation: Use trusted runtimes, avoid endpoint overrides unless approved, and review when feedback reporting is appropriate.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)
- [卖家精灵-选市场统计 API 参考](references/api.md)
- [解决认证和算力问题](references/onboarding.md)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with JSON API responses and saved JSON result files]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May return full JSON for small responses, a summary for larger responses, and guidance for authentication or billing issues.]

## Skill Version(s):

1.0.8 (source: server release evidence)

## 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.
Github ReposUpdated 15h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T07:56:48.765Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T07:56:48.765Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.6K downloads",
      "href": "https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T07:56:48.765Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.8",
      "href": "https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-14T05:24:51.913Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.8",
      "description": "Update from 1.0.7 to 1.0.8",
      "href": "https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics",
      "sourceUrl": "https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-14T05:24:51.913Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to 卖家精灵-市场统计 and adjacent AI workflows.