营销增长
用卖家精灵按 ASIN 反查亚马逊流量关键词及流量结构
当需要围绕某个亚马逊 ASIN 查看其关键词流量来源、流量占比类型、转化类型、自然位与广告位时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
用卖家精灵按 ASIN 反查亚马逊流量关特定
解决思路
- 通过 API 端点 POST /sellersprite/traffic/keyword 调用,或运行 Python 脚本 python scripts/sellersprite_traffic_keyword.py '<JSON 参数>' [--inline](完整参数/响应/错误码见 references/api.md)。
- 必填参数为 marketplace(市场站点,默认 US)和 asin(要反查的商品 ASIN)。
- 可选参数:month(历史月份,格式 yyyyMM,不传默认最近30天)、page(页码,默认 1)、size(每页数量,默认 50,最大 100)、keyword(关键词筛选)、badges(词标签,多值逗号分隔)、trafficKeywordTypes(流量占比类型,多值逗号分隔)、conversionKeywordTypes(转化类型,多值逗号分隔)、orderField(排序字段,默认 rankPosition)、orderDesc(是否倒序,默认 false)。
- 理解核心概念:ASIN 反查词=以 ASIN 为输入查看该商品获得流量的关键词列表;流量占比类型 trafficKeywordTypes 含主要流量词、精准流量词及 schema 中的 preciseLongTail(工具文案为「转化流失词」);转化类型 conversionKeywordTypes 含转化优质词、平稳词、流失词等;词标签 badges 含自然搜索词、Amazon Choice 推荐词等。
- 遵守成本约束:本工具消耗算力(每次 15 算力),同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存;失败/空结果不得自动换关键词、翻页或改邮编连续试探,需要继续检索时先向用户说明会产生额外消耗。
- 遵循输出策略:始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-traffic-keyword-<timestamp>.json(<cwd> 为脚本执行时的工作目录,<session> 取自环境变量 SESSION_ID,禁止写入 /tmp,当前目录不可写则报错)。
- 响应体 ≤ 8 KB 时落盘后把完整 JSON 打印到 stdout;响应体 > 8 KB 时落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本);加 --inline 强制全量打印到 stdout(同样落盘)。
- 读数据时先看摘要判断是否足够;需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。
- 遇到未配置 API Key(环境变量未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY)、响应 401 或 402 状态码、或响应提示算力/余额不足(含「算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值」等含义)时,采用 references/onboarding.md 引导解决问题。
- 展示结果时优先展示关键词、自然位、广告位、流量占比类型、转化类型;明确标注查询周期(最近30天或历史月份);存在分页时告知总数与当前页;不输出与接口无关的主观商业建议,除非用户明确要求。
- 当需要高频调用本技能或用户对算力消耗量预期不足时,务必提醒用户,由用户决定是否继续。
- 当出现以下情况时通过 Feedback API 自动检测并上报反馈:技能描述的功能或目的与实际行为不符、技能结果与用户意图不符、用户表达不满或称赞、任何你认为可改进之处;按 references/api.md 调用反馈 API,不要打断用户流程。
适用边界 · 注意事项
- 未配置 API Key 或算力/余额不足且未按 references/onboarding.md 解决时。
- 用户对算力消耗预期不足或需要高频调用、且未获用户确认继续时。
- 当前工作目录不可写(禁止写入 /tmp)时。