BestPrice

BestPrice MCP

BestPrice.gr（ギリシャの価格比較サービス）向けの公式Model Context Protocolサーバーです。AI アシスタントが買い物の判断、リアルタイムの商品検索、オファーの比較、価格履歴を読み取り専用で利用できます。アカウントや API キーは不要です。

買い物を始める

• ChatGPT で BestPrice を開くし、公開済みのプラグインを追加してください。
• 事前入力されたコネクターのフォームを使って、BestPrice を Claude に接続してください。
• 例やほかのアシスタントについては、買い物ガイドをご覧ください。

開発者向けの連携には、次の公開エンドポイントを使用します。

https://mcp.bestprice.gr/mcp

• トランスポート：HTTPS 経由の Streamable HTTP。匿名での買い物に対応し、Events には任意で OAuth を利用できます
• 公式レジストリ ID：gr.bestprice/mcp
• サーバーのバージョン：1.8.4
• 公開ガイド：https://www.bestprice.gr/mcp
• サポート：https://www.bestprice.gr/contact

このリポジトリには、ホストサービスの外部にあるものがすべて含まれています。各 AI クライアント向けのインストールマニフェスト、HTTP に対応できないホスト向けのローカル stdio ブリッジ、ブラウザー標準の WebMCP レイヤーなどです。サーバー本体はこのリポジトリには含まれていません。

現在のリリースマトリックスには、稼働中のゲートウェイ、UI、OAuth／Events、プラグイン審査、および個別の ACP 認定が記載されています。

ツール

ツール	機能	主な引数
get_shopping_decision	BestPrice Shopping Brain を実行します。根拠に基づくおすすめ、ニーズに応じた比較、または理由、トレードオフ、不明点を含む読み取り専用の買い物かごプランを提示します。	message（予算などを含む、ギリシャ語または英語での要望）、任意の postal_code（買い物かごプランを完成させるには必須）、任意の evidence_detail（summary：デフォルト。回答で引用する根拠のみ、full：すべての主張と出典）
search_products	カタログから正規の商品を検索します。商品 ID と、送料を含まないカタログ内の最低価格を返します。	query（2～200 文字：商品名、モデル、カテゴリー、または GTIN／EAN バーコードのみ）、任意の price_min、price_max、required_features、sort（relevance、price_asc、price_desc）、limit（1～8）
compare_offers	1 つの正確な商品について、現在の販売店のオファーを比較し、商品価格、送料、配送込みの合計額を分けて表示します。	前回の結果にある product_id、任意の postal_code（配送込みの合計額を算出するためのギリシャの郵便番号、10000～85999）、objective、in_stock_only、minimum_merchant_rating、limit（1～10）
get_price_history	商品の価格推移を、過去 180 日間の中央値と比較して要約します。	product_id、任意の period_days（30、90、180）

4 つのツールはすべて読み取り専用です。注文の確定、アラートの作成、アカウントデータの読み取りは行いません。結果は BestPrice の商品ページにリンクし、販売店へ直接リンクすることはありません。送料が不明な場合は無料とせず、不明として報告します。検索対象は安全な実物商品です。デジタル商品、サービス、年齢制限のあるカテゴリーは対象外です。

プロトコルの詳細

2026 年 9 月 24 日に稼働中のエンドポイントで測定した結果です。

