Shopping Expert — 购物专家

购物专家 在线和本地查找和比较产品，提供智能推荐。 快速开始 在线查找产品： uv run {baseDir}/scripts/shop.py "咖啡机" --budget medium --max-results 5 带有预算约束的搜索： uv run {baseDir}/scripts/shop.py "跑步鞋" --budget "$100" --preferences "Nike, 缓冲, 防水" 查找本地商店： 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 "跑步鞋" --country us --budget "$100" 搜索模式 online：通过 Google Shopping 的电子商务网站（Amazon, Walmart 等） local：通过 Google Places API 的附近商店 hybrid：在线和本地结果合并和排名 auto：基于查询的智能模式选择（默认） 参数 query：产品搜索查询（必需） --mode：搜索模式（online|local|hybrid|auto，默认：auto） --budget： "低/中/高" 或 "€X"/"$X" 金额（默认：中） --location：本地/混合搜索的位置 --preferences：逗号分隔的首选项（例如 "品牌：Sony, 无线, 黑色"） --max-results：返回的最大产品数量（默认：5, 最大：20） --sort-by：排序顺序（相关性|价格-低|价格-高|评分） --output：文本|json（默认：文本） --country：搜索的国家代码（默认：de）。使用 "us" 表示美国，"uk" 表示英国等 预算级别 低：低于 €50 中：€50-€150 高：超过 €150 确切： "€75", "€250"（或 "$X" 表示美国搜索） 输出格式 默认（文本）：带有产品详细信息、评分、可用性和购买链接的 Markdown 表格 JSON：带有所有产品元数据、评分和链接的结构化数据 评分算法 产品使用加权评分排名： 价格匹配（30%）：在预算范围内获得满分 评分（25%）：更高的评分获得更好的评分 可用性（20%）：有货 > 有限 > 缺货 评论数量（15%）：更多评论 = 更可靠 运输/距离（10%）：免费运输或附近商店获得更高的评分 首选项匹配（奖励）：产品描述中的关键词 API 密钥 SERPAPI_API_KEY：在线购物所需（除本地模式外） GOOGLE_PLACES_API_KEY：仅本地和混合模式所需 限制 API 限制：SerpAPI 和 Google Places 有使用配额 实时数据：价格和可用性可能会更改 库存准确性：在线可用性反映了最后一次 API 更新 本地库存：商店库存通过 Places API 不保证 错误处理 无效查询 → 返回错误并提供建议 未找到结果 → 放松过滤器并重试 API 失败 → 使用指数退避（3 次尝试）重试 缺少 API 密钥 → 清晰的错误消息和设置说明