linkfox-walmart-search

按关键词、类目和价格区间搜索沃尔玛当前商品列表,查看价格、评分、评论数、卖家、配送和可售状态,支持商品浏览、价格对比、竞品发现和选品调研。不适用于卖家账号或广告管理、订单和购买历史、评论正文分析、历史价格与销量趋势、联盟或密钥管理。

SKILL.md

GitHub

Walmart 商品搜索

适用范围

适用

搜索和浏览 Walmart.com 当前商品列表,按用户需求比较价格、评分、卖家、库存与配送信息。沃尔玛选品或竞品研究涉及当前商品列表时,使用本技能。

场景速查

用户表达 查询场景
在沃尔玛找一下这个商品 关键词搜索。
看这个类目的商品 类目浏览,也可结合关键词缩小范围。
找便宜的、低于 50 美元的商品 价格区间筛选与价格比较。
看畅销商品或最匹配的结果 使用接口支持的排序方式。
这个商品在指定门店有货吗 查看指定门店返回的可售状态。
找评分高的同类竞品 比较本次返回商品的评分与评论数,不宣称全站评分排名。
看手机端结果或配送条件 按设备或配送需求检索。

本技能不处理卖家账号与广告运营、订单跟踪和购买历史、评论正文、历史价格或销量数据、联盟及密钥管理。

前置条件

确定用户要找的商品或类目,以及本次需要的价格、门店、设备和配送范围。完整字段与使用限制见 references/api.md。

查询流程

  1. 根据用户目标选择关键词搜索、类目浏览或组合检索;按需加入价格、排序、门店、设备和其他筛选,具体约定见 references/api.md。
  2. 执行本次查询,先查看摘要和返回范围,再从保存的完整响应提取所需商品字段。
  3. 用表格展示商品与对比结果,说明库存、赞助标识和分页情况。空结果或失败时解释原因,后续检索遵守成本约束。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/walmart_search.py '<JSON 参数>' [--inline]。
  • 成本约束:本工具每次接口调用消耗 15 算力,脚本提供 24 小时本地缓存,重复查询优先复用已保存的数据。用户已明确指定的多页或多条件检索按其范围执行;失败或空结果时,不擅自更换条件、翻页或重复调用连续试探。超出已明确的检索范围或需要绕过缓存刷新时,先说明额外消耗;高频调用按下方付费提醒处理。

输出策略

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

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

执行规则

算力消耗预估

15 算力 / 次

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

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

解决认证和算力问题

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

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

约束与建议

  • 理解数据范围:结果是 Walmart.com 当前商品列表快照,可能随门店、设备和筛选条件变化;不是历史价格、历史销量或订单数据。
  • 清晰展示数据:表格包含标题、价格、评分、评论数和卖家,并附 productPageUrl 商品链接。用户未要求分析时,不附加主观购买建议。
  • 标明币种和折扣:价格带货币符号;返回 wasPrice 时同时展示现价与原价,不把它解释为历史价格序列。
  • 提供评分背景:评分与评论数一起展示,例如“4.5 分,1,230 条评价”;不能据评分和数量推断评论正文或用户痛点。
  • 标明可售与广告状态:明确标记缺货商品和赞助商品,区分自然与付费展示;配送、运费、会员免运费和多选项信息按实际返回说明。
  • 说明分页情况:展示返回的 total 和本次商品范围;记录数较大时提示可继续翻页,额外查询遵守成本约束。
  • 解释错误原因:依据接口文档判断响应,清楚说明失败原因,可建议扩大关键词或调整筛选,但不得自动连续试探;未返回的价格、库存或其他字段不补造。

使用示例

基础关键词搜索

{"keyword": "wireless earbuds"}

限定价格区间

{"keyword": "laptop stand", "minPrice": 10, "maxPrice": 50}

查看畅销商品

{"keyword": "coffee maker", "sort": "best_seller"}

按价格从低到高浏览

{"keyword": "phone case", "sort": "price_low"}

查看类目下一页

{"categoryId": "976759_976787", "page": 2}

查看指定门店结果

{"keyword": "tent", "storeId": "1862"}

查看移动端结果

{"keyword": "water bottle", "device": "mobile"}

组合价格与匹配排序

{"keyword": "running shoes", "minPrice": 30, "maxPrice": 80, "sort": "best_match"}

使用反馈

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


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