shopping-expert

Shopping Expert 用于在线与本地查找并比较商品，并按智能评分给出推荐。主要能力：支持 online（通过 Google Shopping 搜电商站点）、local（通过 Google Places API 搜附近商店）、hybrid（线上与本地结果合并排序）、auto（默认，按查询自动选模式）四种搜索模式，返回商品详情、评分、库存与购买链接。基本用法为运行脚本：uv run {baseDir}/scripts/shop.py "coffee maker" --budget medium --max-results 5。常用参数包括 -query（必填）、--mode（online|local|hybrid|auto，默认 auto）、--budget（low/medium/high 或具体金额如 "$100"）、--location、--preferences（逗号分隔，如 "Nike, cushioned, waterproof"）、--max-results（默认 5，最大 20）、--sort-by（relevance|price-low|price-high|rating）、--output（text|json，默认 text）、--country（默认 de，可用 us、uk 等）。预算层级：low 为 50 欧元以下，medium 为 50 至 150 欧元，high 为 150 欧元以上，exact 支持如 "€75" 或美元。评分权重：价格匹配 30%、评分 25%、库存 20%、评论数 15%、运费或距离 10%，偏好关键词为加分项。输出默认是含详情、评分、库存和购买链接的 Markdown 表格，JSON 模式返回结构化数据。需要配置 SERPAPI_API_KEY（除仅本地模式外均需要）和 GOOGLE_PLACES_API_KEY（本地与混合模式需要）。限制：受 API 配额约束；价格与库存实时变化；线上库存反映最近一次 API 更新，本地库存无法保证；查询无效会返回带建议的错误，无结果时会放宽筛选重试，API 失败会以指数退避重试三次，缺少密钥会给出明确提示。