Shopping Expert

核心用法

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

核心功能

shopping-expert是一款智能购物比价工具，整合线上电商（Google Shopping）与线下实体店（Google Places）数据，通过多维度评分算法为用户自动筛选最优商品。支持四种搜索模式（online/local/hybrid/auto），可处理自然语言预算描述（low/medium/high或精确金额），并按价格、评分、库存、配送等因素智能排序。

显著优势

1. 双渠道覆盖：同时搜索亚马逊等电商平台和附近实体店铺，支持德国、美国、英国等多国市场
2. 智能评分系统：价格匹配(30%)+评分(25%)+库存(20%)+评论数(15%)+配送/距离(10%)的加权算法
3. 灵活偏好过滤：支持品牌、功能、颜色等关键词过滤，自动匹配产品描述
4. 多格式输出：默认Markdown表格直观展示，JSON格式便于二次开发集成

潜在局限

• API配额依赖：SerpAPI和Google Places均有调用次数限制，高频使用可能触发配额
• 数据时效性：价格和库存信息依赖API最后更新时间，非实时同步
• 本地库存盲区：Google Places无法获取实体店实时库存，需电话确认
• 地区覆盖不均：部分国家/城市的本地商店数据完整度有限

适合人群

• 注重性价比的理性消费者
• 需要同时对比线上价格与线下体验的用户
• 跨境购物或海外代购需求者
• 预算敏感型采购决策者（学生、初创团队等）

风险提醒

需自行配置SERPAPI_API_KEY（线上搜索必需）和GOOGLE_PLACES_API_KEY（本地搜索必需），API密钥泄露可能导致配额被盗用。建议通过环境变量安全配置，避免硬编码。