linkfox-walmart-search

Walmart 商品搜索

此技能可帮助你搜索并获取 Walmart 商品列表数据，帮助电商卖家和研究人员从 Walmart 市场中提取可操作的洞察。

核心概念

Walmart 商品搜索可从 Walmart 市场获取实时商品列表数据。它支持按关键词搜索、浏览类别、按价格筛选、选择排序方式，以及获取特定设备的结果。这是一种直接搜索工具，返回当前在 Walmart.com 上显示的商品列表。

搜索模式：你可以按关键词搜索、按类别 ID 搜索，也可以结合两者搜索。必须至少提供 keyword 或 categoryId 中的一项。

排序选项：结果可按 best_seller、best_match、price_low（价格升序）或 price_high（价格降序）排序。未指定排序方式时，默认按相关性排序。

分页：结果采用分页形式，默认显示第 1 页。最大页码为 100。

参数指南

参数	类型	必填	描述
keyword	string	否*	搜索关键词（最多 1024 个字符）。*必须至少提供 keyword 或 categoryId 中的一项
categoryId	string	否*	用于浏览的类别 ID。*必须至少提供 keyword 或 categoryId 中的一项。使用 0 表示所有部门
sort	string	否	排序方式：best_seller、best_match、price_low、price_high
page	integer	否	页码（1-100，默认值为 1）
minPrice	number	否	最低价格筛选条件
maxPrice	number	否	最高价格筛选条件
spelling	boolean	否	启用拼写纠正（默认值为 true）
softSort	boolean	否	按相关性排序（默认值为 true）。设为 false 可禁用
storeId	string	否	用于获取特定门店结果的门店 ID
device	string	否	设备类型：desktop（默认值）、tablet、mobile
facet	string	否	筛选面，采用 key:value 格式，并以 || 分隔
nextDayEnabled	boolean	否	仅显示 NextDay 配送结果（默认值为 false）
jsonRestrictor	string	否	JSON 字段限制器，用于限制返回的字段

商品数据字段

字段	描述
productId	Walmart 商品 ID
usItemId	美国商品 ID
title	商品标题
description	商品描述
price	当前价格
wasPrice	折扣前的原价
currency	货币代码
minPrice	最低价格（适用于有多个选项的商品）
pricePerUnitAmount	单位价格数值
pricePerUnit	单位价格标签
rating	平均评分
reviews	评论总数
sellerName	卖家名称
sellerId	卖家 ID
imageUrl	商品缩略图 URL
productPageUrl	商品详情页 URL
sponsored	该商品列表是否为赞助广告
outOfStock	商品是否缺货
freeShipping	是否提供免费配送
twoDayShipping	是否提供两日配送
freeShippingWithWalmartPlus	Walmart Plus 会员免费配送
shippingPrice	配送费用
multipleOptionsAvailable	商品是否有多个变体
variantSwatches	变体选项列表，包含名称和图片

使用示例

1. 基本关键词搜索 搜索与关键词匹配的商品：

{"keyword": "wireless earbuds"}

2. 按价格筛选搜索 查找特定价格范围内的商品：

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

3. 某个类别中的畅销商品 按人气排序，浏览销量最高的商品：

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

4. 预算购物——优先显示最低价格 查找某个商品的最便宜选项：

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

5. 分页浏览类别 跨多个页面浏览特定类别：

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

6. 查询特定门店的库存 搜索特定 Walmart 门店有售的商品：

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

7. 模拟移动设备搜索结果 查看结果在移动设备上的显示方式：

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

8. 组合筛选条件 应用多个筛选条件以获得精准结果：

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

显示规则

1. 清晰呈现数据：使用结构清晰的表格展示搜索结果，并包含关键字段（标题、价格、评分、评论数、卖家）。除非用户要求分析，否则不要添加主观的购买建议。
2. 价格格式：始终使用货币符号显示价格。存在 wasPrice 时，同时显示当前价格和原价，以突出折扣。
3. 评分背景信息：同时显示评分和评论数，帮助用户判断可信度（例如，“1,230 条评论，评分为 4.5 星”）。
4. 库存状态：明确标示缺货商品，避免用户忽略可售情况。
5. 赞助标识：标记赞助商品，让用户能够区分自然展示和付费展示的商品。
6. 分页指引：结果总数较多时，告知用户总数，并建议使用 page 参数分页查看更多结果。
7. 错误处理：查询失败时，清楚说明错误，并建议调整参数（例如，扩大关键词范围或更改筛选条件）。
8. 商品链接：展示结果时，包含 productPageUrl，方便用户直接前往 Walmart 商品页面。

用户表达与场景速查

适用——Walmart 商品列表查询：

用户表达	场景
“在 Walmart 搜索 XX”	关键词搜索
“在 Walmart 上找便宜的 XX”	按价格筛选搜索
“Walmart 上最畅销的 XX 是什么”	畅销商品排序
“比较 Walmart 上 XX 的价格”	价格比较
“Walmart 有 XX 现货吗”	可售情况查询
“显示 Walmart 上低于 $50 的商品”	按价格范围浏览
“Walmart 上评分最高的 XX 是什么”	按评分筛选
“Walmart 上 XX 的竞品商品”	竞品调研

不适用——超出 Walmart 商品列表范围的需求：

• Walmart 卖家账户管理或广告
• Walmart 订单跟踪或购买历史记录
• 商品评论文本分析（仅提供评分和评论数）
• 历史价格跟踪或价格趋势分析
• Walmart 联盟营销或 API 密钥管理

边界判断：如果用户在 Walmart 相关场景中提到“商品调研”或“竞品分析”，且需求涉及搜索当前的商品列表、价格、评分或卖家信息，则此技能适用。如果用户询问的是广告策略、账户指标或历史销售数据，则不适用。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应 401 或 402 状态码
• 响应提示算力或余额不足：消息包含“算力余额不足／计费不足／余额不足／超出配额／余额不足／套餐到期／需要充值／请充值”，或类似含义的内容。

算力消耗规则

消耗 15 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

在符合以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 技能的结果不符合用户意图
3. 用户表达了对本技能的不满或赞赏
4. 你认为有任何可以改进之处

按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

如需了解更多高品质、专业的跨境电商技能，请设置 LinkFox Skills。