Costco Product Data

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install costco-product-data
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 costco-product-data。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Costco Product Data 将 AI agent 连接到 Scavio 的 13 个 Costco 数据端点，返回结构化 JSON 用于产品发现、商品详情、线上与卖场价格、库存状态等。借助此 Openclaw Skills 集成，agent 可以使用 API 结果回答购物和零售研究问题，而无需对价格或现货情况进行猜测。
使用它来监控促销活动、丰富产品目录、比较多达 10 个卖场的价格，或查找当地汽油价格和清仓降价信息。大多数端点每次请求花费一个 credit，并且该技能包含用于处理 ID、特定国家/地区限制、分页和 API 错误的指南。

应用场景

通过关键字、商品编号、分类、品牌、价格范围或评分查找 Costco 产品。
根据商品编号、产品 ID 或 Costco 产品 URL 查看完整的产品详情。
将线上价格与选定卖场的架上价格进行比较。
检查卖场库存状态、自提或当日送达选项。
查找附近的卖场、营业时间、部门和服务。
检索最新的 Costco 汽油价格、美国会员优惠券手册和优惠数据源。
在特定卖场搜索清仓和经理降价商品。
阅读产品评价和评分分布。
监控价格和促销信息，或使用 Costco 产品数据丰富零售目录。

工作原理

在 SCAVIO_API_KEY 环境变量中配置 Scavio API key。
当任务依赖于当地价格、库存状态或加油站时，通过邮政编码或坐标查找附近的卖场。
搜索产品、浏览分类或查询优惠数据源；可选地包含 warehouse_id 以将该位置的架上价格和库存状态添加到搜索结果中。
请求完整的产品详情，或将线上价格与多达 10 个卖场的价格进行比较。
使用相关端点及其所需的标识符检查商品现货情况、评价、优惠券、汽油价格或清仓信息。
返回具有适当上下文的 API 结构化结果。区分线上价格与卖场价格，将现货情况报告为状态而不是数量，并避免捏造数据。

配置指南

在 scavio.dev 创建一个 Scavio 账号。新账号包含 50 个免费 credit，不需要支付卡。
从控制台复制 API key 并将其设置在您的环境变量中：
export SCAVIO_API_KEY=sk_live_your_key
使用 POST、JSON 请求体和请求头 Authorization: Bearer $SCAVIO_API_KEY 向 https://api.scavio.dev 发送请求。
大多数端点花费一个 credit。10 个卖场的价格花费两个 credit；现货情况按每 5 个卖场计费。在发起重复或多卖场请求之前检查 credit 余额。
可选安装客户端 SDK：
pip install scavio==0.18.0
npm install scavio@0.18.0
对于 MCP 使用，配置带有 SCAVIO_API_KEY 的 Scavio MCP 服务器，并在 SCAVIO_PLATFORMS 中包含 costco，例如 default,costco。Costco 工具为选择性开启。

数据架构

所有端点都返回一个包含 data、response_time、credits_used 和 credits_remaining 的响应外壳。data 对象因端点而异：
端点分组 主要响应数据
搜索、分类、优惠 结果行、分面、分页总数、产品 ID、商品编号、价格、评分、促销以及可选的卖场数据
产品 描述、特性、规格、变体、购买限制、配送费和促销
价格 线上和卖场价格、折扣、最终价格、货币、促销和价格代码
现货情况 卖场级库存状态以及卖场内、自提和当日送达的渠道状态
评价 评价文本、评分、作者详情、有用投票和评分分布
卖场和汽油 位置详情、营业时间、服务、部门以及普通、优质或柴油价格
优惠券和清仓 优惠券条款和日期，或特定卖场的降价结果和价格代码信息
分类和自动完成 部门或子分类 ID 和 slug、搜索建议以及匹配的卖场位置
重要的标识符和数据区别：
item_number 是货架标签和收据上使用的编号；product_id 标识 Costco 产品页面。评价需要 product_id。
搜索 price 和价格响应中的 online 对象代表线上价格。卖场货架价格在卖场数据中单独返回。
现货情况报告为 in_stock、low_stock、out_of_stock 或 not_available；它绝不是单位计数。
卖场价格代码衍生自货架价格尾数：.99 常规价格，.97 清仓，.00 或 .88 经理降价，以及 .49、.79 或 .89 特别采购。将这些视为参考指标，而非保证。
搜索、分类和优惠结果是分页的。评价使用 page 和 limit 字段；清仓会扫描可配置数量的结果页面。

高级特性

访问 13 个端点，用于产品搜索、分类、完整产品记录、价格比较、现货情况、评价、卖场、汽油、优惠券、交易、清仓和自动完成。
在搜索结果中添加卖场 ID，以便在同一个请求中检索货架价格和库存详情。
将线上价格与多达 10 个卖场的价格进行比较，响应中包含线上价格。
在支持的情况下，在一个产品详情请求中检索多达 20 个产品 ID。
按品牌、价格、评分、促销状态、库存和相关性筛选和排序搜索；对较大的结果集使用分页。
使用降价价格代码扫描卖场清仓；默认情况下排除特别采购尾数，因为它们也可能出现在常规杂货价格上。
从 AI agent 使用 Scavio Python 或 JavaScript SDK、直接 HTTP 请求或 Scavio MCP 服务器工具。
明确处理 API 故障：在
后更正无效请求，在
后检查凭据，在
后检查 credit，遵守
限制，并谨慎重试临时
错误。
遵循内置的数据安全规则：切勿混淆线上和货架价格，不要推断库存数量，并显露产品 URL 以便用户验证商品列表。

name: costco-product-data description: Costco product data as structured JSON - search and category listings, full item detail, online vs in-warehouse prices at up to 10 warehouses, warehouse stock status, gas prices, the member coupon book, deal feeds, a clearance finder and reviews. 13 endpoints, mostly 1 credit each. version: 1.0.0
tags: costco, costco-api, costco-product-data, costco-prices, warehouse-prices, gas-prices, costco-coupons, clearance, retail, product-search, ecommerce, price-monitoring, product-reviews, competitive-intelligence, catalog-enrichment, agents, ai-agents, structured-data, json, mcp