WineAuction

WineAuction 插件

将提供的葡萄酒报价与零售和拍卖市场价格进行比较，并查询葡萄酒价格、历史拍卖成交记录、当前报价和可用的酒评。数据来自 WineAuction。

功能

• WineAuction 连接器（https://wineauction.ai/api/mcp）：首次使用时，使用你的 WineAuction 账户登录。
• 技能，每种用例对应一个：
  • restaurant-wine-list：你提供的餐厅酒单（照片、PDF、链接或文本），或指定的餐厅。显示每瓶酒相对于零售和拍卖价格的加价幅度。
  • merchant-offer-check：商家的邮件、简报、期酒报价、价目表或单条报价。根据市场价格评估每个报价。
  • auction-lots：你提供的拍卖清单或拍品，或指定的拍卖会或拍卖行。查询低于市场价的拍品、即将结束的拍品、成交结果和定期追踪。
  • wine-info：葡萄酒、生产商、年份或产区：零售和拍卖价格、过往成交记录、酒评以及当前在售渠道。
  • cellar-valuation：你拥有的酒瓶清单。估算每瓶及总价值，分别按拍卖价和零售价计算。
  • wineauction-reference：共享工具字段、价格解读规则、酒单解析，以及上述技能链接到的 HTML 报告生成器。

版本 1.2.1 说明了拍卖参考数据的回退机制：如果指定年份有成交记录，则采用该年份；否则汇总所有年份的数据，并通过 vintage_basis 标明采用的依据。

安装

Claude Code：

/plugin marketplace add antyser/wineauction-plugin
/plugin install wineauction@wineauction

然后运行 /mcp，并登录 wineauction。

Codex：

codex plugin marketplace add antyser/wineauction-plugin

然后从插件目录安装 WineAuction，并按提示登录。该仓库包含两套清单：供 Claude 使用的 .claude-plugin/ 和 .mcp.json，以及供 OpenAI 使用的 plugin.json、mcp.json 和 .agents/plugins/。skills/ 中的技能为共用技能。

Claude（网页、桌面和 Cowork），仅连接器：打开 Customize > Connectors，在目录中搜索 WineAuction，点击 Connect，然后使用你的 WineAuction 账户登录。

Claude（含技能）：前往 Customize > Plugins，添加市场 antyser/wineauction-plugin，然后安装 WineAuction。打开插件的 Connectors 标签页并连接 WineAuction 连接器，使用你的 WineAuction 账户登录。

ChatGPT（仅连接器，直到该插件列入 ChatGPT 目录）：打开 chatgpt.com/plugins，点击 Add，然后点击 Add custom MCP server。将名称设为 WineAuction，粘贴 https://wineauction.ai/api/mcp，保持 Authentication 设为 OAuth，勾选 "I understand and want to continue"，点击 Create as a plugin，然后使用你的 WineAuction 账户登录。

每款应用的分步说明请见 wineauction.ai/mcp。

数据

插件本身不会收集任何信息。每次调用工具都会将你的查询（葡萄酒名称、筛选条件或你要求评估的价格）发送至 https://wineauction.ai/api/mcp 并返回结果。所有工具均为只读。HTML 报告在本地生成；联网查看时会加载 Google Fonts，否则使用系统字体。请参阅隐私政策和服务条款。

支持

请在 github.com/antyser/wineauction-plugin/issues 提交问题。

说明

• 价格以美元计，按每 750 ml 计算。拍卖价格包含买家佣金。
• 技能中的 evaluate_offers 每次调用最多评估 25 行；较长的清单会分批发送。
• 工具仅读取数据，不能出价、购买或联系任何人。

构建并验证发布版本

带版本号的清单和 server.json 使用相同的发布版本。server.json 是 MCP Registry 的官方条目；当 .github/workflows/mcp-registry.yml 在 main 上发生更改时，会发布该条目，而 Registry 只接受新版本。便携包将 plugin.json、mcp.json、skills/ 和 assets/ 保留在仓库根目录；Claude 市场清单仍与它们并列提供。review/fixtures/ 下的 30 行 newsletter 是用于工作流审查的合成供价输入，并非真实商家报价或市场参考数据。

自然语言技能路由示例单独保存在 review/trigger-cases.json 中，每项任务技能各有一个；OpenAI 审查案例仍涵盖六个连接器工具和现有工作流示例。

提交发布候选版本后，使用已跟踪文件构建 ZIP：

python3 scripts/build_release.py

默认输出为 ~/Downloads/wineauction-plugin-1.2.1.zip。若要验证候选提交及其打包的渲染器，请运行：

scripts/local_ci.sh "$(git rev-parse HEAD)"

本地检查要求在指定提交上使用干净的检出状态，验证清单和审查案例，构建并检查 ZIP，并从归档中运行渲染器。它使用 Python 3 和 Node.js。

OpenAI 包

OpenAI 的插件审查会拦截两项技能，因此上传到 OpenAI 的 ZIP 是完整插件的一个变体，基于同一提交构建：

• python3 scripts/build_release.py 为 Claude 和 Codex 构建完整插件（全部五项任务技能和 skills/wineauction-reference）。
• python3 scripts/build_openai_package.py 构建 ~/Downloads/wineauction-plugin-1.2.1-openai.zip。它会移除 skills/auction-lots，将 skills/wineauction-reference 移至根目录下的 shared/ 文件夹，并排除其 SKILL.md 和 agents/；将 ../wineauction-reference/ 链接改写为 ../../shared/；仅保留 plugin.json、mcp.json、LICENSE、assets/、skills/ 和 shared/；并将 openai/ 下的文件覆盖到生成的包中（路径与包内路径相同）：应用名称对应的 plugin.json、不包含自身 OAuth 配置块的 mcp.json、OpenAI 专用的 README.md、四个任务 SKILL.md 文件，以及采用中性价格研究措辞的共享参考文件。完整插件 ZIP 也包含 openai/；仓库没有 .gitattributes 导出规则，因为 Claude 目录会拒绝这些规则。

OpenAI 构建会检查是否有文件链接指向不存在的路径、是否仍有内容引用 auction-lots 或 wineauction-reference，以及打包内容中是否包含类似密钥的材料。两种构建都会在 scripts/local_ci.sh 中运行。若要更改 OpenAI 收到的内容，请编辑 openai/ 副本，而不是已跟踪的文件。