linkfox-wallysmarter-product-detail

WallySmarter 商品详情

此技能通过 WallySmarter 获取 Walmart 商品的详细信息，包括价格历史和销量趋势。

核心概念

WallySmarter 商品详情根据商品的 ItemId 查询单个 Walmart 商品，并返回全面的商品属性，以及历史价格和销售数据。这是一款商品级深度查询工具，可补充更广泛的 linkfox-walmart-search 技能，后者用于搜索和商品列表级别的查询。

数据范围：返回当前商品属性（标题、价格、品牌、评分、配送类型等），并在启用 includeStats 时返回历史统计数据（默认启用）。

非结构化输出：此工具返回结构化和非结构化混合数据，不支持通过 @智能数据查询 进行二次分析。

参数指南

参数	类型	必填	默认值	说明
productId	integer	是	—	Walmart Item ID，可在商品 URL 中找到：https://www.walmart.com/ip/<productId>
includeStats	boolean	否	true	是否包含历史价格和销售数据

商品数据字段

字段	说明
title	商品标题
description	商品描述
price	当前售价（USD）
wasPrice	划线价格（USD）
minPrice	最低价格（USD）
brand	品牌名称
rating	平均评分（0.0–5.0）
reviews	评论总数
salesEstimate	预估销量（件）
revenue	预估收入（USD）
sellerName	卖家名称
fulfillmentType	配送类型：MARKETPLACE 或 WFS
productPageUrl	商品页面 URL
imageUrl	商品图片 URL
departmentName	部门分类名称
departmentId	部门 ID
listingScore	商品列表质量评分
contentScore	内容质量评分
outOfStock	库存状态：0=有货，1=缺货
sponsored	广告标记：0=自然展示，1=赞助展示
isBranded	品牌标记：0=否，1=是
multipleOptionsAvailable	变体标记：0=否，1=是
usItemId	内部 US Item ID
createdAt	商品创建时间戳
updatedAt	最后更新时间戳
stats	历史价格和销量趋势数据对象

使用示例

1. 基本商品查询（含历史数据） 获取 Walmart 商品的完整详情，包括价格和销量趋势：

{"productId": 5177343351}

2. 仅查询商品详情（不含历史数据） 获取商品属性，不含历史数据，以便更快响应：

{"productId": 5169493923, "includeStats": false}

展示规则

1. 清晰呈现数据：以结构化格式展示商品详情。除非用户提出要求，否则不要添加主观的业务建议。
2. 价格格式：如果有 wasPrice，应与当前价格一并展示，以突出折扣。始终显示 USD 符号。
3. 趋势摘要：有 stats 数据时，概述价格和销量趋势（例如：“过去 30 天价格下降了 15%”）。
4. 评分说明：结合具体情况解释 listingScore 和 contentScore（分数越高，商品列表质量越好）。
5. 库存和配送：明确标示缺货商品和配送类型（WFS 或 Marketplace）。
6. 单个商品：此工具每次查询一个商品。如果用户需要查询多个商品，请针对每个 ItemId 分别调用工具。

重要限制

• 仅支持通过 Walmart ItemId 查询（即商品 URL 中的数字 ID）
• 返回非结构化数据，不兼容 @智能数据查询 的二次分析
• 每次调用仅支持一个 ItemId；批量查询需要多次调用
• 历史数据是否可用，取决于 WallySmarter 的追踪覆盖范围

用户表达与场景快速参考

适用 — Walmart 单品深度分析：

用户说	场景
"查一下这个Walmart商品的详情"	基础商品查询
"这个沃尔玛产品最近价格走势如何"	价格趋势分析
"WallySmarter查Walmart商品5177343351"	直接按 ID 查询
"沃尔玛这个产品销量怎么样"	销量估算查询
"Walmart product detail for item XX"	英文表达
"这个Walmart产品最近有没有降价"	价格变动检测

不适用 — 需求超出单个商品详情范围：

• 按关键词搜索 Walmart 商品（使用 linkfox-walmart-search）
• 同时批量比较多个商品
• Walmart 卖家账户或广告指标
• 实时库存或配送估算
• 品类级市场分析

边界判断：如果用户提供了特定的 Walmart 商品 ID 或 URL，并希望了解详细属性、价格历史或销量趋势，则适用此技能。如果用户想按关键词或品类搜索／浏览商品，则改用 linkfox-walmart-search。

解决认证和算力问题

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

异常情况

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

算力消耗规则

按动态规则计费：消耗算力 = tokens × 10.5。只查商品详情、不带历史统计时 tokens = 1；顺带查近 90 天历史统计时，每个商品详情 tokens = 2。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

反馈：

在以下任一情况下，通过 Feedback API 自动检测并报告反馈：

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

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

---

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox Skills。