• バージョン。 initialize では 2025-11-25、2025-06-18、2025-03-26、2024-11-05 および 2024-10-07 のネゴシエーションを行います。これ以外のバージョンを要求するクライアントには 2025-11-25 を返します。リクエストごとのリビジョン 2026-07-28 にも対応しています。 MCP-Protocol-Version、Mcp-Method（および tools/call の場合は Mcp-Name）ヘッダーを送信し、 すべてのリクエストの _meta に io.modelcontextprotocol/protocolVersion と io.modelcontextprotocol/clientCapabilities を指定してください。このエンベロープなしでリビジョンを 指定したリクエストは、-32602 で拒否されます。
• ステートレス。 MCP-Session-Id は発行されず、不要です。DELETE には 405 が返されます。 Accept: text/event-stream を指定した GET でキープアライブストリームが開きますが、サーバーが そのストリーム上でリクエストや通知を送信することはないため、開かなくてもクライアントに不利益はありません。
• 機能。 互換性のあるクライアントでは tools と resources を利用できます。リソースには、 オプションの MCP Apps UI ui://bestprice/shopping-results-v1.html、サーバーカード mcp://server-card.json、正規の skill://bestprice-shopping/SKILL.md が含まれます。 MCP 2026-07-28 では、サーバーは最終版の io.modelcontextprotocol/skills 拡張機能も宣言します。 skills/list と skills/get は、SHA-256 ダイジェストとバイトサイズを含む BestPrice Shopping Skill 1 件を返し、resources/read は正確な Markdown バイト列を返します。古いクライアントには、 Skill は通常のリソースとして表示されます。プロンプト、補完、ロギングはなく、これらのメソッドには -32601 が返されます。
• レスポンス。 application/json と text/event-stream の両方を受け入れるクライアントには、 1 イベントの SSE レスポンスが返されます。Accept: application/json、*/*、または Accept ヘッダーなしの場合は、 単一の JSON ボディが返されます。すべてのツールは outputSchema に適合する structuredContent と、 構造化コンテンツをモデルに渡さないクライアント向けに同じ結果をテキストでも返します。
• エラー。 不明なツールは JSON-RPC エラー（-32602）になります。不正な引数や、不明な商品などの サービス障害は isError: true を含むツール結果として返されるため、モデルが内容を読み取り、修正できます。
• 制限。 JSON リクエストボディの上限は 256 KiB（超過時は 413）、リクエストの期限は 12 秒です。 クライアントごとのレート制限を超えた場合は、HTTP 429、JSON-RPC エラー -32029、 Retry-After ヘッダーが返されます。JSON-RPC のバッチ配列は 400 で拒否されます。
• ブラウザー。 デスクトップ、CLI、サーバーサイドのクライアントは Origin ヘッダーを送信しないため、 影響を受けません。ブラウザーのページは、許可リストに登録された AI ホストのオリジン、bestprice.gr、 または localhost（MCP Inspector がダイレクトモードで動作するようにするため）からエンドポイントを呼び出せます。 それ以外のオリジンには 403 が返されます。
• 認証。 4 つのショッピングツールはアカウントなしで利用できます。オプションのアカウント連携は events:subscribe のみに適用されます。保護対象リソースのメタデータは /.well-known/oauth-protected-resource と /mcp/oauth-protected-resource で利用できます。 エンドツーエンドの適格性確認中、Events は無効のままです。

開発者向けクイックスタート

以下のすべてのクライアントは、同じエンドポイントに接続します。OpenAI、Grok、GitHub Copilot、 Microsoft Copilot Studio を含む、プロバイダーごとの詳しい手順は docs/provider-setup.md にあります。

Claude

BestPrice を Claude に接続する を開くと、エンドポイントがあらかじめ入力されたカスタムコネクターのフローが表示されます。Claude Code の場合：

claude mcp add --transport http bestprice-shopping https://mcp.bestprice.gr/mcp

同梱の .mcp.json は、これと同等のプロジェクトスコープの設定です。

Cursor

BestPrice を Cursor に追加する を開くと、追加する前にデコード済みの設定が表示されます。.cursor-plugin/ ディレクトリには、マーケットプレイスプラグインとエージェントスキルが含まれています。

VS Code

VS Code に BestPrice を追加

Gemini CLI と Qwen Code

gemini extensions install https://github.com/TheBestCo/bestprice-mcp
qwen extensions install https://github.com/TheBestCo/bestprice-mcp --consent

どちらの拡張機能も、インポートするツールを上記の4つに限定します。

Codex、Claude プラグイン、Agent Skill ホスト

ルートの plugin.json、mcp.json、および skills/bestprice-shopping/SKILL.md は、移植可能な Agent Plugins パッケージを構成します。MCP はリアルタイムのショッピングデータを提供し、Skill は、ブランド名を指定しないギリシャ語のショッピング意図をいつ、どのようにルーティングするかをホストに伝えます。 .agents/skills/ 配下にリポジトリ内のスキルを検出するエージェント対応ホストでは、 .agents/skills/bestprice-shopping/SKILL.md にある同じ標準ワークフローを利用できます。.codex-plugin/ は引き続き Codex 互換マニフェストとして機能します。.claude-plugin/plugin.json](.claude-plugin/plugin.json) と、同じルート Skill および .mcp.json により、このリポジトリは Claude プラグインパッケージとしても利用できます。

セルフホスト可能なプラグインマーケットプレイス

ツールや Skill のロジックをコピーせずに、同じリポジトリをプラグインマーケットプレイスとして直接追加できます。

copilot plugin marketplace add TheBestCo/bestprice-mcp
copilot plugin install bestprice-shopping@bestprice

claude plugin marketplace add TheBestCo/bestprice-mcp
claude plugin install bestprice-shopping@bestprice

Copilot は .github/plugin/marketplace.json を読み取り、 Agent Plugins 1.0 に基づいて、ルートの標準 plugin.json、mcp.json、および skills/bestprice-shopping/SKILL.md を読み込みます。Claude は .claude-plugin/marketplace.json を読み取り、 .claude-plugin/plugin.json、.mcp.json、および同じルート Skill を使用します。

Gemini API、DeepSeek、Z.ai

実行可能なサンプルは examples/ にあります。Gemini Interactions API と Genkit、 DeepSeek Harness のプラグインエントリー、および Z.ai GLM の呼び出し例です。各サンプルには、プロバイダー固有の API キーが必要です。 BestPrice には必要ありません。

その他の MCP クライアント

https://mcp.bestprice.gr/mcp に Streamable HTTP サーバーを追加してください。ホストが stdio サーバーにしか対応していない場合は、このリポジトリのブリッジを使用してください。

git clone https://github.com/TheBestCo/bestprice-mcp.git && cd bestprice-mcp
npm ci
node stdio.mjs

ブリッジはすべてのリクエストをパブリックエンドポイントに転送し、2つの環境変数を受け付けます。 BESTPRICE_MCP_URL（デフォルト：パブリックエンドポイント）と BESTPRICE_MCP_TIMEOUT_MS（デフォルト：60000）です。Dockerfile は、Glama などのホスト向けに同じブリッジをビルドします。

安全に始めるための会話

1. 条件を指定して相談します：Θέλω κινητό έως 500 ευρώ με NFC και 5G υποχρεωτικά. （NFC と 5G が必須で、500 ユーロ以下の携帯電話が欲しいです。）
2. または検索します：Find Sony WH-1000XM5 under 300 euros.
3. 返された product_id と郵便番号 10558 を compare_offers に渡します。
4. 同じ product_id を get_price_history に渡して、過去180日間の価格を確認します。

ギリシャ語または英語で検索できます。結果の概要、カタログデータ、販売店名はギリシャ語で返されます。

検索	販売価格を比較	価格履歴

ブラウザー標準の WebMCP

BestPrice のページでは、互換性のあるブラウザーで、コンテキストに応じた 22 個の WebMCP ツール（コントラクト 2.8）を登録します。各ツールは読み取りか操作のどちらか一方のみを行い、両方を行うことはありません。構造化された検索結果を取得する検索（価格、在庫、セール、並び順による絞り込み）と、検索で返された結果ページをタブで開く機能、買い物客の買い物リストと比較（どのページでも読み取り可能で、商品ページでは追加と削除が可能）、値下がり通知のダイアログ、表示中の商品と追加読み込み、フィルターと並べ替え、 ID による任意の商品ページの表示（タブが移動する前に読み取り）、商品情報、販売情報、仕様、価格履歴（グラフ付き）、表示中の販売情報に対するアクション 1 つ、そして BestPrice Shopping Brain を対象とします。これらは記事やストアを含むすべての公開ページで利用でき、販売店の選択は買い物客に委ねられます。すべてのツールは入力スキーマと出力スキーマを公開します。コントラクト、フェイルクローズのランタイム、決定論的な評価器、自然言語の 47 ケースのデータセットは、webmcp/ にあります。

検出

• 公式 MCP Registry
• オープンなエージェント検出：ard.json、 ai-catalog.json、 サーバーカード、および プロバイダーに依存しない BestPrice Shopping スキル。 ARD の例では、意図的にブランド名を含めない買い物客の意図を使用しています。ユーザーが BestPrice を知る前に、「何を買うべきか」、配送料込み価格、価格の買い時に関するリクエストを検出できるようにするためです。
• webmcp.json では、BestPrice のページが公開するコンテキスト対応のブラウザーツールについて説明しています。
• このリポジトリは bestprice-shopping として Gemini CLI 拡張機能ギャラリー に掲載されています（Google はタグ付きの公開拡張機能リポジトリをクロールします）。一方、GitHub Agent Finder は公開 MCP カタログと ARD リソースを取り込めます。
• コピーしてすぐに使える、CI でバージョンを固定した外部カタログへの登録内容は、distribution/ の下にあります。 GitHub Agent Finder Skill のエントリーと Docker MCP Registry のリモートサーバーエントリーです。これらのカタログへの登録には、それぞれのリポジトリでのレビューが必要です。ここに含まれるファイルは提出用の内容であり、外部の掲載がすでに公開されていることを示すものではありません。
• コミュニティのインデックス：Glama、 WebMCP Registry、 webmcp.com、 cursor.directory

開発

npm ci
npm run check   # Biome lint and format
npm test        # node --test: bridge, WebMCP, manifests, dataset

テストにネットワークは不要です。ブリッジはプロセス内の偽リモートを使ってテストします。Node 20 以降が必要です。.nvmrc では 22 に固定しています。

バージョン管理

このリポジトリには、意図的に 2 種類のバージョンが記載されています。

• package.json と各プラグインまたは拡張機能のマニフェストに記載されるパッケージバージョン。このリポジトリのマニフェスト、ブリッジ、または WebMCP レイヤーが変更されると更新され、vX.Y.Z の形式でタグ付けされます。
• server.json と README の冒頭付近に記載されるサーバーバージョン。ホスト型サービスが報告するバージョンで、公式 MCP Registry に公開されます。

CHANGELOG.md ではパッケージバージョンを追跡します。

ホスト型サービスのタイムスタンプ付きチェックは別途記録されています。 9 月 7 日の Shopping Brain v12 の検証 には、正確なゲートウェイリビジョン、サニタイズ済みのカナリア結果、対象範囲の制限が記載されています。

セキュリティ

脆弱性は、SECURITY.md の説明に従って非公開で報告してください。

コントリビューション

CONTRIBUTING.md をご覧ください。イシューやプルリクエストを歓迎します。

ライセンス

Apache License 2.0。著作権者：The Best Company S.A. LICENSE をご覧ください。

プライバシー：https://www.bestprice.gr/policies/privacy · 利用規約：https://www.bestprice.gr/policies/terms