智能购物助手

技能简介

Shopping Expert 是一款购物辅助工具，通过 Google Shopping 和 Google Places API 实现线上电商比价与线下门店定位。支持按预算区间、品牌偏好、功能特征进行筛选，自动综合价格、评分、库存状态生成推荐清单。

能做什么

• 跨平台搜索电商商品（Amazon、Walmart 等）并对比价格
• 定位用户附近的实体店铺及营业信息
• 按低/中/高预算或具体金额过滤结果
• 根据品牌、颜色、功能关键词匹配偏好
• 生成带购买链接的 Markdown 表格或 JSON 数据

使用说明

环境准备

1. 安装 uv：执行 brew install uv
2. 配置 API 密钥：export SERPAPI_API_KEY="your_key"（必需）；如需本地搜索，追加 export GOOGLE_PLACES_API_KEY="your_key"

基础用法

# 线上搜索咖啡机，中等预算
uv run {baseDir}/scripts/shop.py "coffee maker" --budget medium --max-results 5

# 指定金额与偏好
uv run {baseDir}/scripts/shop.py "running shoes" --budget "$100" --preferences "Nike, cushioned"

# 纯本地搜索
uv run {baseDir}/scripts/shop.py "Bio Gemüse" --mode local --location "Hamburg, Germany"

# 混合模式（线上+线下）
uv run {baseDir}/scripts/shop.py "Spiegelreflexkamera" --mode hybrid --location "München, Germany" --budget high --preferences "Canon, 4K Video"

# 美国区域搜索
uv run {baseDir}/scripts/shop.py "running shoes" --country us --budget "$100"

常用参数：–mode 可选 online/local/hybrid/auto；–sort-by 支持 relevance/price-low/price-high/rating；–output 可选 text/json。

输入与输出

见下方输入与输出表格。

风险提示

• SerpAPI 与 Google Places 存在调用配额限制，超额将触发服务中断
• 商品价格与库存状态依赖 API 缓存，非实时数据
• 本地门店库存仅反映 Places API 信息，实际到店可能无货
• 网络异常时自动重试 3 次，仍失败则返回错误提示

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/udiedrichsen/shopping-expert/SKILL.md
来源类型：GitHub 仓库