📦 Wine Info Search — 葡萄酒信息搜索

葡萄酒信息搜索概览 在全球 16+ 主流平台搜索葡萄酒及酒类的详细信息、社区/专业评分与价格。 主要数据源：Wine-Searcher（WebFetch）与 Vivino（Firecrawl）。 Firecrawl 集成（v1.4）通过美国代理 IP + JS 渲染绕过 Vivino 对华 IP 封锁，恢复 Vivino 访问。 Wikipedia API 集成（v1.5）无需 API key，可从中英文维基获取酒庄背景（历史、产区、故事），大陆可访问。 Open Food Facts API 为免费补充源。 支持中英双语酒名映射（110+ 常见酒名），多段替换实现跨语言自动搜索。 WebFetch 辅助实时抓取京东、Wine-Searcher 等价格。 支持 pytesseract / easyocr 图像标签识别。 年份推荐：按评分标签（Outstanding/Very Good/Good/Fair/Poor）及年份购买建议。 按年龄与健康状况定制的饮酒建议。 主食 & 主菜配餐推荐。 一键生成国内（京东/天猫/淘宝/苏宁/拼多多/1919/也买酒/酒仙）及国际（Vivino/Wine.com/Drizly/Total Wine/Wine-Searcher/Wine Spectator/CellarTracker/Decántalo）搜索链接。

数据源 Source Type | Key Required | Data Provided | Status Wine-Searcher (WebFetch) | 无 | 评分、价格、年份、品种、品鉴笔记 | 主源 Vivino (Firecrawl) | 需 API Key | 评分、口感、品种、配餐、价格 | 次源（已恢复） Wikipedia API | 无 | 酒庄背景、历史、产区 | v1.5 三级 Open Food Facts API | 无 | 基础元数据（酒精度、品种、图片） | 补充 Vivino API | 无 | 搜索/详情/评分 | 403 被封 Vivino Web（备用） | 无 | 基础搜索 | 大陆超时 WebFetch Price Hints | 无 | 京东、天猫、Wine-Searcher 实时价 | 可用 Direct Scrape（旧） | 无 | 京东、Wine-Searcher 价格 | 频率低 Platform Link Generator | 无 | 16+ 平台直搜链接 | 可用 Health & Food Database | 无 | 年龄饮酒上限、10 种疾病、6 类配餐 | 内置

数据策略（v1.5） 级联回退：

• Firecrawl → Vivino（配置 FIRECRAWL_API_KEY 后，美代理解锁，数据最全）
• Vivino API（403 放弃）
• Vivino Web（大陆易超时）
• Wine-Searcher 直采（易超时）
• Open Food Facts（永远可达，仅基础信息）

酒庄背景：同时调用 en.wikipedia.org 与 zh.wikipedia.org，自动双语搜索。 年份推荐：沿用 Vivino 年份数据，加标签与购买建议。

AI 代理最佳实践 有 Firecrawl：直接 Firecrawl→Vivino 取全量数据。 无 Firecrawl：以 WebFetch 抓取 Wine-Searcher 为主，脚本输出 WebFetch 所需 URL 与提取指令。

Firecrawl 配置 # 推荐环境变量 export FIRECRAWL_API_KEY=fc-xxxx 免费 500 次/月，注册：firecrawl.dev 启用后 --insecure 自动禁用，防 token 泄露。

核心功能

• 葡萄酒信息搜索（--mode info）