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 で変更されるとこれを公開し、レジストリが受け付けるのは新しいバージョンのみです。ポータブルパッケージでは、plugin.json、mcp.json、skills/、assets/ をリポジトリのルートに配置します。Claude マーケットプレイスのマニフェストも、これらと並行して引き続き利用できます。review/fixtures/ の30行のニュースレターは、ワークフローのレビュー用に提供された合成の価格入力であり、実在する販売業者のオファーや市場の参考情報ではありません。

自然言語によるスキルルーティングの例は、タスクスキルごとに1件ずつ、review/trigger-cases.json に分けて保存されています。OpenAI のレビューケースでは、引き続き6つのコネクタツールと既存のワークフロー例を対象とします。

リリース候補をコミットした後、追跡対象ファイルから 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 のプラグインレビューでは2つのスキルがブロックされるため、OpenAI にアップロードする ZIP は、同じコミットからビルドするフルプラグインのバリアントです。

• python3 scripts/build_release.py は、Claude と Codex 向けのフルプラグイン（5つのタスクスキルすべてと skills/wineauction-reference）をビルドします。
• python3 scripts/build_openai_package.py は、~/Downloads/wineauction-plugin-1.2.1-openai.zip をビルドします。この ZIP では skills/auction-lots を除外し、skills/wineauction-reference を SKILL.md と agents/ を含めずにルートの shared/ フォルダーへ移動して、../wineauction-reference/ のリンクを ../../shared/ に書き換えます。また、plugin.json、mcp.json、LICENSE、assets/、skills/、shared/ のみを残し、openai/ 以下のファイルを結果に適用します（パッケージ内と同じパスを使用）。これらのファイルには、アプリ名の plugin.json、独自の OAuth ブロックを含まない mcp.json、OpenAI 専用の README.md、4つのタスク用 SKILL.md ファイル、中立的な価格調査の表現を使用する共有リファレンスが含まれます。フルプラグインの ZIP にも openai/ が含まれます。Claude ディレクトリがエクスポートルールを拒否するため、リポジトリには .gitattributes のエクスポートルールがありません。

OpenAI 向けビルドでは、ファイルから存在しないパスへのリンクがないこと、auction-lots または wineauction-reference への参照が残っていないこと、秘密情報に見える内容がパッケージに含まれていないことをチェックします。どちらのビルドも scripts/local_ci.sh で実行されます。OpenAI に渡す内容を変更する場合は、追跡対象ファイルではなく openai/ 内のコピーを編集してください。