kalicart-global

KaliCart Global — AI エージェント向け連合型コマース検索

複数の独立した WooCommerce ストアを一度のクエリで検索できます。実際の商品、マーチャントが決定権を持つ価格、インデックス化されたスナップショットに加え、マーチャントに戻ってライブ検証するための手順も文書化されています。API キー不要、読み取り専用、登録不要です。

KaliCart Global は、ARC（Agent-Readable Catalog）プロトコルにオプトインした独立マーチャントの商品オファーを AI エージェントが検索できる、公開 Model Context Protocol サーバーです。ストアフロントをスクレイピングして価格や在庫を推測する代わりに、エージェントは構造化された連合型インデックスをクエリし、信頼できるデータを取得してから、購入手続きのために買い物客をマーチャント自身のストアへ引き継ぎます。サーバー自体が取引を行うことはありません。

• エンドポイント： https://global.kalicart.com/mcp-public（リモート、Streamable HTTP）— 互換性のあるエイリアスとして https://dashboard.kalicart.com/mcp-public も利用できます
• レジストリ： io.github.giuseppesocci-bot/kalicart-global — 公式 MCP レジストリ、ステータス active
• ドキュメント： https://bridge.kalicart.com/mcp/ · ARC プロトコル： https://bridge.kalicart.com/spec/ · プロバイダー認可： https://global.kalicart.com/providers/
• 法的情報： https://global.kalicart.com/terms/（任意の連合型プロバイダー配信チャネルを含む利用規約） · https://global.kalicart.com/privacy/（プライバシーに関する通知）

開発の背景

機械が商品ページを読むだけなら、クロールでうまくいきます。しかし、エージェントが実際の価格や在庫に基づいて行動する必要が生じた瞬間に、問題が起こります。価格が古い可能性があり、在庫が実際には存在しない可能性があり、バリエーションが存在しない可能性もあります。KaliCart は、カタログを単にクロール可能にするのではなく、計算可能にすることを目指しています。設計上クエリ可能で信頼性の高いデータを、インデックス化されたスナップショットとして提供し、チェックアウト前のライブ検証のためにマーチャント自身の Bridge へ引き継ぐ手順も文書化しています。

この方法でカタログを読み取ると、コストも大幅に抑えられます。Bridge レイヤーに関する関連ケーススタディでは、626 件の商品を持つライブカタログをエージェントに提供するのに必要なトークン数は、196,595 ではなく 8,000 トークンと測定されました。約 24 分の 1 の削減により、一覧がモデルのコンテキストウィンドウに収まり、あふれずに済みます（こちらをお読みください）。Global は、同じ構造化された低コストのインターフェースを、多数のマーチャントに一度に提供します。

接続

API キーやアカウントは不要です。MCP クライアントにリモート（Streamable HTTP）サーバーとして追加します。

{
  "mcpServers": {
    "kalicart-global": {
      "url": "https://global.kalicart.com/mcp-public"
    }
  }
}

ツール

5 つのツールはすべて、公開されており、API キー不要、読み取り専用、冪等です。

ツール	目的
global_search	フリーテキスト（q）および／または正規カテゴリ（leaf）で連合型インデックスを検索し、ファセットフィルター（ブランド、性別、色、価格帯、在庫）を適用します。マーチャントが決定権を持つ価格、UCP availability_status、ストアフロント URL、正規カテゴリのリーフを含むオファーを返します。
get_product	global_search で取得した p2209_id を使って、価格、提供状況、属性、バリエーション、ストアフロントの直接 URL など、商品の詳細情報を取得します。
lookup_merchant	マーチャントのドメインが ARC 準拠のカタログ（KaliCart Bridge）を運用しているか確認します。Bridge のバージョン、ディスカバリー URL、連合型インデックスへの登録に関する同意フラグを返します。該当しない場合は、バックグラウンドチェックをキューに追加するのではなく、probe: "not_scheduled" を返します。連合型インデックスへの登録に関する同意は、マーチャントが任意で特定の外部プロバイダーを認可することとは別です（上記の法的情報を参照）。このツールは、プロバイダーごとの認可状況を報告しません。
list_merchants	参加マーチャントを、ドメイン、ストアフロント URL、商品数とともに一覧表示します。
list_categories	商品数を含む正規カテゴリのリーフを一覧表示します。parent による絞り込みに対応しています。

一般的な流れ：list_categories / list_merchants で対象範囲を確認 → global_search でオファーを検索 → 最終候補に対して get_product を実行 → マーチャントのストアフロント URL に引き継ぎます。

