{"id":"81447da2-8e36-41c6-a1ba-1bccf5b568b0","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-sellersprite-market-statistics","name":"卖家精灵-市场统计","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics","generatedAt":"2026-10-10T10:49:20.000Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T07:56:48.765Z","emptyReason":null},"description":"使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-sellersprite-market-statistics","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、cate"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:56:48.765Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:56:48.765Z","emptyReason":null},"stars":null,"forks":null,"downloads":1576,"packageName":null,"latestVersion":"1.0.8","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:56:47.408Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T07:56:48.765Z","lastCrawledAt":"2026-10-10T07:56:47.408Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T07:56:47.408Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.8","createdAt":"2026-09-14T05:24:51.913Z","changelog":"Update from 1.0.7 to 1.0.8","fileCount":7,"zipByteSize":20854},{"version":"1.0.7","createdAt":"2026-08-14T15:00:33.374Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":7,"zipByteSize":21124},{"version":"1.0.6","createdAt":"2026-08-07T10:56:49.129Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":7,"zipByteSize":21064},{"version":"1.0.5","createdAt":"2026-07-13T12:18:07.827Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":5,"zipByteSize":12045},{"version":"1.0.4","createdAt":"2026-07-06T11:26:31.643Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":11233},{"version":"1.0.3","createdAt":"2026-07-03T08:26:01.136Z","changelog":"Update from 1.0.1 to 1.0.3","fileCount":4,"zipByteSize":10009},{"version":"1.0.1","createdAt":"2026-05-06T07:47:08.985Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":5,"zipByteSize":6836},{"version":"1.0.0","createdAt":"2026-04-29T03:32:46.888Z","changelog":"Initial release","fileCount":4,"zipByteSize":4405}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-sellersprite-market-statistics","setupComplexity":"low","setupSteps":["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.","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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T10:49:19.997Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-market-statistics/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T07:56:48.765Z","emptyReason":null},"readme":"Skill: 卖家精灵-市场统计\n\nOwner: linkfox-ai\n\nSummary: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n\nTags: latest:1.0.8\n\nVersion history:\n\nv1.0.8 | 2026-09-14T05:24:51.913Z | user\n\nUpdate from 1.0.7 to 1.0.8\n\nv1.0.7 | 2026-08-14T15:00:33.374Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-08-07T10:56:49.129Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-07-13T12:18:07.827Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-06T11:26:31.643Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-03T08:26:01.136Z | user\n\nUpdate from 1.0.1 to 1.0.3\n\nv1.0.1 | 2026-05-06T07:47:08.985Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nv1.0.0 | 2026-04-29T03:32:46.888Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.0.8: 7 files, 20854 bytes\n\nFiles: references/api.md (5616b), references/onboarding.md (1999b), scripts/onboarding.py (24027b), scripts/sellersprite_market_statistics.py (13190b), skill-card.md (2261b), SKILL.md (4504b), _meta.json (157b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: linkfox-sellersprite-market-statistics\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 算力消耗规则\n\n消耗 15 算力。\n\n> 用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.8:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1789363491913\n}\n\nFile v1.0.8:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\r\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\r\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\r\n\r\n#### 新品（口径由 newProduct 定义）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProducts | integer | 新品数量 |\r\n| newProductProportion | number | 新品数量占比 |\r\n| newAvgUnits | integer | 新品月均销量 |\r\n| newAvgRevenue | number | 新品月均销售额 |\r\n| newAvgPrice | number | 新品平均价格 |\r\n| newAvgRating | number | 新品平均星级 |\r\n| newAvgRatings | integer | 新品平均评分数 |\r\n| minNewRatings | integer | 最低新品评分数 |\r\n| maxNewRatings | integer | 最高新品评分数 |\r\n\r\n#### 上架时间\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| firstShelfDate | string | 商品首次上架日期 |\r\n| lastShelfDate | string | 商品最新上架日期 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\r\n \"sentiment\": \"POSITIVE\",\r\n \"category\": \"OTHER\",\r\n \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\n\nFile v1.0.8:references/onboarding.md\n\n# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nFetches node-level Amazon category market statistics through SellerSprite, including top-listing averages, price, BSR, sales, seller counts, and new-product metrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, ecommerce analysts, and developers use this skill to retrieve category-level Amazon market statistics for market assessment and competition analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses LinkFox credentials and can guide phone/SMS onboarding and payment order flows.\n\nMitigation: Prefer manually obtaining API keys, store them in a secure secret manager, and confirm billing actions before running onboarding or order commands.\n\nRisk: The skill writes market research responses and cache data to local session directories.\n\nMitigation: Review output and cache locations before use, especially when category analysis or response data is sensitive.\n\nRisk: The skill can send feedback externally and allows endpoint override environment variables.\n\nMitigation: Use trusted runtimes, avoid endpoint overrides unless approved, and review when feedback reporting is appropriate.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)\n- [卖家精灵-选市场统计 API 参考](references/api.md)\n- [解决认证和算力问题](references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON API responses and saved JSON result files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May return full JSON for small responses, a summary for larger responses, and guidance for authentication or billing issues.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.7: 7 files, 21124 bytes\n\nFiles: references/api.md (5616b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/sellersprite_market_statistics.py (13133b), skill-card.md (2809b), SKILL.md (4504b), _meta.json (157b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-sellersprite-market-statistics\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 积分消耗规则\n\n消耗 15 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1786719633374\n}\n\nFile v1.0.7:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\r\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\r\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\r\n\r\n#### 新品（口径由 newProduct 定义）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProducts | integer | 新品数量 |\r\n| newProductProportion | number | 新品数量占比 |\r\n| newAvgUnits | integer | 新品月均销量 |\r\n| newAvgRevenue | number | 新品月均销售额 |\r\n| newAvgPrice | number | 新品平均价格 |\r\n| newAvgRating | number | 新品平均星级 |\r\n| newAvgRatings | integer | 新品平均评分数 |\r\n| minNewRatings | integer | 最低新品评分数 |\r\n| maxNewRatings | integer | 最高新品评分数 |\r\n\r\n#### 上架时间\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| firstShelfDate | string | 商品首次上架日期 |\r\n| lastShelfDate | string | 商品最新上架日期 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\r\n \"sentiment\": \"POSITIVE\",\r\n \"category\": \"OTHER\",\r\n \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\n\nFile v1.0.7:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nFetches node-level SellerSprite market statistics for Amazon categories, including average rating, price, BSR, sales, seller counts, and new-product metrics for market quality and competitive analysis.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal ecommerce operators, marketplace analysts, and agents use this skill to retrieve category-level Amazon market statistics through LinkFox/SellerSprite before evaluating market size, competition, and new-product opportunity.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a LinkFox/SellerSprite API key and can generate or display API keys during onboarding.\n\nMitigation: Treat API keys as secrets, configure them only in trusted environments, and avoid running the skill in workspaces where untrusted code or users can read environment variables or terminal output.\n\nRisk: Market statistics requests consume paid credits, and onboarding includes payment-plan and order flows.\n\nMitigation: Confirm the user's intent before paid calls, avoid repeated retries for failed or empty results, and review plan and payment details before placing any order.\n\nRisk: The skill writes full API responses and session metadata to local linkfox directories.\n\nMitigation: Run it only in workspaces where local persistence is acceptable, and review or remove saved response files if they contain sensitive business or account data.\n\nRisk: The skill may send feedback content to an external feedback API.\n\nMitigation: Review feedback text before submission and avoid including confidential user, account, or market data.\n\n## Reference(s):\n\n- [卖家精灵-选市场统计 API 参考](artifact/references/api.md)\n- [解决认证和积分问题](artifact/references/onboarding.md)\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)\n\n## Skill Output:\n\n**Output Type(s):** [API Calls, JSON, Files, Shell commands, Configuration instructions, Guidance]\n\n**Output Format:** [JSON response files with stdout JSON or a concise text summary for large responses]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Writes full responses under a local linkfox session data directory, caches identical requests for 24 hours, and consumes 15 credits per uncached market statistics request.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.6: 7 files, 21064 bytes\n\nFiles: references/api.md (5616b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/sellersprite_market_statistics.py (13133b), skill-card.md (2867b), SKILL.md (4504b), _meta.json (157b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-sellersprite-market-statistics\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 积分消耗规则\n\n消耗 15 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1786100209129\n}\n\nFile v1.0.6:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\r\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\r\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\r\n\r\n#### 新品（口径由 newProduct 定义）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProducts | integer | 新品数量 |\r\n| newProductProportion | number | 新品数量占比 |\r\n| newAvgUnits | integer | 新品月均销量 |\r\n| newAvgRevenue | number | 新品月均销售额 |\r\n| newAvgPrice | number | 新品平均价格 |\r\n| newAvgRating | number | 新品平均星级 |\r\n| newAvgRatings | integer | 新品平均评分数 |\r\n| minNewRatings | integer | 最低新品评分数 |\r\n| maxNewRatings | integer | 最高新品评分数 |\r\n\r\n#### 上架时间\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| firstShelfDate | string | 商品首次上架日期 |\r\n| lastShelfDate | string | 商品最新上架日期 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\r\n \"sentiment\": \"POSITIVE\",\r\n \"category\": \"OTHER\",\r\n \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\n\nFile v1.0.6:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nFetches SellerSprite market-statistics dashboards for Amazon category node paths, including top-listing averages, BSR, sales, seller counts, and new-product metrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, marketplace analysts, and agents use this skill to retrieve paid SellerSprite category statistics for a supplied marketplace and category node path. It is used to assess market quality and competition from aggregate listing, sales, seller, BSR, and new-product indicators.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Requests use API keys and can be redirected through LinkFox endpoint override environment variables.\n\nMitigation: Keep API keys scoped and private, and only set endpoint override variables when the destination is trusted.\n\nRisk: The onboarding flow can process phone/SMS login, API key generation, package listing, and billing orders.\n\nMitigation: Use the onboarding commands only when needed, confirm plan and payment details with the user, and avoid exposing returned credentials.\n\nRisk: Full API responses are saved locally and small or inline responses may be printed to stdout.\n\nMitigation: Review saved response paths and stdout output before sharing logs or committing workspace files.\n\nRisk: Uncached statistics requests consume 15 credits.\n\nMitigation: Explain additional credit cost before repeated calls and rely on the default cache for identical requests when appropriate.\n\n## Reference(s):\n\n- [Skill listing](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)\n- [SellerSprite market statistics API reference](references/api.md)\n- [Authentication and billing onboarding](references/onboarding.md)\n- [LinkFox agent portal](https://agent.linkfox.com/)\n- [SellerSprite market statistics endpoint](https://tool-gateway.linkfox.com/sellersprite/market/statistics)\n\n## Skill Output:\n\n**Output Type(s):** [API Calls, Files, JSON, Markdown, Shell commands, Configuration instructions, Guidance]\n\n**Output Format:** [JSON responses saved to local files with stdout summaries or full inline JSON, plus Markdown guidance for interpretation and onboarding.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Writes full responses under a local linkfox session directory, uses a 24-hour cache by default, and consumes 15 credits per uncached statistics request.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.0.5: 5 files, 12045 bytes\n\nFiles: references/api.md (5616b), scripts/sellersprite_market_statistics.py (13133b), skill-card.md (2529b), SKILL.md (5121b), _meta.json (157b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-sellersprite-market-statistics\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。\n- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 积分消耗规则\n\n消耗 15 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1783945087827\n}\n\nFile v1.0.5:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\r\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\r\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\r\n\r\n#### 新品（口径由 newProduct 定义）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProducts | integer | 新品数量 |\r\n| newProductProportion | number | 新品数量占比 |\r\n| newAvgUnits | integer | 新品月均销量 |\r\n| newAvgRevenue | number | 新品月均销售额 |\r\n| newAvgPrice | number | 新品平均价格 |\r\n| newAvgRating | number | 新品平均星级 |\r\n| newAvgRatings | integer | 新品平均评分数 |\r\n| minNewRatings | integer | 最低新品评分数 |\r\n| maxNewRatings | integer | 最高新品评分数 |\r\n\r\n#### 上架时间\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| firstShelfDate | string | 商品首次上架日期 |\r\n| lastShelfDate | string | 商品最新上架日期 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\r\n \"sentiment\": \"POSITIVE\",\r\n \"category\": \"OTHER\",\r\n \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\n\nFile v1.0.5:skill-card.md\n\n## Description:
\nThis skill retrieves SellerSprite category-level Amazon market statistics for a node path, including top-listing averages, price, BSR, sales, seller counts, and new-product indicators.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal marketplace sellers, analysts, and agents use this skill to evaluate Amazon category market quality and competition from SellerSprite statistics for a known category node path.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: API keys, request details, and session or app identifiers are sent to the configured LinkFox gateway.
\nMitigation: Use a dedicated LinkFox API key, check LINKFOX_TOOL_GATEWAY before running, and avoid exposing unrelated sensitive environment variables in the agent session.
\nRisk: SellerSprite market-statistics calls consume paid credits.
\nMitigation: Confirm the query parameters and expected credit use before repeated calls; rely on the built-in 24-hour cache for identical requests.
\nRisk: Full API responses and cache data are written to local linkfox data directories.
\nMitigation: Review the selected output directory and clean stored response or cache files when they contain sensitive commercial research.
\n\n\n## Reference(s):
\n- [API Reference](references/api.md)
\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)
\n- [SellerSprite Market Statistics Gateway](https://tool-gateway.linkfox.com/sellersprite/market/statistics)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, JSON, Files, Shell commands, Guidance]
\n**Output Format:** [JSON response files with stdout JSON or summary text, plus concise Markdown guidance for interpreting the statistics.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires LinkFox API credentials; API results are cached for 24 hours and full responses are written under a linkfox session data directory.]
\n\n## Skill Version(s):
\n1.0.5 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.0.4: 5 files, 11233 bytes\n\nFiles: references/api.md (5539b), scripts/sellersprite_market_statistics.py (13212b), skill-card.md (2351b), SKILL.md (3864b), _meta.json (157b)\n\nFile v1.0.4:SKILL.md\n\n---\r\nname: linkfox-sellersprite-market-statistics\r\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\r\n---\r\n\r\n# SellerSprite Market Statistics\r\n\r\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\r\n\r\n## Core Concepts\r\n\r\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\r\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\r\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n## Parameters\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| marketplace | string | 是 | 站点编码，默认 `US` |\r\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\r\n| month | string | 否 | `nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 头部样本数，默认 10 |\r\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\r\n\r\n## Usage Example\r\n\r\n```json\r\n{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\r\n2. 先输出关键总览指标，再输出扩展字段。\r\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\r\n\r\n## Important Limitations\r\n\r\n- 必填参数：`marketplace`、`nodeIdPath`\r\n- `nodeIdPath` 必须为合法节点路径\r\n- 月份查询受第三方历史范围限制\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1783337191643\n}\n\nFile v1.0.4:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\r\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\r\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\r\n\r\n#### 新品（口径由 newProduct 定义）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProducts | integer | 新品数量 |\r\n| newProductProportion | number | 新品数量占比 |\r\n| newAvgUnits | integer | 新品月均销量 |\r\n| newAvgRevenue | number | 新品月均销售额 |\r\n| newAvgPrice | number | 新品平均价格 |\r\n| newAvgRating | number | 新品平均星级 |\r\n| newAvgRatings | integer | 新品平均评分数 |\r\n| minNewRatings | integer | 最低新品评分数 |\r\n| maxNewRatings | integer | 最高新品评分数 |\r\n\r\n#### 上架时间\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| firstShelfDate | string | 商品首次上架日期 |\r\n| lastShelfDate | string | 商品最新上架日期 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\r\n \"sentiment\": \"POSITIVE\",\r\n \"category\": \"OTHER\",\r\n \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\n\nFile v1.0.4:skill-card.md\n\n## Description:
\nFetches Amazon category-level SellerSprite market statistics through LinkFox, including top-listing averages, pricing, BSR, sales, seller counts, and new-product indicators.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers, ecommerce analysts, and marketplace operators use this skill to request node-level Amazon category statistics and assess market quality, competition, and top-listing performance before deeper product research.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill sends category-statistics requests and LinkFox credentials to the LinkFox gateway and may consume SellerSprite or LinkFox credits.
\nMitigation: Use only with approved credentials, confirm the request parameters before running, and tell users before making additional paid requests.
\nRisk: Full API responses are cached or saved locally and may be written outside the documented location if the preferred workspace path is unavailable.
\nMitigation: Review and clean generated linkfox directories before sharing workspaces or committing files.
\n\n\n## Reference(s):
\n- [ClawHub Skill Listing](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)
\n- [API Reference](artifact/references/api.md)
\n- [LinkFox Authorization Guide](https://skill.linkfox.com/linkfoxskills/guide.htm)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, JSON, shell commands, guidance]
\n**Output Format:** [Markdown guidance with JSON parameters, saved JSON response files, and stdout JSON or compact text summaries]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires LinkFox API credentials and may consume SellerSprite or LinkFox credits; full API responses are cached or saved locally.]
\n\n## Skill Version(s):
\n1.0.4 (source: server-resolved release metadata)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.0.3: 4 files, 10009 bytes\n\nFiles: references/api.md (5539b), scripts/sellersprite_market_statistics.py (13212b), SKILL.md (3864b), _meta.json (157b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: linkfox-sellersprite-market-statistics\r\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\r\n---\r\n\r\n# SellerSprite Market Statistics\r\n\r\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\r\n\r\n## Core Concepts\r\n\r\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\r\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\r\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n## Parameters\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| marketplace | string | 是 | 站点编码，默认 `US` |\r\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\r\n| month | string | 否 | `nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 头部样本数，默认 10 |\r\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\r\n\r\n## Usage Example\r\n\r\n```json\r\n{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\r\n2. 先输出关键总览指标，再输出扩展字段。\r\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\r\n\r\n## Important Limitations\r\n\r\n- 必填参数：`marketplace`、`nodeIdPath`\r\n- `nodeIdPath` 必须为合法节点路径\r\n- 月份查询受第三方历史范围限制\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1783067161136\n}\n\nFile v1.0.3:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\r\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\r\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\r\n\r\n#### 新品（口径由 newProduct 定义）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProducts | integer | 新品数量 |\r\n| newProductProportion | number | 新品数量占比 |\r\n| newAvgUnits | integer | 新品月均销量 |\r\n| newAvgRevenue | number | 新品月均销售额 |\r\n| newAvgPrice | number | 新品平均价格 |\r\n| newAvgRating | number | 新品平均星级 |\r\n| newAvgRatings | integer | 新品平均评分数 |\r\n| minNewRatings | integer | 最低新品评分数 |\r\n| maxNewRatings | integer | 最高新品评分数 |\r\n\r\n#### 上架时间\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| firstShelfDate | string | 商品首次上架日期 |\r\n| lastShelfDate | string | 商品最新上架日期 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"nodeIdPath\": \"172282:281407\",\r\n \"month\": \"nearly\",\r\n \"topN\": 10,\r\n \"newProduct\": 6\r\n }'\r\n```\r\n\r\n---\r\n\r\n## Feedback API\r\n\r\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\r\n- **Content-Type:** `application/json`\r\n\r\n```json\r\n{\r\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\r\n \"sentiment\": \"POSITIVE\",\r\n \"category\": \"OTHER\",\r\n \"content\": \"Results were accurate, user was satisfied.\"\r\n}\r\n```\n\nArchive v1.0.1: 5 files, 6836 bytes\n\nFiles: references/api.md (5355b), scripts/sellersprite_market_statistics.py (2316b), skill-card.md (2111b), SKILL.md (2979b), _meta.json (157b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: linkfox-sellersprite-market-statistics\nversion: 1.0.1\ncategory: product-sourcing\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## API Usage\n\n- Endpoint: `POST https://tool-gateway.linkfox.com/sellersprite/market/statistics`\n- Auth: Header `Authorization: ` (`LINKFOXAGENT_API_KEY`)\n- 完整说明见 `references/api.md`：含 `marketplace` / `month` 规则，必填 `nodeIdPath`，`topN`/`newProduct` 默认值；响应含 `data[]` 中市场整体、`hl*` 头部、`new*` 新品与上架日期等全部字段（与 `_sellersprite_market_statistics` 的 `outputSchema` 一致）。\n- Runnable script: `scripts/sellersprite_market_statistics.py`\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1778053628985\n}\n\nFile v1.0.1:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\n\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\n\n## 调用规范\n\n- **请求地址**：`https://tool-gateway.linkfox.com/sellersprite/market/statistics`\n- **请求方式**：POST，`Content-Type: application/json`\n- **认证方式**：Header `Authorization: `，从环境变量 `LINKFOXAGENT_API_KEY` 读取\n\n## 请求参数\n\n| 参数 | 类型 | 必填 | 约束 | 说明 |\n|------|------|------|------|------|\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\n\n### marketplace 可选值\n\n| 取值 | 含义 |\n|------|------|\n| US | 美国站 USD($) |\n| JP | 日本站 JPY(￥) |\n| UK | 英国站 GBP(£) |\n| DE | 德国站 EUR(€) |\n| FR | 法国站 EUR(€) |\n| IT | 意大利站 EUR(€) |\n| ES | 西班牙站 EUR(€) |\n| CA | 加拿大站 C$($) |\n| IN | 印度站 INR(₹) |\n\n### month\n\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\n- **`nearly`**：最近 30 天\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\n\n## 响应结构\n\n### 顶层字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总条数 |\n| marketplace | string | 站点编码 |\n| data | array | 统计结果列表（对应第三方 `data`） |\n| columns | array | 渲染的列 |\n| costToken | integer | 消耗 token |\n| type | string | 渲染的样式 |\n\n### data[] 元素（单条节点统计）\n\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\n\n#### 节点与站点\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| nodeIdPath | string | 节点 ID 路径 |\n| nodeLabelPath | string | 节点名称路径 |\n| nodeLabelLocale | string | 节点名称翻译 |\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\n| marketplace | string | 市场标志 |\n| countryCode | string | 国家二简码 |\n| currency | string | 该市场的货币类型 |\n\n#### 规模与样本\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| totalProducts | integer | 商品总数 |\n| products | integer | 样品商品数 |\n| sellers | integer | 卖家数 |\n| brands | integer | 品牌数 |\n| avgSellers | number | 平均卖家数 |\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\n\n#### 市场整体指标\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| avgUnits | integer | 月均销量 |\n| avgRevenue | number | 月均销售额 |\n| avgPrice | number | 平均价格 |\n| avgRating | number | 平均星级 |\n| avgRatings | integer | 平均评分数 |\n| avgRatingsCv | integer | 月评论平均增长数 |\n| avgBsr | integer | 平均 BSR |\n| avgProfit | number | 平均利润率 |\n| avgWeight | number | 平均重量(pound) |\n| baseAvgWeight | number | 平均重量(g) |\n| avgVolume | number | 平均体积(in³) |\n| baseAvgVolume | number | 平均体积(cm³) |\n\n#### 头部 Listing（前 N 名，N = topN）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\n| hlAvgRatings | integer | 头部 Listing 前 N 名商品平均评论数 |\n| hlAvgRatingsCv | integer | 头部 Listing 前 N 名商品月评论平均增长数 |\n| hlAvgBsr | integer | 头部 Listing 前 N 名商品平均 BSR |\n\n#### 新品（口径由 newProduct 定义）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| newProducts | integer | 新品数量 |\n| newProductProportion | number | 新品数量占比 |\n| newAvgUnits | integer | 新品月均销量 |\n| newAvgRevenue | number | 新品月均销售额 |\n| newAvgPrice | number | 新品平均价格 |\n| newAvgRating | number | 新品平均星级 |\n| newAvgRatings | integer | 新品平均评分数 |\n| minNewRatings | integer | 最低新品评分数 |\n| maxNewRatings | integer | 最高新品评分数 |\n\n#### 上架时间\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| firstShelfDate | string | 商品首次上架日期 |\n| lastShelfDate | string | 商品最新上架日期 |\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n }'\n```\n\n---\n\n## Feedback API\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\nFile v1.0.1:skill-card.md\n\n## Description:
\nFetches SellerSprite node-level market statistics for Amazon categories, including top listing averages, pricing, BSR, sales, seller counts, and new-product indicators.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal sellers, marketplace analysts, and developers use this skill to query Amazon category node statistics and assess market quality, competition, and new-product activity before product-sourcing decisions.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill uses LINKFOXAGENT_API_KEY and sends category-statistics queries to LinkFox/SellerSprite.
\nMitigation: Install only if sharing those queries with LinkFox/SellerSprite is acceptable, and protect the API key as a sensitive credential.
\nRisk: The skill directs automatic feedback reporting to LinkFox without clear user control during the workflow.
\nMitigation: Review the feedback behavior before deployment and avoid sending interaction summaries unless that data sharing is acceptable.
\n\n\n## Reference(s):
\n- [SellerSprite Market Statistics API Reference](references/api.md)
\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/linkfox-sellersprite-market-statistics)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]
\n**Output Format:** [Markdown guidance with JSON API responses and optional shell command examples]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires LINKFOXAGENT_API_KEY for live API calls.]
\n\n## Skill Version(s):
\n1.0.1 (source: server release evidence and SKILL.md frontmatter)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.0.0: 4 files, 4405 bytes\n\nFiles: references/api.md (1973b), scripts/sellersprite_market_statistics.py (2316b), SKILL.md (2723b), _meta.json (157b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: linkfox-sellersprite-market-statistics\nversion: 1.0.0\ncategory: product-sourcing\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## API Usage\n\n- Endpoint: `POST https://tool-gateway.linkfox.com/sellersprite/market/statistics`\n- Auth: Header `Authorization: ` (`LINKFOXAGENT_API_KEY`)\n- See full details in `references/api.md`.\n- Runnable script: `scripts/sellersprite_market_statistics.py`\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1777433566888\n}\n\nFile v1.0.0:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\n\n## 调用规范\n\n- **请求地址**：`https://tool-gateway.linkfox.com/sellersprite/market/statistics`\n- **请求方式**：POST，`Content-Type: application/json`\n- **认证方式**：Header `Authorization: `，从环境变量 `LINKFOXAGENT_API_KEY` 读取\n\n## 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部 Listing 数量，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总条数 |\n| marketplace | string | 站点编码 |\n| data | array | 统计结果列表 |\n| columns | array | 列定义 |\n| costToken | integer | 消耗 token |\n| type | string | 渲染类型 |\n\n## data 常见指标（示例）\n\n| 字段 | 说明 |\n|------|------|\n| hlAvgRating | 头部Listing平均星级 |\n| hlAvgPrice | 头部Listing平均价格 |\n| hlAvgBsr | 头部Listing平均BSR |\n| avgUnits | 平均销量 |\n| avgRevenue | 平均销售额 |\n| avgSellers | 平均卖家数 |\n| newCount | 新品数量 |\n| newProportion | 新品占比 |\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/market/statistics -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n }'\n```\n\n---\n\n## Feedback API\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n \"skillName\": \"linkfox-sellersprite-market-statistics\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```","readmeExcerpt":"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","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}"},{"language":"text","snippet":"File v1.0.8:references/onboarding.md\n\n# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nFetches node-level Amazon category market statistics through SellerSprite, including top-listing averages, price, BSR, sales, seller counts, and new-product metrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, ecommerce analysts, and developers use this skill to retrieve category-level Amazon market statistics for market assessment and competition analysis.\n\n### Deployment Geography f"},{"language":"text","snippet":"## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 积分消耗规则\n\n消耗 15 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1786719633374\n}\n\nFile v1.0.7:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国"},{"language":"text","snippet":"File v1.0.7:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nFetches node-level SellerSprite market statistics for Amazon categories, including average rating, price, BSR, sales, seller counts, and new-product metrics for market quality and competitive analysis.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal ecommerce operators, marketplace analysts, and agents use this skill to retrieve category-level Amazon market sta"},{"language":"text","snippet":"## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 积分消耗规则\n\n消耗 15 积分。\n\n> 用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1786100209129\n}\n\nFile v1.0.6:references/api.md\n\n# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国"},{"language":"text","snippet":"File v1.0.6:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `（workbuddy 宿主加 `--channel workbuddy`）\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nFetches SellerSprite market-statistics dashboards for Amazon category node paths, including top-listing averages, BSR, sales, seller counts, and new-product metrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, marketplace analysts, and agents use this skill to retrieve paid SellerSprite category statistics for a supplied marketplace and category no"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-sellersprite-market-statistics\ndescription: 使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部Listing平均评分、均价、BSR、销量、卖家数量与新品相关指标，适合快速判断某类目市场质量与竞争格局。当用户提到类目市场统计、选市场看板、市场基础盘评估、节点市场质量、头部商品统计、SellerSprite market statistics、category statistics时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是按类目节点查看聚合统计结果，也应触发此技能。\n---\n\n# SellerSprite Market Statistics\n\nThis skill helps fetch node-level market statistics for Amazon categories via SellerSprite.\n\n## Core Concepts\n\n- **节点统计**：对指定类目节点做聚合统计，不返回完整商品明细。\n- **TopN 口径**：`topN` 决定头部商品统计样本数量（默认 10）。\n- **新品定义**：`newProduct` 指定“新品”按最近 N 个月定义（默认 6）。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/market/statistics`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_market_statistics.py '' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-market-statistics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 解决认证和算力问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Parameters\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 站点编码，默认 `US` |\n| nodeIdPath | string | 是 | 节点ID路径，如 `1064954:1069242:...` |\n| month | string | 否 | `nearly` 或 `yyyyMM` |\n| topN | integer | 否 | 头部样本数，默认 10 |\n| newProduct | integer | 否 | 新品定义（月），默认 6 |\n\n## Usage Example\n\n```json\n{\n \"marketplace\": \"US\",\n \"nodeIdPath\": \"172282:281407\",\n \"month\": \"nearly\",\n \"topN\": 10,\n \"newProduct\": 6\n}\n```\n\n## Display Rules\n\n1. 明确展示统计口径：`topN`、`newProduct`、时间范围。\n2. 先输出关键总览指标，再输出扩展字段。\n3. 若用户未给 `nodeIdPath`，先引导用户提供节点路径或先做类目定位。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`nodeIdPath`\n- `nodeIdPath` 必须为合法节点路径\n- 月份查询受第三方历史范围限制\n\n## 算力消耗规则\n\n消耗 15 算力。\n\n> 用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow."},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-market-statistics\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1789363491913\n}"},{"path":"references/api.md","content":"# 卖家精灵-选市场统计 API 参考\r\n\r\n本文档与工具 `_sellersprite_market_statistics` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/market/statistics`\r\n- **请求方式**：POST，`Content-Type: application/json`\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和算力问题** 处理）\r\n\r\n## 请求参数\r\n\r\n| 参数 | 类型 | 必填 | 约束 | 说明 |\r\n|------|------|------|------|------|\r\n| marketplace | string | 是 | maxLength 1000，默认 `US` | 站点编码，见 [marketplace](#marketplace-可选值) |\r\n| nodeIdPath | string | 是 | maxLength 1000 | 节点 ID 路径字符串，如 `1064954:1069242:1069784:1069820:1069838:1069828` |\r\n| month | string | 否 | 见 [month](#month) | 筛选日期：`nearly` 或 `yyyyMM` |\r\n| topN | integer | 否 | 默认 `10` | 头部 Listing 数量（用于头部相关指标口径） |\r\n| newProduct | integer | 否 | 默认 `6` | 新品定义（月） |\r\n\r\n### marketplace 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| US | 美国站 USD($) |\r\n| JP | 日本站 JPY(￥) |\r\n| UK | 英国站 GBP(£) |\r\n| DE | 德国站 EUR(€) |\r\n| FR | 法国站 EUR(€) |\r\n| IT | 意大利站 EUR(€) |\r\n| ES | 西班牙站 EUR(€) |\r\n| CA | 加拿大站 C$($) |\r\n| IN | 印度站 INR(₹) |\r\n\r\n### month\r\n\r\n- **格式**：正则 `^(nearly|(19|20)\\d{2}(0[1-9]|1[0-2]))$`\r\n- **`nearly`**：最近 30 天\r\n- **`yyyyMM`**：具体月份（如 `202507`）；最多支持**当前月往前共 24 个月内**的月份\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 站点编码 |\r\n| data | array | 统计结果列表（对应第三方 `data`） |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### data[] 元素（单条节点统计）\r\n\r\n工具 schema 中 `hl*` 表示 **头部 Listing 前 N 名**（N 由请求参数 `topN` 决定）。\r\n\r\n#### 节点与站点\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nodeIdPath | string | 节点 ID 路径 |\r\n| nodeLabelPath | string | 节点名称路径 |\r\n| nodeLabelLocale | string | 节点名称翻译 |\r\n| nodeLabelPathLocale | string | 节点名称路径翻译 |\r\n| marketplace | string | 市场标志 |\r\n| countryCode | string | 国家二简码 |\r\n| currency | string | 该市场的货币类型 |\r\n\r\n#### 规模与样本\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| totalProducts | integer | 商品总数 |\r\n| products | integer | 样品商品数 |\r\n| sellers | integer | 卖家数 |\r\n| brands | integer | 品牌数 |\r\n| avgSellers | number | 平均卖家数 |\r\n| hlProducts | integer | 头部 Listing 前 N 名商品样本数 |\r\n\r\n#### 市场整体指标\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgUnits | integer | 月均销量 |\r\n| avgRevenue | number | 月均销售额 |\r\n| avgPrice | number | 平均价格 |\r\n| avgRating | number | 平均星级 |\r\n| avgRatings | integer | 平均评分数 |\r\n| avgRatingsCv | integer | 月评论平均增长数 |\r\n| avgBsr | integer | 平均 BSR |\r\n| avgProfit | number | 平均利润率 |\r\n| avgWeight | number | 平均重量(pound) |\r\n| baseAvgWeight | number | 平均重量(g) |\r\n| avgVolume | number | 平均体积(in³) |\r\n| baseAvgVolume | number | 平均体积(cm³) |\r\n\r\n#### 头部 Listing（前 N 名，N = topN）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| hlAvgUnits | integer | 头部 Listing 前 N 名商品月均销量 |\r\n| hlAvgRevenue | number | 头部 Listing 前 N 名商品月均销售额 |\r\n| hlAvgPrice | number | 头部 Listing 前 N 名商品平均价格 |\r\n| hlAvgRating | number | 头部 Listing 前 N 名商品平均星级 |\r\n| hlAvgRatings | integer | 头部 Listi"},{"path":"references/onboarding.md","content":"# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n - `python scripts/onboarding.py send-code ` → 展示 JSON 里的 phone/agreements\n - 收到验证码后：`python scripts/onboarding.py login `\n - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"\"`\n - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.zshrc && source ~/.zshrc`\n - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"\"' >> ~/.bashrc && source ~/.bashrc`\n - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order ` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query `，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。"},{"path":"skill-card.md","content":"## Description:\n\nFetches node-level Amazon category market statistics through SellerSprite, including top-listing averages, price, BSR, sales, seller counts, and new-product metrics.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal sellers, ecommerce analysts, and developers use this skill to retrieve category-level Amazon market statistics for market assessment and competition analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill uses LinkFox credentials and can guide phone/SMS onboarding and payment order flows.\n\nMitigation: Prefer manually obtaining API keys, store them in a secure secret manager, and confirm billing actions before running onboarding or order commands.\n\nRisk: The skill writes market research responses and cache data to local session directories.\n\nMitigation: Review output and cache locations before use, especially when category analysis or response data is sensitive.\n\nRisk: The skill can send feedback externally and allows endpoint override environment variables.\n\nMitigation: Use trusted runtimes, avoid endpoint overrides unless approved, and review when feedback reporting is appropriate.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-market-statistics)\n- [卖家精灵-选市场统计 API 参考](references/api.md)\n- [解决认证和算力问题](references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with JSON API responses and saved JSON result files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May return full JSON for small responses, a summary for larger responses, and guidance for authentication or billing issues.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"使用卖家精灵选市场统计能力，按类目节点输出市场统计看板，包含头部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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1151,"uniquenessScore":55,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:56:48.765Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:56:48.765Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T10:49:20.000Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}