用途
本技能用于通过 WallySmarter 查询单个 Walmart 商品的详细信息，包括商品属性、价格历史与销量趋势。它属于商品级别的深度查询工具，与面向搜索/列表层面的 linkfox-walmart-search 技能互补。
主要能力
- 按 Walmart ItemId 查询单个商品的完整属性。
- 在 includeStats 开启（默认）时返回历史价格与销量趋势数据。
- 返回字段涵盖：标题、描述、当前售价（USD）、划线价（USD）、最低价（USD）、品牌、平均评分（0.0–5.0）、评论总数、销量估算、收入估算（USD）、卖家名称、履约类型（MARKETPLACE 或 WFS）、商品页 URL、商品图片 URL、部门分类名称与 ID、Listing 质量分、内容质量分、库存状态（0=有货，1=缺货）、广告标识（0=自然，1=赞助）、品牌标识、变体标识、US ItemId、创建时间戳、更新时间戳，以及 stats 历史价格与销量趋势数据对象。
使用方式
参数说明：
- productId（整数，必填）：Walmart Item ID，可从商品 URL 中获取，格式为 https://www.walmart.com/ip/<productId>。
- includeStats（布尔，可选，默认 true）：是否包含历史价格与销量数据。
调用示例：
-
基础商品查询（含历史）： {"productId": 5177343351}
-
仅商品详情（不含历史，响应更快）： {"productId": 5169493923, "includeStats": false}
展示规则：以结构化格式清晰呈现数据，不添加主观商业建议（除非用户要求）；价格同时展示当前价与划线价并标注 USD 符号；有 stats 数据时总结价格与销量趋势（如“过去 30 天价格下降 15%”）；解释 listingScore 与 contentScore 的含义（越高表示 Listing 质量越好）；明确标注缺货商品与履约类型（WFS 与 Marketplace）。
适用场景
- 查询指定 Walmart 商品的详情。
- 分析某沃尔玛产品近期价格走势。
- 通过 WallySmarter 按 ID 直接查询 Walmart 商品。
- 查看沃尔玛某产品的销量估算。
- 检测某 Walmart 产品近期是否降价。
不适用场景：按关键词搜索 Walmart 商品（应使用 linkfox-walmart-search）；多商品批量对比；Walmart 卖家账户或广告指标；实时库存或配送估算；类目级市场分析。
限制
- 仅支持按 Walmart ItemId（商品 URL 中的数字 ID）查询。
- 返回非结构化数据，不兼容 @智能数据查询 进行二次分析。
- 每次调用仅支持一个 ItemId，批量查询需多次调用。
- 历史数据可用性取决于 WallySmarter 的追踪覆盖范围。
认证与算力
需配置 API Key：环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY。若出现未配置 API Key、响应 401 或 402 状态码、或提示算力/余额不足（如“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”等），请参照 references/onboarding.md 引导解决。
算力消耗规则：按动态规则计费，消耗算力 = tokens × 10.5。仅查商品详情、不带历史统计时 tokens = 1；附带近 90 天历史统计时每个商品详情 tokens = 2。本技能服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。
反馈
当出现以下情况时，通过 Feedback API 自动检测并上报反馈：技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户表达不满或赞扬；任何可改进之处。按 references/api.md 调用反馈 API，不打断用户流程。