linkfox-aba-intelligent-query
查询与分析亚马逊 ABA(品牌分析)搜索词数据,覆盖搜索热度排名趋势、关键词挖掘、季节性、新兴需求、点击份额与转化份额及关键词下的竞品流量分布,支持 15 个站点近 3 年的周维度数据。适用于搜索词层面的市场机会、蓝海词与高点击低转化查询;不适用于广告投放策略、评论分析、Listing 文案、ASIN 销量估算、利润定价、综合市场报告或本地 ABA 文件处理。
How do I install this agent skill?
npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-aba-intelligent-queryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a specialized tool for querying Amazon Brand Analytics (ABA) data through the LinkFox API. It handles authentication, result caching, and local session management. No malicious patterns were detected, as all network and file system activities are directed towards vendor-owned domains and local directory management as part of its intended functionality.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
亚马逊 ABA 智能查询
适用范围
适用
查询亚马逊消费者搜索行为及搜索词下的商品点击、转化分布。无需明确提及 ABA;当需求实际是搜索词数据和排名分析时,使用本技能。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 某个关键词的搜索量、热度怎么样 | 搜索热度排名趋势;排名不能直接等同于搜索量。 |
| 最近走红的关键词、新出现的词 | 黑马关键词、新词和新兴需求发现。 |
| 蓝海词、竞争小的词 | 搜索词层面的市场机会与点击集中度查询。 |
| 哪些关键词转化好、高转化长尾词 | 高转化份额长尾词及对应 ASIN 查询。 |
| 旺季哪些词会涨、季节性关键词 | 季节与节日搜索词查询。 |
| 谁拿走了流量、是否有垄断 | 关键词下的点击份额及竞品分布。 |
| 哪些 ASIN 点击高却转化低 | 高点击低转化份额 ASIN 查询。 |
边界
“选品”“竞品分析”“市场机会”若落到搜索词层面的蓝海词或竞品流量分布查询,适用本技能;利润率、定价策略和综合市场报告不在范围内。广告/PPC 出价及策略、评论、Listing 文案、ASIN 销量估算与已有本地 ABA 文件处理也不适用。
前置条件
按查询场景明确筛选条件和时间范围;用户未指定市场时使用 US。种子词、比较目标和去重要求按场景确定,趋势比较须明确比较基准,同一搜索词与 ASIN 有多条记录且需要取舍时须明确保留规则。若相关条件含糊,先澄清影响结果的条件;支持站点及数据范围见 references/api.md。
查询流程
- 确认查询场景,忠实记录用户目标,不擅自扩展需求。
- 编写精确的自然语言查询描述,并依次核对六项原则:
- 站点明确:以“筛选美国站”等市场说明开头,与用户所选站点保持一致。
- 条件精确:使用具体数值区间,例如“排名在 5 万以内”,避免“排名较好”。
- 时间具体:说明“过去 12 周”“2024 年 1—9 月”“近 3 个月”等时间范围。
- 比较基准清楚:涉及趋势比较时,例如“4 周前的排名比 8 周前提升 30%”,明确比较时点和比例含义。
- 去重逻辑明确:同一搜索词与 ASIN 有多条记录时,说明保留最新记录还是按指定比例选取。
- 忠实用户意图:不误解、不扩大用户请求,不自行补造比较基准。
- 按
references/api.md准备请求;涉及下载或导出时遵守其中的下载约定。执行前说明本技能可能一次消耗大量算力,由用户决定是否继续。 - 取得响应后先看摘要,再按需提取保存的数据;依接口定义判断结果、空数据和错误,并按下方建议展示。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/aba_query.py '<JSON 参数>' [--inline]。 - 成本约束:本工具按“算力消耗预估”中的动态公式计费。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-aba-intelligent-query-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - UTF-8 序列化结果不超过 8,000 字节:保存后,将完整 JSON 打印到标准输出。
- UTF-8 序列化结果超过 8,000 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
按动态规则计费:消耗算力 = 初始 SQL 生成算力 + Σ(各成功任务执行_重试算力) + round(CSV 文件大小 MB × 0.075)。各项 token 均指 inputTokens + outputTokens;仅成功任务计费;若无成功任务则为 0。
重要:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - 响应状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 理解 ABA:ABA(Amazon Brand Analytics)搜索词报告是亚马逊官方搜索行为数据,反映消费者实际搜索活动。覆盖范围和周粒度限制见
references/api.md。 - 解释排名方向:
searchFrequencyRank越小越热门,1 为最热门。排名“提升”表示数值减小,“下降”表示数值增大;展示排名时提醒用户。 - 区分份额与比率:点击份额和转化份额是分配占比,不将转化份额直接解释为商品转化率,也不凭搜索排名推算搜索量或广告 ROAS。
- 清晰展示数据:用表格呈现搜索词、统计周、站点、排名、ASIN、商品名称、点击份额排名、点击份额和转化份额等实际返回指标,不附加主观经营建议;完整字段含义见
references/api.md。 - 交付完整数据:数据量大时先展示核心数据,明确告知可通过下载链接取得完整数据;返回下载地址时清楚提供给用户。用户需要完整数据但尚未要求下载时,主动建议生成链接,后续请求遵守成本约束。
- 解释失败原因:依据接口定义及返回消息说明失败原因,建议用户调整查询条件,不自动连续尝试。
- 处理示例歧义:高 ROAS 示例的两侧比较量均写为“平均转化占比”,不能构成明确基准,执行前先澄清;历史年份示例按具体年份理解,实际查询时与用户确认日期,不将示例年份自动视为当前“去年”。
使用示例
以下为自然语言查询描述示例;请求字段与运行选项见 references/api.md。
1. 搜索词热度趋势
筛选美国站,关键词"gift"在过去12周的搜索热度排名。
2. 黑马关键词发现
筛选美国站,关键词包含"gift",2025年Q1和全年的平均搜索排名都大于50万,但最新排名冲进5万-10万的搜索词。
3. 持续增长趋势发现
筛选美国站,最新排名在20万以内,且4周前的排名比8周前提升30%,本周的排名比4周前提升30%的搜索词。
4. 市场机会发现:高搜索热度、低垄断
筛选美国站,筛选当前搜索排名在20000以内,近三个月点击占比Top 1的Asin的转化率占比低于5%的搜索词。相同搜索词相同Asin值保留最新的一个。
5. 季节性与节日关键词
筛选美国站,包含"cup"的关键词中,去年(2024年)1-9月份排名未进入50万,10-11月份连续进入20万的词。
6. 高点击低转化 ASIN 挖掘
筛选美国站关键词包含"hat"的,最新搜索排名在5万-20万之间,且近3个月来点击占比大于20%,转化占比小于10%的ASIN。相同搜索词和ASIN仅保留点击占比和转化占比的比例最小数据。
7. 高 ROAS 长尾蓝海关键词:比较基准需澄清
筛选美国站,关键词包含"charger"的,当前排名在20万开外的,近2个月的平均转化占比大于平均转化占比1.5倍的关键词,以及相应的ASIN。
8. 新市场词与新兴需求发现
找到美国站"charger"的长尾词中,近一个月才进入排名榜单,且当前排名在50万以内的所有词。
9. 细分趋势与变体增长捕捉
筛选美国站中"table"的长尾词中,排名在10万-30万之间,且近4周的搜索排名增长50%以上的搜索词。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/linkfox-ai/linkfox-skills/linkfox-aba-intelligent-query">View linkfox-aba-intelligent-query on skillZs</a>