Headless 移行は通常、性能・デザイン自由度・開発者体験で正当化され、コストは開発工数で数えられます。
2026 年 10 月 29 日、私たちは同じ 6 つのプローブを 2 つの実在ストアに対して実行しました。1 つは標準 Liquid テーマの著名 DTC ブランド、もう 1 つは今年 Hydrogen on Oxygen へ移行し独自ドメインを使うストアです。同じ日、同じコマンド、公開エンドポイントのみ。
8 項目のうち 4 項目が異なり、すべて同じ方向に振れていました。
要点
/agents.mdと/llms.txt：Liquid は 200、Headless ストアは 404。エージェント向け説明層がそもそも存在しませんでした。payment_handlers：一方は完全な Google Pay ハンドラ、もう一方は空オブジェクト。- エージェント用チェックアウト permalink が、自社ドメインではなく myshopify ドメインを指していました。
- トップページの WebMCP マーカー：Liquid 側は
modelContext×2、webmcp×3、Headless 側は 0。 - これは Headless への反対論ではありません。この 4 項目を含まない移行チェックリストへの反対論です。
比較の全容
プローブ | Liquid ストア | Hydrogen on Oxygen（独自ドメイン） | 影響 |
|---|---|---|---|
| 200、5,750 バイト | 404 | エージェントが利用説明を取得できない |
| 200、5,793 バイト | 404 | 同上（agents.md のミラー） |
| 200、5,906 バイト | 200、3,770 バイト | プロトコル層は両方あるが内容が異なる |
宣言された UCP サービス |
|
| 共通機能が丸ごと 1 系統欠落 |
| search + lookup あり | なし | 店舗がエージェントから発見されない（当該店は実店舗なし） |
| merchant_id とカードネットワークを含む完全な Google Pay ハンドラ |
| Google のエージェント経路に決済レールがない |
| 自社ドメイン | myshopify ドメイン | エージェントの直リンクがブランドドメインを離れる |
トップページ WebMCP |
| 0 | ブラウザ内エージェントが使える構造化ツールがない |
これは何ではないか
Hydrogen がエージェント可視性を壊す証拠ではありません。ドキュメントは明確です。WebMCP が登録されるのは Liquid ストアフロントと、ShopifyScripts を描画する（または initializeShopifyScripts を呼ぶ）Hydrogen 2026-10 のストアフロントです。古いバージョンのストア、あるいはその配線をしていないストアはマーカーが 0 になります——計測結果どおりです。
同様に、payment_handlers が空なのは、プラットフォームの不具合ではなく決済手段や市場設定が未完了である可能性が高いです。
そして、それこそが本当の発見です。Headless は「既定で備わっていたもの」を「意図的に有効化すべきもの」に変えます。 Liquid ではこの 4 つの面は無償で付いてきます。Headless ビルドではそれらは成果物であり——流通している移行受け入れ条件のほとんどに、この項目はありません。
すべての移行に追加すべき 4 つの確認
完了の定義に入れてください。10 分もかかりません。
curl -sI https://yourdomain/agents.md→ 200 を期待curl -sI https://yourdomain/llms.txt→ 200 を期待curl -s https://yourdomain/.well-known/ucp→ 200、capabilities 8 件以上、payment_handlersが空でない、permalinkが自社ドメインcurl -s --compressed https://yourdomain/ | grep -ci 'modelContext\|webmcp'→ 0 より大きいこと
4 つすべてが緑でなければ移行は完了していません。完全なコマンドと期待出力は10 分の自己診断にあります。
permalink の細部が見かけより重い理由
permalink エンドポイントが yourstore.com ではなく yourstore.myshopify.com を指すということは、エージェントが購入者に渡す直リンクが、購入の瞬間にブランドドメインを離れるということです。結果は 3 つ。購入者はファネル中で最も不安が高い地点で見慣れないドメインを見ます。ドメイン単位の計測・同意管理・パーソナライズが適用されません。そしてブランドドメインがそのシグナルを蓄積しなくなります。
これは設定の問題で、作り直しではありません。ただし、見なければ見つかりません。
これから移行を計画するなら
Hydrogen 2026-10 はここの採算構造を変えました。全面採用が必要なフレームワークではなく、既存の React / Next.js / Vue アプリに組み込めるフレームワーク非依存のライブラリになり、Oxygen・Vercel・任意のランタイムへデプロイできます。つまり「Headless にするか」を小さく分割して判断でき、各段階を出荷前に上記 4 項目で検証できます。
テーマ側の対応する変化は新しいテーマアーキテクチャにあります。人もエージェントもページを上から下へ読めることを明確な設計目標に掲げています。
よくある質問
既存の Headless ストアは Liquid に戻すべきですか。 ほぼ不要です。4 つのギャップのうち 3 つは設定です。Hydrogen を更新して ShopifyScripts を描画する、決済と市場設定を完了する、permalink を自社ドメインに向ける。プラットフォーム挙動に依存するのは /agents.md の欠落だけで、これは作り直しではなくサポートに確認する話です。
2 店舗で代表性はありますか。 統計的には皆無です。これは存在証明であり、この失敗が実在し、かつ検出が安価であることを示すものです。どれほど一般的かは示しません。自社ドメインでプローブを実行してください。あなたにとって意味のあるサンプルはそれだけです。
agents.md がないことで、今日実際に売上を失いますか。 多くのブランドにとって、今日の量は小さいです。それでも今直す理由は、修正が数分の設定で済む一方、発見が遅れればチャネルの規範が形成される時期に不在だったことになるからです。