{"id":"d0a60623-8eb1-421d-aec6-8e7b2da8f5e9","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword","name":"卖家精灵-流量关键词","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword","generatedAt":"2026-10-10T11:54:04.408Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T09:48:06.303Z","emptyReason":null},"description":"使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。 Skill: 卖家精灵-流量关键词 Owner: linkfox-ai Summary: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-14T05:25:04.000Z | user Update from 1.0.7 to 1.0.8 v1.0.7 | 2026-08-14T15:0","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-sellersprite-traffic-keyword","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-sellersprite-traffic-keyword","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-sellersprite-traffic-keyword","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic key"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:48:06.303Z","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-10T09:48:06.303Z","emptyReason":null},"stars":null,"forks":null,"downloads":1515,"packageName":null,"latestVersion":"1.0.8","tractionLabel":"1.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:48:06.303Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T09:48:06.303Z","lastCrawledAt":"2026-10-10T09:48:06.303Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T09:48:06.303Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.8","createdAt":"2026-09-14T05:25:04.000Z","changelog":"Update from 1.0.7 to 1.0.8","fileCount":7,"zipByteSize":21856},{"version":"1.0.7","createdAt":"2026-08-14T15:00:49.007Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":7,"zipByteSize":21884},{"version":"1.0.6","createdAt":"2026-08-07T10:57:03.909Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":7,"zipByteSize":21782},{"version":"1.0.5","createdAt":"2026-07-13T12:18:25.893Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":5,"zipByteSize":12800},{"version":"1.0.4","createdAt":"2026-07-06T11:26:49.512Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":5,"zipByteSize":12163},{"version":"1.0.3","createdAt":"2026-07-03T08:26:17.375Z","changelog":"Update from 1.0.1 to 1.0.3","fileCount":4,"zipByteSize":10735},{"version":"1.0.1","createdAt":"2026-05-06T07:47:11.981Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":5,"zipByteSize":7532},{"version":"1.0.0","createdAt":"2026-04-29T03:32:50.478Z","changelog":"Initial release","fileCount":4,"zipByteSize":4676}]},"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-traffic-keyword","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-traffic-keyword/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/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-10T11:54:04.406Z"}},"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-traffic-keyword/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-sellersprite-traffic-keyword/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-10T09:48:06.303Z","emptyReason":null},"readme":"Skill: 卖家精灵-流量关键词\n\nOwner: linkfox-ai\n\nSummary: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n\nTags: latest:1.0.8\n\nVersion history:\n\nv1.0.8 | 2026-09-14T05:25:04.000Z | user\n\nUpdate from 1.0.7 to 1.0.8\n\nv1.0.7 | 2026-08-14T15:00:49.007Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-08-07T10:57:03.909Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-07-13T12:18:25.893Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-06T11:26:49.512Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-03T08:26:17.375Z | user\n\nUpdate from 1.0.1 to 1.0.3\n\nv1.0.1 | 2026-05-06T07:47:11.981Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nv1.0.0 | 2026-04-29T03:32:50.478Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.0.8: 7 files, 21856 bytes\n\nFiles: references/api.md (7163b), references/onboarding.md (1999b), scripts/onboarding.py (24027b), scripts/sellersprite_traffic_keyword.py (13174b), skill-card.md (2858b), SKILL.md (5359b), _meta.json (155b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: linkfox-sellersprite-traffic-keyword\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1789363504000\n}\n\nFile v1.0.8:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data[] 元素（单条流量词）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keyword | string | 关键词 |\r\n| keywordCn | string | 关键词中文翻译 |\r\n| trafficKeywordType | string | 流量占比类型 |\r\n| conversionKeywordType | string | 流量转化类型 |\r\n| badges | array | 曝光位置（流量词类型） |\r\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\r\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\r\n| searches | integer | 月搜索量 |\r\n| searchesRank | integer | 周搜索量排名 |\r\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\r\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\r\n| purchases | integer | 月购买量 |\r\n| purchaseRate | number | 购买率 |\r\n| products | integer | 商品数 |\r\n| supplyDemandRatio | number | 供需比 |\r\n| trafficPercentage | number | 流量占比 |\r\n| naturalRatio | number | 流量分布-自然占比 |\r\n| adRatio | number | 流量分布-广告占比 |\r\n| calculatedWeeklySearches | number | 预估周曝光量 |\r\n| impressions | integer | 展示量 |\r\n| clicks | integer | 点击量 |\r\n| bid | number | PPC 竞价 |\r\n| bidMin | number | PPC 竞价下限 |\r\n| bidMax | number | PPC 竞价上限 |\r\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\r\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\r\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\r\n| sprt | number | SP 相关比率 |\r\n| monopolyClickRate | number | 垄断点击率 |\r\n| top3ClickingRate | number | Top3 点击率 |\r\n| top3ConversionRate | number | Top3 转化率 |\r\n| titleDensity | number | 标题密度 |\r\n| stats | array | 高频词，元素见下表 |\r\n| updatedTime | integer | 更新时间 |\r\n\r\n### stats[] 元素（高频词子项）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keywords | string | 词 |\r\n| total | integer | 总条数 |\r\n| rankPosition | object | 自然排名位次，结构见下 |\r\n| adPosition | object | 广告排名位次，结构见下 |\r\n\r\n### 排名对象（rankPosition / adPosition）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| updatedTime | integer | 排名时间 |\r\n| pageSize | integer | 每页多少条数据 |\r\n| index | integer | 当前页排第几 |\r\n| page | integer | 第几页 |\r\n| position | integer | 总结果中排第几 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"page\": 1,\r\n \"size\": 50\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-traffic-keyword\",\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\nQueries SellerSprite traffic keyword data for an Amazon ASIN, including keyword sources, traffic share categories, conversion categories, organic rank, ad rank, historical month filters, and sorting.\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 marketplace analysts, sellers, and agent users use this skill to inspect keyword traffic sources and ranking signals for a specific Amazon ASIN. It helps retrieve structured SellerSprite keyword data while preserving result files for follow-up analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill contacts LinkFox/SellerSprite services with ASIN query data and API credentials.\n\nMitigation: Install and run it only when that data sharing is acceptable, and confirm destination URLs before entering credentials or running API calls.\n\nRisk: The onboarding helper can create API keys and initiate payment-order flows.\n\nMitigation: Prefer obtaining keys directly from the official provider site, and use the in-skill SMS login or payment flow only after verifying the provider and payment destination.\n\nRisk: Full API responses and cache files are persisted in local linkfox session directories.\n\nMitigation: Treat generated response files as sensitive when ASIN or keyword data is confidential, and review or clean the local cache and session folders after use.\n\nRisk: Automatic feedback reporting may send skill-quality feedback to the publisher service.\n\nMitigation: Avoid including secrets, proprietary ASIN analysis, or customer-sensitive details when feedback content is generated or submitted.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword)\n- [卖家精灵-流量词反查 API 参考](artifact/references/api.md)\n- [解决认证和算力问题](artifact/references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance, JSON, files]\n\n**Output Format:** [Markdown guidance, shell commands, and JSON API responses saved to local files with summaries printed to stdout for larger responses.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires marketplace and ASIN inputs, can consume 15 credits per query, caches matching requests for 24 hours, and writes full responses under the local linkfox session data directory.]\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, 21884 bytes\n\nFiles: references/api.md (7163b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/sellersprite_traffic_keyword.py (13117b), skill-card.md (2841b), SKILL.md (5359b), _meta.json (155b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-sellersprite-traffic-keyword\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1786719649007\n}\n\nFile v1.0.7:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data[] 元素（单条流量词）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keyword | string | 关键词 |\r\n| keywordCn | string | 关键词中文翻译 |\r\n| trafficKeywordType | string | 流量占比类型 |\r\n| conversionKeywordType | string | 流量转化类型 |\r\n| badges | array | 曝光位置（流量词类型） |\r\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\r\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\r\n| searches | integer | 月搜索量 |\r\n| searchesRank | integer | 周搜索量排名 |\r\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\r\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\r\n| purchases | integer | 月购买量 |\r\n| purchaseRate | number | 购买率 |\r\n| products | integer | 商品数 |\r\n| supplyDemandRatio | number | 供需比 |\r\n| trafficPercentage | number | 流量占比 |\r\n| naturalRatio | number | 流量分布-自然占比 |\r\n| adRatio | number | 流量分布-广告占比 |\r\n| calculatedWeeklySearches | number | 预估周曝光量 |\r\n| impressions | integer | 展示量 |\r\n| clicks | integer | 点击量 |\r\n| bid | number | PPC 竞价 |\r\n| bidMin | number | PPC 竞价下限 |\r\n| bidMax | number | PPC 竞价上限 |\r\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\r\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\r\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\r\n| sprt | number | SP 相关比率 |\r\n| monopolyClickRate | number | 垄断点击率 |\r\n| top3ClickingRate | number | Top3 点击率 |\r\n| top3ConversionRate | number | Top3 转化率 |\r\n| titleDensity | number | 标题密度 |\r\n| stats | array | 高频词，元素见下表 |\r\n| updatedTime | integer | 更新时间 |\r\n\r\n### stats[] 元素（高频词子项）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keywords | string | 词 |\r\n| total | integer | 总条数 |\r\n| rankPosition | object | 自然排名位次，结构见下 |\r\n| adPosition | object | 广告排名位次，结构见下 |\r\n\r\n### 排名对象（rankPosition / adPosition）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| updatedTime | integer | 排名时间 |\r\n| pageSize | integer | 每页多少条数据 |\r\n| index | integer | 当前页排第几 |\r\n| page | integer | 第几页 |\r\n| position | integer | 总结果中排第几 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"page\": 1,\r\n \"size\": 50\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-traffic-keyword\",\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\nQueries SellerSprite traffic keywords for an Amazon ASIN, including keyword traffic sources, traffic share type, conversion type, organic rank, ad rank, historical months, and sorting options.\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 users and commerce analysts use this skill to inspect the keyword traffic structure for an Amazon ASIN, including organic and advertising positions, traffic share, and conversion categories. Agents can also guide users through LinkFox authentication or billing setup when the API key or paid credits are missing.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can guide phone/SMS login, API-key generation, and paid credit purchases through LinkFox/SellerSprite flows.\n\nMitigation: Install and use it only when those account and billing actions are expected; confirm user intent before actions that consume credits or create orders.\n\nRisk: Credential-bearing endpoints are configurable through environment variables.\n\nMitigation: Use only official LinkFox endpoint environment variables and review any environment overrides before running the scripts.\n\nRisk: Full keyword responses are saved locally and may contain sensitive business research data.\n\nMitigation: Treat saved linkfox data files as sensitive, review them before sharing, and delete them when retention is not needed.\n\nRisk: API keys may be persisted in shell profile instructions during onboarding.\n\nMitigation: Prefer temporary or managed secret storage when possible, and avoid committing shell profiles or saved output files that contain credentials.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword)\n- [卖家精灵-流量词反查 API 参考](references/api.md)\n- [解决认证和积分问题](references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, files, shell commands, configuration, guidance]\n\n**Output Format:** [JSON API responses, saved JSON files, concise text summaries, and Markdown guidance with shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The lookup script caches identical requests for 24 hours, saves full responses under a local linkfox session directory, and prints a compact summary when responses exceed 8 KB unless inline output is requested.]\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, 21782 bytes\n\nFiles: references/api.md (7163b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/sellersprite_traffic_keyword.py (13117b), skill-card.md (2482b), SKILL.md (5359b), _meta.json (155b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-sellersprite-traffic-keyword\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1786100223909\n}\n\nFile v1.0.6:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data[] 元素（单条流量词）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keyword | string | 关键词 |\r\n| keywordCn | string | 关键词中文翻译 |\r\n| trafficKeywordType | string | 流量占比类型 |\r\n| conversionKeywordType | string | 流量转化类型 |\r\n| badges | array | 曝光位置（流量词类型） |\r\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\r\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\r\n| searches | integer | 月搜索量 |\r\n| searchesRank | integer | 周搜索量排名 |\r\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\r\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\r\n| purchases | integer | 月购买量 |\r\n| purchaseRate | number | 购买率 |\r\n| products | integer | 商品数 |\r\n| supplyDemandRatio | number | 供需比 |\r\n| trafficPercentage | number | 流量占比 |\r\n| naturalRatio | number | 流量分布-自然占比 |\r\n| adRatio | number | 流量分布-广告占比 |\r\n| calculatedWeeklySearches | number | 预估周曝光量 |\r\n| impressions | integer | 展示量 |\r\n| clicks | integer | 点击量 |\r\n| bid | number | PPC 竞价 |\r\n| bidMin | number | PPC 竞价下限 |\r\n| bidMax | number | PPC 竞价上限 |\r\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\r\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\r\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\r\n| sprt | number | SP 相关比率 |\r\n| monopolyClickRate | number | 垄断点击率 |\r\n| top3ClickingRate | number | Top3 点击率 |\r\n| top3ConversionRate | number | Top3 转化率 |\r\n| titleDensity | number | 标题密度 |\r\n| stats | array | 高频词，元素见下表 |\r\n| updatedTime | integer | 更新时间 |\r\n\r\n### stats[] 元素（高频词子项）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keywords | string | 词 |\r\n| total | integer | 总条数 |\r\n| rankPosition | object | 自然排名位次，结构见下 |\r\n| adPosition | object | 广告排名位次，结构见下 |\r\n\r\n### 排名对象（rankPosition / adPosition）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| updatedTime | integer | 排名时间 |\r\n| pageSize | integer | 每页多少条数据 |\r\n| index | integer | 当前页排第几 |\r\n| page | integer | 第几页 |\r\n| position | integer | 总结果中排第几 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"page\": 1,\r\n \"size\": 50\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-traffic-keyword\",\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\n查询 Amazon ASIN 的 SellerSprite 流量关键词列表，帮助查看关键词流量来源、自然位、广告位、流量占比类型、转化类型、历史月份和排序指标。\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 marketplace operators, e-commerce analysts, and agents use this skill to inspect keyword traffic structure for a specified Amazon ASIN. It supports ASIN reverse keyword lookup, result filtering, ranking metrics, paid-credit awareness, and authentication or billing setup guidance.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Lookup requests and keyword results are sent through LinkFox/SellerSprite service endpoints.\n\nMitigation: Install only when sharing ASIN and keyword lookup data with LinkFox is acceptable, and use official LinkFox endpoint environment variables.\n\nRisk: Setup can involve phone/SMS login, API-key provisioning, and paid order creation.\n\nMitigation: Avoid entering one-time codes in logged or shared sessions, protect generated API keys, and confirm plan details before running billing commands.\n\nRisk: Full lookup responses and cache files are persisted locally under linkfox session directories.\n\nMitigation: Periodically remove local linkfox response and cache files when they contain sensitive business data.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword)\n- [SellerSprite traffic keyword API reference](references/api.md)\n- [Authentication and billing onboarding](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 results and saved local JSON files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Lookup responses are cached for 24 hours and full responses are saved under a local linkfox session directory; large responses are summarized unless inline output is requested.]\n\n## Skill Version(s):\n\n1.0.6 (source: server evidence release.version)\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, 12800 bytes\n\nFiles: references/api.md (7163b), scripts/sellersprite_traffic_keyword.py (13117b), skill-card.md (2313b), SKILL.md (5976b), _meta.json (155b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-sellersprite-traffic-keyword\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1783945105893\n}\n\nFile v1.0.5:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data[] 元素（单条流量词）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keyword | string | 关键词 |\r\n| keywordCn | string | 关键词中文翻译 |\r\n| trafficKeywordType | string | 流量占比类型 |\r\n| conversionKeywordType | string | 流量转化类型 |\r\n| badges | array | 曝光位置（流量词类型） |\r\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\r\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\r\n| searches | integer | 月搜索量 |\r\n| searchesRank | integer | 周搜索量排名 |\r\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\r\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\r\n| purchases | integer | 月购买量 |\r\n| purchaseRate | number | 购买率 |\r\n| products | integer | 商品数 |\r\n| supplyDemandRatio | number | 供需比 |\r\n| trafficPercentage | number | 流量占比 |\r\n| naturalRatio | number | 流量分布-自然占比 |\r\n| adRatio | number | 流量分布-广告占比 |\r\n| calculatedWeeklySearches | number | 预估周曝光量 |\r\n| impressions | integer | 展示量 |\r\n| clicks | integer | 点击量 |\r\n| bid | number | PPC 竞价 |\r\n| bidMin | number | PPC 竞价下限 |\r\n| bidMax | number | PPC 竞价上限 |\r\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\r\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\r\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\r\n| sprt | number | SP 相关比率 |\r\n| monopolyClickRate | number | 垄断点击率 |\r\n| top3ClickingRate | number | Top3 点击率 |\r\n| top3ConversionRate | number | Top3 转化率 |\r\n| titleDensity | number | 标题密度 |\r\n| stats | array | 高频词，元素见下表 |\r\n| updatedTime | integer | 更新时间 |\r\n\r\n### stats[] 元素（高频词子项）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keywords | string | 词 |\r\n| total | integer | 总条数 |\r\n| rankPosition | object | 自然排名位次，结构见下 |\r\n| adPosition | object | 广告排名位次，结构见下 |\r\n\r\n### 排名对象（rankPosition / adPosition）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| updatedTime | integer | 排名时间 |\r\n| pageSize | integer | 每页多少条数据 |\r\n| index | integer | 当前页排第几 |\r\n| page | integer | 第几页 |\r\n| position | integer | 总结果中排第几 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"page\": 1,\r\n \"size\": 50\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-traffic-keyword\",\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:
\n查询 Amazon ASIN 的 SellerSprite 流量关键词、流量来源占比、自然和广告排名、转化类型以及历史月份指标。
\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 users and agents use this skill to inspect how an Amazon ASIN receives keyword traffic through SellerSprite data, including organic and ad positions, traffic share, conversion type, and optional historical month filters.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: ASIN queries and session metadata are sent to LinkFox/SellerSprite services.
\nMitigation: Install only if this external sharing is acceptable, use a trusted LINKFOX_TOOL_GATEWAY value, and avoid placing sensitive notes in feedback.
\nRisk: Calls can consume SellerSprite or LinkFox credits.
\nMitigation: Confirm expected cost before repeated pagination or uncached calls, and use the skill's cache where appropriate.
\nRisk: Full responses and cache files are saved locally and may retain query history.
\nMitigation: Periodically delete the linkfox output and cache directories when local retention is not desired.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword)
\n- [Publisher profile](https://clawhub.ai/user/linkfox-ai)
\n- [SellerSprite traffic keyword API reference](references/api.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, JSON, Shell commands, Files, Guidance]
\n**Output Format:** [Markdown guidance with JSON API responses and saved JSON result files]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Full responses are saved locally; large responses print summaries unless inline output is requested.]
\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, 12163 bytes\n\nFiles: references/api.md (7086b), scripts/sellersprite_traffic_keyword.py (13196b), skill-card.md (2695b), SKILL.md (4739b), _meta.json (155b)\n\nFile v1.0.4:SKILL.md\n\n---\r\nname: linkfox-sellersprite-traffic-keyword\r\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\r\n---\r\n\r\n# SellerSprite Traffic Keyword\r\n\r\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\r\n\r\n## Core Concepts\r\n\r\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\r\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\r\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\r\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\r\n\r\n| Parameter | Type | Required | Description |\r\n|-----------|------|----------|-------------|\r\n| marketplace | string | Yes | 市场站点，默认 `US` |\r\n| asin | string | Yes | 要反查的商品 ASIN |\r\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\r\n| page | integer | No | 页码，默认 1 |\r\n| size | integer | No | 每页数量，默认 50，最大 100 |\r\n| keyword | string | No | 关键词筛选 |\r\n| badges | string | No | 词标签，多值逗号分隔 |\r\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\r\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\r\n| orderField | string | No | 排序字段，默认 `rankPosition` |\r\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\r\n\r\n## Usage Examples\r\n\r\n```json\r\n{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"size\": 50,\r\n \"orderField\": \"rankPosition\",\r\n \"orderDesc\": false\r\n}\r\n```\r\n\r\n```json\r\n{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"month\": \"202507\",\r\n \"trafficKeywordTypes\": \"primary,precise\",\r\n \"conversionKeywordTypes\": \"excellent,stable\",\r\n \"page\": 1,\r\n \"size\": 100\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\r\n2. 明确标注查询周期（最近30天或历史月份）。\r\n3. 当存在分页时，告知总数与当前页。\r\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\r\n\r\n## Important Limitations\r\n\r\n- 必填参数：`marketplace`、`asin`\r\n- 单次每页最多 100 条\r\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1783337209512\n}\n\nFile v1.0.4:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data[] 元素（单条流量词）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keyword | string | 关键词 |\r\n| keywordCn | string | 关键词中文翻译 |\r\n| trafficKeywordType | string | 流量占比类型 |\r\n| conversionKeywordType | string | 流量转化类型 |\r\n| badges | array | 曝光位置（流量词类型） |\r\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\r\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\r\n| searches | integer | 月搜索量 |\r\n| searchesRank | integer | 周搜索量排名 |\r\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\r\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\r\n| purchases | integer | 月购买量 |\r\n| purchaseRate | number | 购买率 |\r\n| products | integer | 商品数 |\r\n| supplyDemandRatio | number | 供需比 |\r\n| trafficPercentage | number | 流量占比 |\r\n| naturalRatio | number | 流量分布-自然占比 |\r\n| adRatio | number | 流量分布-广告占比 |\r\n| calculatedWeeklySearches | number | 预估周曝光量 |\r\n| impressions | integer | 展示量 |\r\n| clicks | integer | 点击量 |\r\n| bid | number | PPC 竞价 |\r\n| bidMin | number | PPC 竞价下限 |\r\n| bidMax | number | PPC 竞价上限 |\r\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\r\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\r\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\r\n| sprt | number | SP 相关比率 |\r\n| monopolyClickRate | number | 垄断点击率 |\r\n| top3ClickingRate | number | Top3 点击率 |\r\n| top3ConversionRate | number | Top3 转化率 |\r\n| titleDensity | number | 标题密度 |\r\n| stats | array | 高频词，元素见下表 |\r\n| updatedTime | integer | 更新时间 |\r\n\r\n### stats[] 元素（高频词子项）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keywords | string | 词 |\r\n| total | integer | 总条数 |\r\n| rankPosition | object | 自然排名位次，结构见下 |\r\n| adPosition | object | 广告排名位次，结构见下 |\r\n\r\n### 排名对象（rankPosition / adPosition）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| updatedTime | integer | 排名时间 |\r\n| pageSize | integer | 每页多少条数据 |\r\n| index | integer | 当前页排第几 |\r\n| page | integer | 第几页 |\r\n| position | integer | 总结果中排第几 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"page\": 1,\r\n \"size\": 50\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-traffic-keyword\",\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:
\nQueries SellerSprite traffic keyword data for an Amazon ASIN, including keyword traffic sources, traffic share type, conversion type, organic rank, ad rank, historical month filters, and sorting options.
\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 Amazon marketplace operators and ecommerce analysts use this skill to retrieve and summarize ASIN-level traffic keywords, rankings, conversion labels, and traffic distribution from SellerSprite through LinkFox.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: ASIN research parameters and related request data are sent to LinkFox/SellerSprite.
\nMitigation: Use the skill only for data you are comfortable sharing with those services and configure the required LinkFox API key only in trusted environments.
\nRisk: Full API responses are stored locally and may include sensitive research data.
\nMitigation: Periodically delete stored LinkFox result and cache files when the data is sensitive.
\nRisk: The gateway endpoint can be overridden with LINKFOX_TOOL_GATEWAY.
\nMitigation: Set LINKFOX_TOOL_GATEWAY only when the destination is trusted.
\nRisk: The skill can auto-report feedback externally.
\nMitigation: Review or disable automatic feedback behavior where possible before use in sensitive workflows.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword)
\n- [卖家精灵-流量词反查 API 参考](references/api.md)
\n- [LinkFox Tool Gateway](https://tool-gateway.linkfox.com)
\n- [LinkFox API Key Guide](https://skill.linkfox.com/linkfoxskills/guide.htm)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with JSON API parameters, shell commands, and saved JSON response files.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [The script stores full API responses locally, prints small responses inline, summarizes larger responses, and maintains a 24-hour local cache for repeated parameter sets.]
\n\n## Skill Version(s):
\n1.0.4 (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.3: 4 files, 10735 bytes\n\nFiles: references/api.md (7086b), scripts/sellersprite_traffic_keyword.py (13196b), SKILL.md (4739b), _meta.json (155b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: linkfox-sellersprite-traffic-keyword\r\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\r\n---\r\n\r\n# SellerSprite Traffic Keyword\r\n\r\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\r\n\r\n## Core Concepts\r\n\r\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\r\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\r\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\r\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\r\n\r\n| Parameter | Type | Required | Description |\r\n|-----------|------|----------|-------------|\r\n| marketplace | string | Yes | 市场站点，默认 `US` |\r\n| asin | string | Yes | 要反查的商品 ASIN |\r\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\r\n| page | integer | No | 页码，默认 1 |\r\n| size | integer | No | 每页数量，默认 50，最大 100 |\r\n| keyword | string | No | 关键词筛选 |\r\n| badges | string | No | 词标签，多值逗号分隔 |\r\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\r\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\r\n| orderField | string | No | 排序字段，默认 `rankPosition` |\r\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\r\n\r\n## Usage Examples\r\n\r\n```json\r\n{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"size\": 50,\r\n \"orderField\": \"rankPosition\",\r\n \"orderDesc\": false\r\n}\r\n```\r\n\r\n```json\r\n{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"month\": \"202507\",\r\n \"trafficKeywordTypes\": \"primary,precise\",\r\n \"conversionKeywordTypes\": \"excellent,stable\",\r\n \"page\": 1,\r\n \"size\": 100\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\r\n2. 明确标注查询周期（最近30天或历史月份）。\r\n3. 当存在分页时，告知总数与当前页。\r\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\r\n\r\n## Important Limitations\r\n\r\n- 必填参数：`marketplace`、`asin`\r\n- 单次每页最多 100 条\r\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1783067177375\n}\n\nFile v1.0.3:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data[] 元素（单条流量词）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keyword | string | 关键词 |\r\n| keywordCn | string | 关键词中文翻译 |\r\n| trafficKeywordType | string | 流量占比类型 |\r\n| conversionKeywordType | string | 流量转化类型 |\r\n| badges | array | 曝光位置（流量词类型） |\r\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\r\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\r\n| searches | integer | 月搜索量 |\r\n| searchesRank | integer | 周搜索量排名 |\r\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\r\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\r\n| purchases | integer | 月购买量 |\r\n| purchaseRate | number | 购买率 |\r\n| products | integer | 商品数 |\r\n| supplyDemandRatio | number | 供需比 |\r\n| trafficPercentage | number | 流量占比 |\r\n| naturalRatio | number | 流量分布-自然占比 |\r\n| adRatio | number | 流量分布-广告占比 |\r\n| calculatedWeeklySearches | number | 预估周曝光量 |\r\n| impressions | integer | 展示量 |\r\n| clicks | integer | 点击量 |\r\n| bid | number | PPC 竞价 |\r\n| bidMin | number | PPC 竞价下限 |\r\n| bidMax | number | PPC 竞价上限 |\r\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\r\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\r\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\r\n| sprt | number | SP 相关比率 |\r\n| monopolyClickRate | number | 垄断点击率 |\r\n| top3ClickingRate | number | Top3 点击率 |\r\n| top3ConversionRate | number | Top3 转化率 |\r\n| titleDensity | number | 标题密度 |\r\n| stats | array | 高频词，元素见下表 |\r\n| updatedTime | integer | 更新时间 |\r\n\r\n### stats[] 元素（高频词子项）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| keywords | string | 词 |\r\n| total | integer | 总条数 |\r\n| rankPosition | object | 自然排名位次，结构见下 |\r\n| adPosition | object | 广告排名位次，结构见下 |\r\n\r\n### 排名对象（rankPosition / adPosition）\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| updatedTime | integer | 排名时间 |\r\n| pageSize | integer | 每页多少条数据 |\r\n| index | integer | 当前页排第几 |\r\n| page | integer | 第几页 |\r\n| position | integer | 总结果中排第几 |\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\r\n \"marketplace\": \"US\",\r\n \"asin\": \"B0XXXXXXXXX\",\r\n \"page\": 1,\r\n \"size\": 50\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-traffic-keyword\",\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, 7532 bytes\n\nFiles: references/api.md (6860b), scripts/sellersprite_traffic_keyword.py (2313b), skill-card.md (2125b), SKILL.md (3804b), _meta.json (155b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: linkfox-sellersprite-traffic-keyword\nversion: 1.0.1\ncategory: product-sourcing\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## API Usage\n\n- Endpoint: `POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword`\n- Auth: Header `Authorization: ` (`LINKFOXAGENT_API_KEY`)\n- 完整说明见 `references/api.md`：含 `marketplace`/`badges`/`trafficKeywordTypes`/`conversionKeywordTypes`/`orderField` 等入参枚举与约束，以及响应顶层、`data[]` 流量词字段、`rankPosition`/`adPosition`、`stats[]`、`summaryList[]` 等。\n- Runnable script: `scripts/sellersprite_traffic_keyword.py`\n\n## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1778053631981\n}\n\nFile v1.0.1:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\n\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\n\n## 调用规范\n\n- **请求地址**：`https://tool-gateway.linkfox.com/sellersprite/traffic/keyword`\n- **请求方式**：POST，`Content-Type: application/json`\n- **认证方式**：Header `Authorization: `，从环境变量 `LINKFOXAGENT_API_KEY` 读取\n\n## 请求参数\n\n| 参数 | 类型 | 必填 | 约束 | 说明 |\n|------|------|------|------|------|\n| marketplace | string | 是 | 见下表 | 市场站点，默认 `US` |\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\n| page | integer | 否 | 默认 1 | 当前页 |\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\n\n多个值用英文逗号分隔。\n\n| 取值 | 含义 |\n|------|------|\n| naturalSearching | 自然搜索词 |\n| amazonChoice | AC 推荐词 |\n| editorialRecommendations | ER 推荐词 |\n| fourStar | 四星推荐词 |\n| highlyRated | HR 推荐词 |\n| sponsorBrand | 品牌推荐词 |\n| sponsorVideo | 视频推荐词 |\n| ads | SP 广告词 |\n\n### trafficKeywordTypes 枚举\n\n多个值用英文逗号分隔（与工具 schema 文案一致）。\n\n| 取值 | 含义 |\n|------|------|\n| primary | 主要流量词 |\n| precise | 精准流量词 |\n| preciseLongTail | 转化流失词 |\n\n### conversionKeywordTypes 枚举\n\n多个值用英文逗号分隔。\n\n| 取值 | 含义 |\n|------|------|\n| excellent | 转化优质词 |\n| stable | 转化平稳词 |\n| lost | 转化流失词 |\n| invalid | 无效曝光词 |\n\n### orderField 可选值\n\n| 取值 | 含义 |\n|------|------|\n| rankPosition | 自然排名（默认） |\n| adPosition | 广告排名 |\n| createdTime | 创建时间 |\n| searchesRank | 搜索量周排名 |\n| searches | 月搜索量 |\n| purchases | 月购买量 |\n| purchaseRate | 购买率 |\n| products | 商品数 |\n| supplyDemandRatio | 供需比 |\n| latest1daysAds | 广告竞品数 |\n| bid | PPC 竞价 |\n| trafficPercentage | 流量占比 |\n\n## 响应结构\n\n### 顶层字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总条数 |\n| marketplace | string | 市场编码 |\n| asin | string | 查询的 ASIN |\n| data | array | 流量词列表（对应第三方 `data.items`） |\n| summaryList | array | 高频词总结列表 |\n| columns | array | 列定义 |\n| costToken | integer | 消耗 token |\n| type | string | 渲染的样式 |\n\n### summaryList 元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总次数 |\n| keywords | string | 词 |\n\n### data[] 元素（单条流量词）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| keyword | string | 关键词 |\n| keywordCn | string | 关键词中文翻译 |\n| trafficKeywordType | string | 流量占比类型 |\n| conversionKeywordType | string | 流量转化类型 |\n| badges | array | 曝光位置（流量词类型） |\n| rankPosition | object | 自然排名位次信息，结构见 [排名对象](#排名对象-rankposition--adposition) |\n| adPosition | object | 广告排名位次信息，结构同 [排名对象](#排名对象-rankposition--adposition) |\n| searches | integer | 月搜索量 |\n| searchesRank | integer | 周搜索量排名 |\n| searchesRankTimeFrom | integer | 周搜索量排名时间范围起 |\n| searchesRankTimeTo | integer | 周搜索量排名时间范围止 |\n| purchases | integer | 月购买量 |\n| purchaseRate | number | 购买率 |\n| products | integer | 商品数 |\n| supplyDemandRatio | number | 供需比 |\n| trafficPercentage | number | 流量占比 |\n| naturalRatio | number | 流量分布-自然占比 |\n| adRatio | number | 流量分布-广告占比 |\n| calculatedWeeklySearches | number | 预估周曝光量 |\n| impressions | integer | 展示量 |\n| clicks | integer | 点击量 |\n| bid | number | PPC 竞价 |\n| bidMin | number | PPC 竞价下限 |\n| bidMax | number | PPC 竞价上限 |\n| latest1daysAds | integer | 最近 1 天广告竞品数 |\n| latest7daysAds | integer | 最近 7 天广告竞品数 |\n| latest30daysAds | integer | 最近 30 天广告竞品数 |\n| sprt | number | SP 相关比率 |\n| monopolyClickRate | number | 垄断点击率 |\n| top3ClickingRate | number | Top3 点击率 |\n| top3ConversionRate | number | Top3 转化率 |\n| titleDensity | number | 标题密度 |\n| stats | array | 高频词，元素见下表 |\n| updatedTime | integer | 更新时间 |\n\n### stats[] 元素（高频词子项）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| keywords | string | 词 |\n| total | integer | 总条数 |\n| rankPosition | object | 自然排名位次，结构见下 |\n| adPosition | object | 广告排名位次，结构见下 |\n\n### 排名对象（rankPosition / adPosition）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| updatedTime | integer | 排名时间 |\n| pageSize | integer | 每页多少条数据 |\n| index | integer | 当前页排第几 |\n| page | integer | 第几页 |\n| position | integer | 总结果中排第几 |\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"page\": 1,\n \"size\": 50\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-traffic-keyword\",\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:
\nQueries SellerSprite traffic keyword data for an Amazon ASIN, including traffic sources, traffic share categories, conversion types, organic rank, ad rank, historical months, and sorting options.
\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, ecommerce operators, and agents use this skill to look up traffic keyword lists for Amazon ASINs and present keyword, organic rank, ad rank, traffic share, conversion type, and pagination details.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires a LinkFox/SellerSprite API key to call an external keyword lookup service.
\nMitigation: Store LINKFOXAGENT_API_KEY as a managed secret, limit who can run the skill, and rotate or revoke the key if access changes.
\nRisk: The skill includes instructions for agents to send broad feedback to a separate LinkFox endpoint without clear user consent.
\nMitigation: Disable or remove the feedback workflow unless the operator explicitly wants external feedback submission and users understand what may be sent.
\n\n\n## Reference(s):
\n- [API reference](references/api.md)
\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/linkfox-sellersprite-traffic-keyword)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, JSON, shell commands, guidance]
\n**Output Format:** [Markdown guidance and JSON API responses]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Calls an external SellerSprite traffic keyword API and requires LINKFOXAGENT_API_KEY.]
\n\n## Skill Version(s):
\n1.0.1 (source: frontmatter and 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.0: 4 files, 4676 bytes\n\nFiles: references/api.md (2048b), scripts/sellersprite_traffic_keyword.py (2313b), SKILL.md (3512b), _meta.json (155b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: linkfox-sellersprite-traffic-keyword\nversion: 1.0.0\ncategory: product-sourcing\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：如主要流量词、精准流量词、长尾词等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## API Usage\n\n- Endpoint: `POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword`\n- Auth: Header `Authorization: ` (`LINKFOXAGENT_API_KEY`)\n- See full details in `references/api.md`.\n- Runnable script: `scripts/sellersprite_traffic_keyword.py`\n\n## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1777433570478\n}\n\nFile v1.0.0:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\n\n## 调用规范\n\n- **请求地址**：`https://tool-gateway.linkfox.com/sellersprite/traffic/keyword`\n- **请求方式**：POST，`Content-Type: application/json`\n- **认证方式**：Header `Authorization: `，从环境变量 `LINKFOXAGENT_API_KEY` 读取\n\n## 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| marketplace | string | 是 | 市场站点，默认 `US` |\n| asin | string | 是 | 商品 ASIN |\n| month | string | 否 | 历史月份，`yyyyMM`；不传默认最近30天 |\n| page | integer | 否 | 页码，默认 1 |\n| size | integer | 否 | 每页条数，默认 50，最大 100 |\n| keyword | string | 否 | 关键词筛选 |\n| badges | string | 否 | 词标签，多值英文逗号分隔（如 `naturalSearching,amazonChoice`） |\n| trafficKeywordTypes | string | 否 | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | 否 | 转化类型，多值逗号分隔 |\n| orderField | string | 否 | 排序字段（默认 `rankPosition`） |\n| orderDesc | boolean | 否 | 排序方向，`true` 倒序，默认 `false` |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总条数 |\n| marketplace | string | 站点编码 |\n| asin | string | 查询 ASIN |\n| data | array | 流量词列表 |\n| summaryList | array | 汇总指标 |\n| columns | array | 列定义 |\n| costToken | integer | 消耗 token |\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword -H \"Authorization: $LINKFOXAGENT_API_KEY\" -H \"Content-Type: application/json\" -d '{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"page\": 1,\n \"size\": 50\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-traffic-keyword\",\n \"sentiment\": \"POSITIVE\",\n \"category\": \"OTHER\",\n \"content\": \"Results were accurate, user was satisfied.\"\n}\n```","readmeExcerpt":"Skill: 卖家精灵-流量关键词 Owner: linkfox-ai Summary: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-14T05:25:04.000Z | user Update from 1.0.7 to 1.0.8 v1.0.7 | 2026-08-14T15:0","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}"},{"language":"json","snippet":"{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\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\nQueries SellerSprite traffic keyword data for an Amazon ASIN, including keyword sources, traffic share categories, conversion categories, organic rank, ad rank, historical month filters, and sorting.\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 marketplace analysts, sellers, and agent users use this skill to inspect keyword traffic sources and ranking signals for a specific Amazon ASIN. It help"},{"language":"text","snippet":"## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1786719649007\n}\n\nFile v1.0.7:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordty"},{"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\nQueries SellerSprite traffic keywords for an Amazon ASIN, including keyword traffic sources, traffic share type, conversion type, organic rank, ad rank, historical months, and sorting options.\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 users and commerce analysts use this skill to inspect the keyword traffic structure for an Amazon ASIN, including organic "},{"language":"text","snippet":"## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\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-traffic-keyword\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1786100223909\n}\n\nFile v1.0.6:references/api.md\n\n# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordty"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-sellersprite-traffic-keyword\ndescription: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。\n---\n\n# SellerSprite Traffic Keyword\n\nThis skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.\n\n## Core Concepts\n\n- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。\n- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。\n- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。\n- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。\n\n## 调用方式\n\n- **API 端点**：`POST /sellersprite/traffic/keyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/sellersprite_traffic_keyword.py '' [--inline]`\n- **成本约束**：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-sellersprite-traffic-keyword-.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## Key Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| marketplace | string | Yes | 市场站点，默认 `US` |\n| asin | string | Yes | 要反查的商品 ASIN |\n| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |\n| page | integer | No | 页码，默认 1 |\n| size | integer | No | 每页数量，默认 50，最大 100 |\n| keyword | string | No | 关键词筛选 |\n| badges | string | No | 词标签，多值逗号分隔 |\n| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |\n| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |\n| orderField | string | No | 排序字段，默认 `rankPosition` |\n| orderDesc | boolean | No | 是否倒序，默认 `false` |\n\n## Usage Examples\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"size\": 50,\n \"orderField\": \"rankPosition\",\n \"orderDesc\": false\n}\n```\n\n```json\n{\n \"marketplace\": \"US\",\n \"asin\": \"B0XXXXXXXXX\",\n \"month\": \"202507\",\n \"trafficKeywordTypes\": \"primary,precise\",\n \"conversionKeywordTypes\": \"excellent,stable\",\n \"page\": 1,\n \"size\": 100\n}\n```\n\n## Display Rules\n\n1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。\n2. 明确标注查询周期（最近30天或历史月份）。\n3. 当存在分页时，告知总数与当前页。\n4. 不输出与接口无关的主观商业建议，除非用户明确要求。\n\n## Important Limitations\n\n- 必填参数：`marketplace`、`asin`\n- 单次每页最多 100 条\n- 历史查询需传 `yyyyMM`\n\n## 算力消耗规则\n\n消耗 15 算力。\n\n> 用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-sellersprite-traffic-keyword\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1789363504000\n}"},{"path":"references/api.md","content":"# 卖家精灵-流量词反查 API 参考\r\n\r\n本文档与工具 `_sellersprite_traffic_keyword` 的 `inputSchema` / `outputSchema`（见 `temp/tools20260430.txt`）对齐。\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/sellersprite/traffic/keyword`\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 | 是 | 见下表 | 市场站点，默认 `US` |\r\n| asin | string | 是 | maxLength 1000 | 要反查的商品 ASIN |\r\n| month | string | 否 | 正则 `^(19|20)\\d{2}(0[1-9]|1[0-2])$` | 历史月份，格式 `yyyyMM`；不传默认最近 30 天 |\r\n| page | integer | 否 | 默认 1 | 当前页 |\r\n| size | integer | 否 | 默认 50，最小 1，最大 100；最多查 2000 条 | 每页条数 |\r\n| keyword | string | 否 | maxLength 1000 | 关键词筛选 |\r\n| badges | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量词类型（曝光位置），见 [badges 枚举](#badges-枚举) |\r\n| trafficKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量占比类型，见 [trafficKeywordTypes 枚举](#traffickeywordtypes-枚举) |\r\n| conversionKeywordTypes | string | 否 | maxLength 1000，多值英文逗号分隔 | 流量转化类型，见 [conversionKeywordTypes 枚举](#conversionkeywordtypes-枚举) |\r\n| orderField | string | 否 | maxLength 1000，默认 `rankPosition` | 排序字段，见 [orderField 可选值](#orderfield-可选值) |\r\n| orderDesc | boolean | 否 | 默认 `false` | 排序是否倒序 |\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### badges 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| naturalSearching | 自然搜索词 |\r\n| amazonChoice | AC 推荐词 |\r\n| editorialRecommendations | ER 推荐词 |\r\n| fourStar | 四星推荐词 |\r\n| highlyRated | HR 推荐词 |\r\n| sponsorBrand | 品牌推荐词 |\r\n| sponsorVideo | 视频推荐词 |\r\n| ads | SP 广告词 |\r\n\r\n### trafficKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔（与工具 schema 文案一致）。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| primary | 主要流量词 |\r\n| precise | 精准流量词 |\r\n| preciseLongTail | 转化流失词 |\r\n\r\n### conversionKeywordTypes 枚举\r\n\r\n多个值用英文逗号分隔。\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| excellent | 转化优质词 |\r\n| stable | 转化平稳词 |\r\n| lost | 转化流失词 |\r\n| invalid | 无效曝光词 |\r\n\r\n### orderField 可选值\r\n\r\n| 取值 | 含义 |\r\n|------|------|\r\n| rankPosition | 自然排名（默认） |\r\n| adPosition | 广告排名 |\r\n| createdTime | 创建时间 |\r\n| searchesRank | 搜索量周排名 |\r\n| searches | 月搜索量 |\r\n| purchases | 月购买量 |\r\n| purchaseRate | 购买率 |\r\n| products | 商品数 |\r\n| supplyDemandRatio | 供需比 |\r\n| latest1daysAds | 广告竞品数 |\r\n| bid | PPC 竞价 |\r\n| trafficPercentage | 流量占比 |\r\n\r\n## 响应结构\r\n\r\n### 顶层字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总条数 |\r\n| marketplace | string | 市场编码 |\r\n| asin | string | 查询的 ASIN |\r\n| data | array | 流量词列表（对应第三方 `data.items`） |\r\n| summaryList | array | 高频词总结列表 |\r\n| columns | array | 列定义 |\r\n| costToken | integer | 消耗 token |\r\n| type | string | 渲染的样式 |\r\n\r\n### summaryList 元素\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总次数 |\r\n| keywords | string | 词 |\r\n\r\n### data"},{"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\nQueries SellerSprite traffic keyword data for an Amazon ASIN, including keyword sources, traffic share categories, conversion categories, organic rank, ad rank, historical month filters, and sorting.\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 marketplace analysts, sellers, and agent users use this skill to inspect keyword traffic sources and ranking signals for a specific Amazon ASIN. It helps retrieve structured SellerSprite keyword data while preserving result files for follow-up analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill contacts LinkFox/SellerSprite services with ASIN query data and API credentials.\n\nMitigation: Install and run it only when that data sharing is acceptable, and confirm destination URLs before entering credentials or running API calls.\n\nRisk: The onboarding helper can create API keys and initiate payment-order flows.\n\nMitigation: Prefer obtaining keys directly from the official provider site, and use the in-skill SMS login or payment flow only after verifying the provider and payment destination.\n\nRisk: Full API responses and cache files are persisted in local linkfox session directories.\n\nMitigation: Treat generated response files as sensitive when ASIN or keyword data is confidential, and review or clean the local cache and session folders after use.\n\nRisk: Automatic feedback reporting may send skill-quality feedback to the publisher service.\n\nMitigation: Avoid including secrets, proprietary ASIN analysis, or customer-sensitive details when feedback content is generated or submitted.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-sellersprite-traffic-keyword)\n- [卖家精灵-流量词反查 API 参考](artifact/references/api.md)\n- [解决认证和算力问题](artifact/references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance, JSON, files]\n\n**Output Format:** [Markdown guidance, shell commands, and JSON API responses saved to local files with summaries printed to stdout for larger responses.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires marketplace and ASIN inputs, can consume 15 credits per query, caches matching requests for 24 hours, and writes full responses under the local linkfox session data directory.]\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":"使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。 Skill: 卖家精灵-流量关键词 Owner: linkfox-ai Summary: 使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及\"卖家精灵\"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。 Tags: latest:1.0.8 Version history: v1.0.8 | 2026-09-14T05:25:04.000Z | user Update from 1.0.7 to 1.0.8 v1.0.7 | 2026-08-14T15:0","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1202,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:48:06.303Z","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-10T09:48:06.303Z","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-10T11:54:04.408Z","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"}]}}}