記事のサマリー(TL;DR)
- ShopifyストアフロントはUCP 2026-08-25から、位置情報関連の新機能
dev.ucp.common.location.searchとdev.ucp.common.location.lookupに対応しました。 - これらの機能をストアフロントMCPエンドポイント経由でネゴシエートすると、エージェントは加盟店の実店舗を名称・都市・距離で検索・絞り込みし、特定商品を取り扱う店舗を確認できます。
- この機能は任意(オプトイン)のもので、現在ロケーション機能を利用していない場合は変更の必要はありません。
利用条件・対象範囲
- 対象となるのは、UCP 2026-08-25でストアフロントMCPエンドポイントを使用し、いずれかのロケーション機能をネゴシエートするプラットフォームおよびエージェントです。
- 実店舗(retail location)を持たないショップは、これらの機能・ツールを公開しません。
- これらの機能を宣言しない連携、または旧バージョンのUCPをネゴシエートする連携は影響を受けません。
詳細
変更内容
少なくとも1つの実店舗を持つストアフロントは、/.well-known/ucpのディスカバリープロファイルに両方のロケーション機能を掲載するようになりました。ここでいう実店舗(retail location)とは、加盟店が対面販売のために設定し、「Physical storefront」として有効化した、アクティブかつ加盟店が管理するロケーションを指します。
エージェントプロファイルがこれらの機能をネゴシエートすると、ストアフロントMCPエンドポイント(https://{storedomain}/api/ucp/mcp)は以下の2つのツールを公開します。
- search_locations:ショップの実店舗一覧を返します。空のロケーションオブジェクトを指定すると最初のページを返します。店舗名・都市に一致するクエリ、明示的な中心点と最大半径(メートル単位)による距離指定、
filters.itemsによって結果を絞り込めます。 - lookup_locations:
gid://shopify/Location/123のようなIDでロケーションを返します。最初の重複しない10件のIDを処理します。それ以上送信した場合、レスポンスにbatch_limit_appliedメッセージが含まれ、残りは別のリクエストで送信できます。
各ロケーションには、ID・名称・住所、および加盟店が設定していればジオ座標が含まれます。検索結果はデフォルトで10件返され、pagination.limitを設定することで最大250件まで取得できます。次のページを取得するには、レスポンスに含まれるpagination.cursorを渡します。
filters.itemsには最大10件の商品バリエーションIDを指定できます。すべてのバリエーションがそのロケーションで利用可能な場合にのみ、そのロケーションは一致したとみなされます。在庫状況の判定はShopify既存の店舗在庫ルールに従うもので、在庫数そのもの、店頭受け取りの確約、または予約を意味するものではありません。
Shopifyは、hoursおよびamenitiesフィルター、カスタムフィルター、serves relationには対応していません。これらを含むリクエストは無視されるのではなく、invalid_inputエラーを返します。選択したロケーションでの店頭受け取り(Pickup)チェックアウトはサポートされていません。
設定方法
エージェントプロファイルで、dev.ucp.common.location.searchとdev.ucp.common.location.lookupをバージョン2026-08-25として宣言します。ロケーションツールは、ショップのプロファイルにそれらが掲載されている場合にのみ呼び出してください。
distance.centerは、購入者が共有することを選んだ場所からのみ送信してください。Shopifyは文脈やIPアドレスから中心点を推測することはありません。
商品の一致結果は暫定的なものとして扱い、購入者に商品が用意できると伝える前に、カートおよびチェックアウトで在庫状況と配送・受け取りオプションを確認してください。
関連ドキュメント
- エージェントプロファイルとUCPネゴシエーションの設定
- UCPロケーション仕様のレビュー