本文へ移動
SKU.md
メニュー
日本語

一商品から始める：Shopify・SHOPLINE・WooCommerce・BigCommerce の SKU.md 導入ガイド

v1.0.0 特集

各プラットフォームの公開条件を比べ、一商品の知識を生成、確認、公開検証する小さな試行を始めましょう。

公開日

執筆 SKU.md Editorial Team

現在の仕様バージョン: v1.0.0

ショッピングエージェントに備えるために、店舗全体を作り直す必要はありません。Shopify、SHOPLINE、WooCommerce、BigCommerce の販売者は、一つの商品で正確な資料を整理し、ファイルの配信方法を確認してから範囲を広げられます。

SKU.md v1.0.0 は商品ページ、構造化データ、チャネル Feed を補うオープンな表現です。在庫、決済、注文は既存システムが担当します。本稿は導入経路の検討であり、四つのプラットフォームが標準対応しているという宣言ではありません。

まず配信できるものを確かめる

内容の正確さとオンライン配信の正しさは別の作業です。運営担当は仕様、バリエーション、制限、出典を整理し、技術担当やサービス事業者は店舗ドメイン上の実際の応答を確認します。

公式資料を基にした下表も、個別店舗での認証ではありません。ホスティング、権限、応答テストで判断してください。

プラットフォーム 管理できる部分 確認する前提 検証点
Shopify テーマ内容、構成に応じた自主管理店面のルート App Proxy の接頭辞には制限があり、ルート直下の制御とは別 実 URL がテーマ HTML ではなく Markdown を返すか
SHOPLINE 商品内容と許可された転送設定 転送機能だけで適合とは言えず、同一オリジン配信を確認 転送先、本文、転送経路
WooCommerce 権限に応じた WordPress ルートや静的ファイル 書き換え規則だけでなく正しい応答の実装が必要 状態、内容タイプ、キャッシュ、本文
BigCommerce Stencil テンプレートや自主管理店面のルート ページテンプレートはルート Markdown 配信の証明にならない HTML ページとファイル応答の区別

これは機能から導いた実装上の判断です。適切な配信経路がなければ、まず商品資料を整え、担当事業者に評価を依頼します。一ファイルだけのために基盤を乗り換える必要はありません。

現行仕様の発見方法

同じサイトの正確な /sku.md を優先します。その URL が明確な HTTP 404 を返した場合に限り、同一オリジンのホームページにある曖昧さのない宣言を確認できます。

<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">

宣言先も同一オリジンの HTTPS で、クエリーやフラグメントを含まないなど、仕様に従う必要があります。タイムアウト、サーバーエラー、不正な文書は「存在しない」とは異なります。

これは条件付きの経路であり、すべてのテーマで使える方法ではありません。宣言とファイルの両方を制御し、検証します。CDN のダウンロード、HTML 紹介ページ、別オリジンへの転送だけで適合とは判断できません。

最小のカタログを用意する

次は架空店舗のルート例です。店舗名、概要、ドメイン、カタログ URL を実際の情報に置き換えます。これだけで商品属性全体を説明したことにはなりません。

# Example Outdoor Gear
> Lightweight outdoor equipment for hikers.

SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)
Website: [example-outdoor.com](https://www.example-outdoor.com/)

## Catalog
- [All products](https://www.example-outdoor.com/collections/all)

商品知識文書は任意です。追加する際はルートから明示的にリンクし、商品文書にはカタログへの戻りリンク、商品ページ、各事実の出典を含めます。商品全体か特定バリエーションかも明記してください。

五つの手順で試す

  1. 商品を選ぶ。 公開資料が充実し、仕様の質問が多い商品を選びます。全店の巡回は不要です。
  2. 事実を確認する。 識別情報、仕様、制限、根拠を実際のページと照合し、不明な点を推測で埋めません。
  3. 生成して確認する。 生成ツールでルートを用意し、詳細な属性確認には商品最適化ツールを使います。
  4. 公開して検証する。 店舗担当が配信し、公開 URL チェッカーで実 URL を確認します。商品文書とカタログの関係は別途検証します。
  5. 保守を決める。 責任者と確認記録を決め、仕様、バリエーション、出典の変更時に更新・再検証します。

公開 HTTPS、HTTP 200、UTF-8 の Markdown 本文、許可された内容タイプ text/markdown または text/plain を確認します。安全な転送、カタログ関係、出典も対象です。ブラウザーに文字が見えるだけでは十分ではありません。

拡大の前に見ること

アクセス可能か、事実に出典があるか、バリエーションの範囲が正しいか、リアルタイムシステムに何を任せるかを確認します。生成ファイル数より、これらを先に判断しましょう。

SKU.md は管理画面へのログイン、自動公開、外部ショッピングチャネルへの自動送信を行いません。公開内容は販売者が決め、Agent による利用は別途検証します。価格、在庫、配送の約束はリアルタイムシステムで扱います。

クイックスタートを開き、確認済みの一商品分の知識を店舗の技術担当に渡すところから始めてください。

公式資料

← すべての記事