用途 该技能用于检索沃尔玛平台上的商品列表数据,帮助电商卖家和研究者从沃尔玛市场中获取可用于分析的信息。
主要能力 支持按关键词搜索、按类目 ID 浏览,或两者组合使用;关键词与类目 ID 至少需提供一个,类目 ID 传 0 表示全部部门。支持排序:best_seller、best_match、price_low(价格升序)、price_high(价格降序),未指定时按默认相关性排序。支持最低价与最高价过滤、拼写纠正(默认开启)、相关性软排序(默认开启)、指定门店 ID 获取门店相关结果、设备类型(desktop 默认、tablet、mobile)、facet 过滤(key:value 格式)、仅显示次日达结果(默认关闭)以及通过 jsonRestrictor 限制返回字段。分页默认第 1 页,最大页码 100。
返回的商品字段包括:productId、usItemId、title、description、price、wasPrice、currency、minPrice、pricePerUnitAmount、pricePerUnit、rating、reviews、sellerName、sellerId、imageUrl、productPageUrl、sponsored、outOfStock、freeShipping、twoDayShipping、freeShippingWithWalmartPlus、shippingPrice、multipleOptionsAvailable、variantSwatches。
使用方式 通过传入参数对象调用,例如按关键词搜索 {"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"}。
展示建议 结果以结构化表格呈现标题、价格、评分、评论数、卖家等关键字段;价格带货币符号,存在 wasPrice 时同时显示现价与原价;评分与评论数并列展示;明确标注缺货商品;标注赞助商品;结果总量较大时提示用户可用 page 参数翻页;查询失败时说明错误并建议调整参数;结果中附带 productPageUrl 便于直接访问商品页。
适用场景 适用于沃尔玛商品列表查询,例如“在沃尔玛搜索 XX”“找沃尔玛便宜的 XX”“沃尔玛上最畅销的 XX”“比较沃尔玛上 XX 的价格”“XX 在沃尔玛是否有货”“显示沃尔玛 50 美元以下商品”“沃尔玛评分最高的 XX”“沃尔玛上 XX 的竞品”。当需求涉及搜索当前商品列表、价格、评分或卖家信息时适用;若涉及广告策略、账户指标或历史销售数据则不适用。
限制 不适用于沃尔玛卖家账户管理或广告、订单跟踪或购买历史、商品评论文本分析(仅有评分与评论数)、历史价格追踪或价格趋势分析、沃尔玛联盟或 API 密钥管理。认证方式为设置 NEXSCOPE_API_KEY,可在 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 管理额度。