skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
linkfox-ai/linkfox-skills479 installs

linkfox-amazon-search

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

How do I install this agent skill?

npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-amazon-search
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill facilitates real-time Amazon product searches across various global marketplaces with optional competitor data enrichment. It includes scripts for API interaction and user onboarding/billing management. No malicious patterns or security risks were identified.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

亚马逊前台搜索

适用范围

适用

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

场景速查

用户表达查询场景
在亚马逊搜一下这个产品,看看前排有什么关键词搜索与当前竞品发现。
我的 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。

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-amazon-search">View linkfox-amazon-search on skillZs</a>