ce

LLM Docs ヘッダー：https://llm-docs.commercengine.io へのすべてのリクエストには、Accept: text/markdown ヘッダーを必ず含める必要があります（または URL パスに .md を追加してください）。これがない場合、解析可能な Markdown ではなく HTML が返されます。

Commerce Engine Skills Router

これらのスキルは B2C ストアフロントを対象としています。B2B ストアフロントでは、同じ SDK パターンに加えて、顧客グループを考慮した価格設定とヘッダーを使用します。

現在の SDK のメンタルモデル

すべてのフレームワークで @commercengine/storefront をインストールします。これは、フレームワークごとのサブパスエクスポートを備えた統合パッケージです。

• SPA（@commercengine/storefront）：createStorefront(...) → storefront.public() / storefront.session()
• Next.js（@commercengine/storefront/nextjs）：createNextjsStorefront(...) → storefront.publicStorefront() / storefront.clientStorefront() / await storefront.serverStorefront()
• TanStack Start（@commercengine/storefront/tanstack-start）：createTanStackStartStorefront(...) → storefront.publicStorefront() / storefront.clientStorefront() ＋ serverStorefront() 用のサーバーエントリ

基本原則：公開読み取りには公開アクセサー（API キーに基づき、ビルド時に安全）を使用します。ライブセッションフロー（認証、カート、注文）には、セッション／クライアント／サーバーアクセサーを使用します。

タスク別

SDK のセットアップ -> ce-setup

• フレームワークの検出と SDK のインストール
• セッションストレージの選択
• 環境変数と単一設定でのセットアップ

認証とログイン -> ce-auth

• 匿名セッションの初期化
• OTP ログイン、パスワードログイン、パスワード登録、パスワードリセット
• アカウント／プロフィールのフロー

商品とカタログ -> ce-catalog

• 商品、カテゴリ、バリアント、検索
• レビューとレコメンデーション

カートとチェックアウト -> ce-cart-checkout

• ホステッドチェックアウト（推奨）
• カスタムチェックアウト（上級者向け）
• カートの CRUD、クーポン、ロイヤルティポイント、決済

注文と返品 -> ce-orders

• 注文の作成、注文履歴、配送、決済
• キャンセルと返品

Webhook とイベント -> ce-webhooks

• イベント処理、署名検証、非同期処理

Next.js / TanStack Start / Astro / SvelteKit のパターン -> ce-ssr-patterns

• publicStorefront() / clientStorefront() / serverStorefront()
• 初期化、Server Actions／関数、事前レンダリング、トークン管理
• Next.js、TanStack Start、Astro、SvelteKit の具体的なリファレンス

SEO と構造化データ -> ce-seo

• head メタデータ、JSON-LD（variesBy を含む Product／ProductGroup）、canonical URL
• robots.txt、サイトマップ、llms.txt、AI クローラー向け Markdown ミラー
• デプロイモードごとのサーバーマウントと事前ビルド

AI エージェントツール（WebMCP） -> ce-ai

• document.modelContext を介したカタログ、カート、ナビゲーション、セッションのツール
• 機能のゲーティング、カートのセマンティクス、エージェント境界の位置

カスタム SSR バインディング -> ce-ssr

• ファーストパーティのラッパーがないフレームワーク（Nuxt など）向けの @commercengine/ssr-utils
• ServerTokenStorage と CookieAdapter
• 公開ビルド時の読み取りとライブリクエストのセッション

ストアフロントのページ

CE ストアフロントの標準ページと、それぞれに必要なスキル／メソッドは次のとおりです。

ページ	ルート例	スキル	主な SDK メソッド
ホーム	/	catalog	listProducts、listCategories、recommendations
商品一覧	/products、/categories/[slug]	catalog	searchProducts、listProducts
商品詳細	/products/[slug]	catalog	getProductDetail、listProductVariants、listProductReviews
カート	Hosted Checkout のドロワーまたは /cart	cart-checkout	useCheckout().openCart() または sdk.cart.*
チェックアウト	Hosted Checkout のドロワーまたは /checkout	cart-checkout	useCheckout().openCheckout() またはカスタムチェックアウトフロー
ログイン	/login	auth	loginWithEmail、loginWithPhone、verifyOtp、loginWithPassword
アカウント	/account	auth	getUserDetails、updateUserDetails、changePassword
注文	/account/orders	orders	listOrders
注文詳細	/account/orders/[id]	orders	getOrderDetails、listOrderShipments、listOrderPayments
SEO アセット	/robots.txt、/sitemap.xml、/llms.txt	seo	createCommerceSeo、マウント済みハンドラーまたは事前ビルド
Markdown ミラー	/product/[slug].md	seo	productMarkdown、標準 URL でのコンテンツネゴシエーション

既存のプロジェクトを移行する

1. SDK をインストールする - ce-setup に従ってください。@commercengine/storefront をインストールします。
2. 公開カタログの読み取りを最初に置き換える - 一覧／詳細／カテゴリページを publicStorefront() / public() に切り替えます。
3. セッション対応フローを追加する - 認証、カート、チェックアウト、アカウント、注文では clientStorefront() / serverStorefront() / session() を使用します。
4. Hosted Checkout またはカスタムチェックアウトを導入する - ce-cart-checkout に従ってください。
5. 必要に応じてフレームワーク固有の SSR 動作を追加する - ce-ssr-patterns（Next.js / TanStack Start / Astro / SvelteKit）または ce-ssr（Nuxt など向けのカスタムバインディング）。

データソースは一度に 1 つずつ置き換えてください。可能な限り既存の UI コンポーネントを維持し、まずデータレイヤーを切り替えます。

判断フローチャート

User Request
    │
    ├─ "Set up SDK" / "Add Commerce Engine"          → ce-setup
    ├─ "Login" / "Auth" / "OTP"                      → ce-auth
    ├─ "Products" / "Categories" / "Search"          → ce-catalog
    ├─ "Cart" / "Checkout" / "Payments"              → ce-cart-checkout
    ├─ "Orders" / "Returns" / "Shipments"            → ce-orders
    ├─ "Webhooks" / "Events" / "Sync"                → ce-webhooks
    ├─ "Next.js" / "Server Actions"                  → ce-ssr-patterns (references/nextjs.md)
    ├─ "TanStack Start" / "Server functions"         → ce-ssr-patterns (references/tanstack-start.md)
    ├─ "Astro" / "Astro SSR"                         → ce-ssr-patterns (references/astro.md)
    ├─ "SvelteKit" / "Svelte" / "Load functions"     → ce-ssr-patterns (references/sveltekit.md)
    ├─ "SSR" / "Cookies" / "Custom binding"          → ce-ssr
    ├─ "SEO" / "Sitemap" / "JSON-LD" / "llms.txt"    → ce-seo
    └─ "WebMCP" / "Agent tools" / "AI shopping"      → ce-ai

クイックナビゲーション

• /ce-setup
• /ce-auth
• /ce-catalog
• /ce-cart-checkout
• /ce-orders
• /ce-webhooks
• /ce-ssr-patterns
• /ce-ssr
• /ce-seo
• /ce-ai