基于 Google Shopping 和 Google Places API 的智能购物助手，支持在线比价、本地门店搜索及混合模式，自动根据价格、评分、库存和用户偏好推荐最优商品。
说明：
## 核心用法
**Shopping Expert** 是一款集成 Google Shopping 与 Google Places API 的购物决策工具，提供四种搜索模式（online/local/hybrid/auto）满足不同场景需求。用户通过自然语言查询商品，可叠加预算约束（low/medium/high 或精确金额）、偏好过滤（品牌/功能/颜色）及地理位置参数，系统返回带购买链接和门店信息的结构化结果。
### 显著优点
– **智能评分算法**：综合价格匹配度（30%）、评分（25%）、库存（20%）、评论数（15%）、配送/距离（10%）及偏好匹配 bonus 进行多维度排序
– **灵活的预算体系**：支持模糊档位（低/中/高）和精确金额（�X/$X）双模式
– **本地化能力**：hybrid 模式合并线上价格与线下门店信息，适合即时需求场景
– **多区域支持**：通过 `–country` 参数切换德国（默认）、美国、英国等市场
– **健壮性设计**：API 失败时自动指数退避重试（3 次），无结果时智能放宽过滤条件
### 潜在缺点与局限性
– **API 依赖性强**：核心功能依赖 SerpAPI 和 Google Places 的商业配额，高频使用成本显著
– **数据时效性缺口**：库存状态为 API 上次抓取结果，非实时同步；本地门店库存通过 Places API 无法精确确认
– **评分算法黑盒**：权重配置（30/25/20/15/10）固定不可调，难以适应个性化决策偏好
– **地理覆盖不均**：Google Places 本地搜索在非欧美地区数据质量参差不齐
– **输出格式单一**：JSON 输出虽结构化但缺乏与常见购物清单应用（如 Keep、Notion）的原生集成
### 适合人群
– 价格敏感型消费者（跨平台比价需求）
– 即时购物场景用户（需确认附近门店库存）
– 代购/跨境电商从业者（多国家参数切换）
– 开发者构建自动化采购工作流（JSON 输出便于二次处理）
### 常规风险
– **API 密钥泄露风险**：SERPAPI_API_KEY 和 GOOGLE_PLACES_API_KEY 需本地环境变量配置，共享环境或 CI/CD 中需额外防护
– **预算误配风险**：精确金额解析依赖货币符号（�/$），输入格式错误可能导致过滤失效
– **链接安全性**：返回的购买链接为第三方电商直达，无内置恶意链接检测机制
– **隐私暴露**：local/hybrid 模式需提交地理位置信息至 Google Places API
会员专属
