linkfox-sellersprite-traffic-keyword

SellerSprite Traffic Keyword 是一个用于查询和分析亚马逊商品 ASIN 流量关键词的工具技能，基于卖家精灵（SellerSprite）的流量词反查能力。

用途

以商品 ASIN 为输入，反查该商品获得流量的关键词列表，帮助了解商品的流量关键词构成与转化表现。适用于 ASIN 反查流量词、流量关键词列表查看、关键词流量结构分析、自然词与广告词分析、关键词转化类型分析等场景。

主要能力

ASIN 反查词：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。
流量占比类型（trafficKeywordTypes）：如主要流量词、精准流量词，以及 schema 中的 preciseLongTail（工具文案为「转化流失词」）等。
转化类型（conversionKeywordTypes）：如转化优质词、平稳词、流失词等。
词标签（badges）：如自然搜索词、Amazon Choice 推荐词等。
结果展示指标包括关键词、自然位、广告位、流量占比类型、转化类型。
支持历史月份查询与多维排序、分页。

使用方式

调用方式有两种：

API 端点：POST /sellersprite/traffic/keyword，完整参数、响应与错误码见 references/api.md。
Python 脚本：python scripts/sellersprite_traffic_keyword.py '<JSON 参数>' [--inline]。

关键参数：

marketplace（字符串，必填）：市场站点，默认 US。
asin（字符串，必填）：要反查的商品 ASIN。
month（字符串，可选）：历史月份，格式 yyyyMM；不传默认最近 30 天。
page（整数，可选）：页码，默认 1。
size（整数，可选）：每页数量，默认 50，最大 100。
keyword（字符串，可选）：关键词筛选。
badges（字符串，可选）：词标签，多值逗号分隔。
trafficKeywordTypes（字符串，可选）：流量占比类型，多值逗号分隔。
conversionKeywordTypes（字符串，可选）：转化类型，多值逗号分隔。
orderField（字符串，可选）：排序字段，默认 rankPosition。
orderDesc（布尔，可选）：是否倒序，默认 false。

示例参数：

{ "marketplace": "US", "asin": "B0XXXXXXXXX", "size": 50, "orderField": "rankPosition", "orderDesc": false }

{ "marketplace": "US", "asin": "B0XXXXXXXXX", "month": "202507", "trafficKeywordTypes": "primary,precise", "conversionKeywordTypes": "excellent,stable", "page": 1, "size": 100 }

输出策略（脚本默认行为）：

始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-traffic-keyword-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）。
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout。
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
加 --inline 强制全量打印到 stdout（同样落盘）。
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

认证与算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决：未配置 API Key（环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY）；响应 401 或 402 状态码；响应提示算力或余额不足（消息含「算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值」或类似含义内容）。

结果展示规则

优先展示：关键词、自然位、广告位、流量占比类型、转化类型。
明确标注查询周期（最近 30 天或历史月份）。
存在分页时，告知总数与当前页。
不输出与接口无关的主观商业建议，除非用户明确要求。

限制

必填参数：marketplace、asin。
单次每页最多 100 条。
历史查询需传 yyyyMM。
本工具会消耗算力，每次消耗 15 算力，用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，需提醒用户，由用户决定是否继续。
同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
关于收费价格、平台覆盖范围、具体效果等，资料未提供。

技能介绍