WooCommerce と SKU.md：商品説明を出典のあるブランド知識にする

商品ページには仕様、ブログには手入れ方法、ダウンロード欄にはマニュアルがあります。手元の機器に交換部品が使えるか知りたい買い物客は、いくつもの場所を行き来するかもしれません。記事を一つ増やしても、情報同士の関係がわかりやすくなるとは限りません。

WooCommerce のストアでは、WordPress を使って商品にまつわる物語や使い方を豊富に公開できます。その柔軟さは、複数の編集者やプラグインを通じて資料が別々に蓄積されることにもつながります。すでにある知識をつなぎ直し、答えから公開された根拠へ戻れるようにする余地があります。

オープンな基盤で情報の関係を整える

WooCommerce は WordPress 上のオープンソースのコマースプラットフォームです。単一のホスト型 SaaS だけを指すものではありません。権限の範囲に応じてプラグインを導入し、内容の構造やホスティング環境を管理できます。選択肢がある一方で、誰がどの資料を担当するかも明確にしておきたいところです。

WooCommerce の AI による商品発見の記事は、商品データの品質を重視しています。ブランドの編集では、商品名、属性、バリエーションを正しく記載し、そのうえで用途や制限を補います。未整理の長文を別の場所へコピーすると、訂正する場所も増えてしまいます。

SKU.md はカタログの入口と任意の商品知識を公開する、独立した実験的提案 1.0.0-beta です。ブランドの資料整理に使えますが、WooCommerce に標準の SKU.md 連携機能があることや、AI プラットフォームが採用したことを意味しません。公開の仕組みを用意できても、内容の責任はストアに残ります。

繰り返し聞かれる質問を一つ選ぶ

サポートへの質問は、試す商品を選ぶ手がかりになります。「取り付けられるか」なら型番や接続部分、「水洗いできるか」なら当該商品の手入れ方法を調べます。一般的なブランド紹介で、個別の商品の条件を代用することはできません。

商品の同一性を確認してから、資料が裏付ける範囲を書きます。同じシリーズでも世代が違えば条件は変わります。商品ページが「全シリーズ対応」とし、マニュアルが二つの型しか挙げていなければ、まず商品担当者に確認し、公開ページを修正します。

実際の商品知識文書では、事実、互換性、制限の各項目に Source リンクが必要です。ブランドの公開ページでも、信頼できるメーカーの資料でも構いません。社内のチャットだけにある情報は、読者が確認できる公開知識の根拠としてそのまま使うことはできません。

カタログから始めて必要な商品文書を足す

現行仕様の最小カタログは、ブランド、サイト、商品一覧の関係を示します。最初から全商品を文書化する必要はありません。一商品の資料がそろったときに、Product knowledge から任意の文書をつなげます。

資料を確認する途中で、手入れ記事に対象型番がない、マニュアルの URL が古い、選択肢の属性と親商品の説明が違う、といった問題が見つかるかもしれません。通常の公開ページも直せば、サイトを訪れる顧客にとっても役立ち、知識文書が参照できる根拠も整います。

比較的変化の少ない仕様や使い方は SKU.md に向いています。価格、在庫、配送、税、決済、注文状況は WooCommerce の稼働中のシステムで扱います。Store APIは商品、カート、チェックアウト向けの JSON を返すもので、Markdown の商品知識を直接出力する機能ではありません。

小さく始めることで、商品が変わった際に誰が出典を確認し、誰が文書を直すかを試せます。その流れを一度経験してから対象を広げるほうが、維持に必要な仕事を判断しやすくなります。

WordPress のルートで公開する

プラグインやホスティングを管理できるチームなら、WordPress の Rewrite API と template_include を使って、/sku.md 専用の応答を用意できます。普通のページにはテーマの表示要素が付くため、Markdown だけを返す経路を担当者が確認します。

最小カタログを生成し、ルートを管理できる人を決め、公開してから公開 URL 検証ツールで実際の応答を調べます。商品文書を追加した場合は、出典とカタログの関係も確認します。直接 200 を返すことを勧めます。検査済みの安全なリダイレクトは最大 3 回まで認められますが、最終的なルートを任意のサブパスに置き換えることはできません。

サイト担当者向けの実装メモ

正確な /sku.md を照合し、query_vars に公開ルート識別用の変数を登録して、template_include で専用応答を選びます。変数には機密情報を入れず、他のリクエストは WordPress に戻します。ルールの更新はプラグインの有効化、無効化、またはルール変更時に行い、アクセスのたびに再生成しません。

text/markdown; charset=utf-8 など、適切な種類の純粋な Markdown を返します。サブディレクトリへのインストール、Multisite、キャッシュはサイトのオリジンごとに確認します。WordPress の設置場所が公開ドメインのルートとは限りません。更新後はキャッシュから新しい内容が返ることも確認してください。

WooCommerce のプラットフォームガイドを実装時の参考にできます。必要な権限や作業量は環境次第であり、プラグインを入れたことだけで公開 URL の動作が確認できるわけではありません。

日々の編集に更新責任を組み込む

対応型番が変わったとき、編集担当者が知識項目とその出典を見つけられる状態を目指します。既存の商品更新の流れを使い、公開ページの確認役と文書の担当を決めます。大量のファイルを先に生成するより、一商品の更新を最後まで試すことが役立ちます。

Google の AI 検索の説明では、特別な AI Markdown ファイルは Google の表示や順位にプラスにもマイナスにもならないとされています。通常のページと正確な内容、従来の SEO は引き続き重要で、SKU.md の存在だけではモデルが読むことを確認できません。

互換性の記載漏れを見つけたか、古いマニュアルへのリンクを直せたか、次の更新担当が決まったか。こうした結果から継続を判断できます。Shopifyと BigCommerceの視点も比較しながら、WooCommerce 用ジェネレーターでカタログの整理を始めてください。