Shopify、UCPに実店舗検索機能を追加しエージェントから在庫照会可能に

何が発表されたか

• Shopify ストアフロントの UCP に dev.ucp.common.location.search と dev.ucp.common.location.lookup の2機能を追加。UCP バージョン 2026-08-25 から利用可能。
• 実店舗を1つ以上持つストアだけが /.well-known/ucp のディスカバリプロファイルで両機能を広告する。要件は「有効・マーチャント管理・対面販売設定済み・Physical storefront 有効」のロケーション。
• エージェントは https://{storedomain}/api/ucp/mcp 経由で2つのツールを呼べる。
  • search_locations: 実店舗を一覧。query（店名・都市名でマッチ）、distance（明示的な center と max 半径メートル）、filters.items（最大10件の商品バリアントID。全バリアントが揃う店舗のみヒット）で絞り込める。デフォルト10件、pagination.limit で最大250件、pagination.cursor でページング。
  • lookup_locations: ロケーションIDから直接参照。先頭10件の重複なしIDを処理し、超過分は batch_limit_applied が返る。
• 返却されるのは id / name / address / geo（マーチャントが設定している場合）。
• 制約として hours・amenities フィルタ、カスタムフィルタ、serves リレーションは非対応（invalid_input エラー）。選択ロケーションでの受け取りチェックアウトも未対応。
• 要件として、distance.center は購買者が位置情報の共有を選んだ場合のみ送ること（ShopifyはIPや文脈から中心点を推定しない）、商品の一致は暫定扱いとしてカートとチェックアウトで再確認することが明記されている。

実務への影響

• エージェンティックコマースが「オンライン在庫」から「実店舗在庫」へ一歩踏み込んだ。実店舗を持つクライアントのShopify案件では、ロケーション情報の整備が集客施策そのものになる。
• 具体的には、各店舗の geo 座標と住所の整備、Physical storefront 設定の有効化、店舗名の表記統一（query は店名と都市名でマッチするため）が効く。ここを放置していると、エージェント経由の来店需要を取りこぼす。
• 在庫の一致は「取り扱いの有無」であって在庫数・取り置き・受け取り確約ではない。クライアントに「AIが在庫を保証してくれる」と誤解させないよう、説明の線引きが必要。
• 位置情報の中心点は購買者の明示的な共有が前提なので、プライバシー面の説明材料としても使える設計になっている。

利用条件

エージェントプロファイル側で両機能をバージョン 2026-08-25 で宣言する必要がある。機能はオプションで、ロケーションを使わない場合は変更不要。