動作に関する注意事項

• global_search に q も leaf も指定しない場合、空の結果セットではなく query_required エラー（guidance_code: USE_Q_OR_LEAF）が返されます。少なくともどちらか一方を指定してください。
• list_categories を parent なしで呼び出すと、1 回の呼び出しで最大 100 個の末端カテゴリが返されます。それ以上ある場合は、truncated: true とともに total および complete_via が返されます。全件を取得するには、parent で絞り込むか、ページングのヒントを使用してください。
• 検索結果と商品詳細は、インデックス化されたスナップショット（provenance.fetched_at）であり、ライブデータベースの読み取りではありません。価格や在庫を確定情報として扱う前に、Bridge への引き継ぎを通じて選択したオファーを確認してください。
• フリーテキストのクエリは、各マーチャントのカタログに記載された原文に一致します。サーバー側での翻訳はありません。言語に依存しない検索には、leaf とファセットフィルターを使用してください。
• 価格フィルターは各オファーのマーチャント通貨で適用されます。為替換算は行われません。
• ページネーションには対応していません。limit を使用してください（オファーは最大 25 件、マーチャントは最大 50 件）。

このリポジトリは、サーバーの公開インターフェースとして、ドキュメント、課題追跡、セキュリティに関する連絡先を提供します。サーバーはホステッドサービスであり、そのソースコードはここでは公開されていません。

MIT ライセンスの適用対象はこのリポジトリの内容のみです。ホステッドサービスとカタログデータには、利用規約が適用されます。

UCP カタログ

KaliCart Global は Universal Commerce Protocol の Catalog 機能（仕様 2026-08-25）にも対応しているため、あらゆる UCP ショッピングエージェントが、他の UCP カタログと同様に独立した WooCommerce ストアを検索できます。

• プロファイル： https://global.kalicart.com/.well-known/ucp（カタログ検索と照会に対応。チェックアウトには非対応）
• エンドポイント： https://global.kalicart.com/ucp/mcp（Streamable HTTP）
• ツール： search_catalog、lookup_catalog、get_product。すべてのリクエストに meta["ucp-agent"].profile を含める必要があります。

動作の概要：

• すべてのバリエーションには、その販売者（マーチャント）と、ストアへのリンク、および宣言されている場合は返品ポリシーが含まれます。
• search_catalog はインデックス化されたスナップショット（metadata.kalicart.snapshot_at）を返します。get_product と lookup_catalog は、制限時間内に応答がある場合、マーチャントの KaliCart Bridge から価格と在庫状況をライブで取得し（metadata.kalicart.source = "live"）、スナップショットにフォールバックした場合はその旨を示します。
• 価格は ISO 4217 の最小通貨単位で表されます。識別子は安定しています：gid://kalicart/Product/… および gid://kalicart/ProductVariant/…。
• カテゴリには KaliCart の標準タクソノミー（taxonomy: "kalicart"、例：home.bedroom.pillows）を使用します。これらは filters.categories に渡してください。
• 対象範囲： 公開 Global API と同じカタログです。オプトインしたすべてのマーチャントが含まれます。ワイン、蒸留酒、デジタル商品も対象ですが、購入時には各ストア独自の年齢確認と法的確認が適用されます。特定のプラットフォーム向けに構築されたインターフェースには、そのプラットフォームのより限定的な商品ポリシーが適用されますが、UCP エンドポイントには適用されません。
• KaliCart Bridge をインストールし、オプトインしたマーチャントのみがインデックス化されます。KaliCart は販売、チェックアウト、決済を行いません。購入はマーチャントのストアで行われ、最終的な判断はそのチェックアウトに委ねられます。

フィードバック

このサーバーを評価または統合する際に予期しない動作が発生した場合は、issue を作成してください。リクエストの UTC タイムスタンプを含めると、サーバーログとの照合に役立ちます。

セキュリティに関する事項については、SECURITY.md をご覧ください。脆弱性を公開 issue で報告しないでください。

関連情報

• KaliCart Bridge — 個々のマーチャントのカタログをエージェントから読み取り可能（ARC）にする、無料の WooCommerce プラグインです。Bridge は各ストアの入口であり、Global はそのような入口を横断する連合インデックスです。
• kalicart-mcp — WordPress コンテンツ向けのサイトごとの MCP プラグインです。

---

Save The Brain が保守 · Giuseppe Socci