linkfox-amazon-search

模拟真实用户在亚马逊前台搜索,获取实时搜索结果、关键词下的商品位置、价格、评分、评论数、广告标记及配送信息,按需补全卖家精灵竞品数据。适用于亚马逊商品搜索、ASIN 排位核对、竞品发现、价格对比、广告商品分析、新品监控和不同站点或设备的搜索结果比较。不适用于历史搜索量或排名趋势、广告管理、独立销量趋势分析、评论情感分析、Listing 文案优化及库存供应链管理。

SKILL.md

GitHub

亚马逊前台搜索

适用范围

适用

查看某个关键词在亚马逊前台当前实际出现的商品及其位置。用户即使只说“找竞品”或“产品调研”,只要目标是查看当前搜索页的商品、价格和评分,即适用本技能。

场景速查

用户表达 查询场景
在亚马逊搜一下这个产品,看看前排有什么 关键词搜索与当前竞品发现。
我的 ASIN 在这个词下排在哪里 在本次取得的搜索页中核对 ASIN 位置。
这个词下的价格区间、评分和评论数如何 搜索页商品对比。
哪些结果是广告商品 区分赞助广告与自然结果。
有什么新品,或者畅销商品 按新品或畅销顺序查看结果。
在德国、日本或英国站搜这个词 目标站点的本地语言搜索。
手机和电脑搜索结果有什么差别 对比不同设备上的搜索页。
搜索这些商品,并补充月销量和销售额 说明额外费用后,按需启用卖家精灵补全。

边界

历史搜索量、历史排名趋势和聚合搜索词分析使用 ABA 等对应历史数据能力。广告管理、完整评论分析、Listing 优化及库存供应链查询不属于本技能范围;搜索结果中的卖家精灵补全也不能替代完整销量趋势研究。

前置条件

先明确搜索目标:确定关键词或类目范围,并识别用户需要查看的站点、排位、价格、广告或新品信息。完整参数、默认值和站点映射见 references/api.md。

查询流程

  1. 确定目标站点,按目标站点语言准备关键词;未指定站点时采用接口默认值,映射见 references/api.md。
  2. 根据用户意图准备排序、类目范围、配送地址和设备;需要翻页或跨设备比较时,先明确请求范围与额外消耗。
  3. 判断是否需要卖家精灵补全:只有用户需要月销量、月销售额、品牌、卖家数量、履约方式等补全信息,或明确要求启用时才开启,并提前说明额外动态费用。仅说“找竞品”不得自动开启。每次请求都按接口定义显式设置补全开关。
  4. 发起本次搜索,优先读取摘要,再从保存的完整响应按需提取字段;失败或空结果时遵守成本约束,不自动连续试探。
  5. 按用户目标展示商品对比、广告标记或指定 ASIN 的本次位置,说明已查询的站点与页码范围;后续检索先说明额外消耗。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/amazon_search.py '<JSON 参数>' [--inline]。
  • 成本约束:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-search-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

按当前默认网关倍率 1.5 预估,15 算力 / 次起(约 ¥0.15 / 次起)。Amazon 搜索原始基础消耗为 20000 costToken;开启卖家精灵补全后追加成功批次的动态消耗,再按网关倍率结算。逐批计费、算力换算及分页规则见 references/api.md,最终倍率和扣费以网关实际结算为准。

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 理解数据含义:这是模拟真实用户看到的实时搜索结果(SERP),ABA 则是聚合历史搜索词数据;不能从当前结果推断历史趋势。查询限制见 references/api.md。
  • 表格展示:列出位置、ASIN、标题、价格、评分、评论数及可用品牌;明确标记赞助广告与自然结果。价格使用响应币种对应的符号。
  • 说明排名范围:位置对应本次真实搜索页中的位置,注明站点、设备和已查页码。指定 ASIN 未出现时,仅说明在已查范围未找到,不推断全站没有排名。
  • 说明分页情况:展示接口返回的结果数和已查范围,按需告知可以继续查询后续页;不要补造未查询页的数据。
  • 解释结果与错误:依据接口定义和实际错误消息解释原因,并建议核对参数;不把错误当作空商品列表。补全字段未返回时不推算或补造。
  • 图片展示:有图片链接时可提供链接,只有用户要求时才尝试内联展示。

使用示例

美国站关键词搜索

用户:搜索 wireless earbuds,看看当前前排商品、价格和评分。

采用默认站点,不启用卖家精灵补全,展示本次搜索页商品并区分广告。

德国或日本站搜索新品

用户:看看德国站无线耳机,或者日本站 USB 充电器最近有什么新品。

按目标站点准备德语或日语关键词,使用对应语言和新品排序;站点、语言、排序枚举见 references/api.md。

价格、畅销和配送条件比较

用户:看看手机壳从低到高的价格、瑜伽垫畅销结果,或纽约能配送的办公椅。

按具体任务选择排序、类目和配送条件;只有需要类目内搜索时才设置类目范围。

指定 ASIN 排位及设备比较

用户:看看我的 ASIN 在 laptop stand 这个词下的位置,再比较手机和电脑结果。

明确站点、查询页数与设备比较范围,说明多次查询费用后执行,分设备展示已查范围中的位置。

补充卖家精灵竞品指标

用户:找 neck massager 的竞品,还要月销量和月销售额。

说明卖家精灵补全增加动态费用,再按接口约定显式启用,展示实际返回的补全指标和总消耗。

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。