woo-catalog-perfection

Woo Catalog Perfection

説明

「カタログのスコアは43です」から「カタログのスコアは90以上です」まで、商品ごとに改善します。すべての変更はスナップショットとして保存されます。

AI ショッピングの画面では、画像、説明、ブランド、識別子が不足している商品行は拒否され、内容の薄い商品は最下位に表示されます。このスキルは、Respira の準備状況修正リストを作業キューとして実行します。カタログを採点し、不合格の商品を、各不足を解消する正確なツールとともに順番に取得して、安全なバッチ単位で修正し、目標に達するまで再採点します。埋め草ではなく、実際に役立つ内容を作成します。説明文は商品自身の属性、カテゴリー、既存のコピーをもとに作成し、不確かな情報は創作せず、販売者に確認する項目としてキューに追加します。

Respira WooCommerce Add-on v3.1+ が必要です。

---

トリガーフレーズ

ユーザーが次のいずれかを言った場合、このスキルが起動します。

• 「AI 向けにカタログを修正して」
• 「AI 対応スコアを上げて」
• 「フィードのチェックに不合格の商品の問題を直して」
• 「商品が Google に何度も拒否される」
• 「カタログを完璧にして」
• 「不足している GTIN を修正して」／「不足しているブランドを修正して」／「商品説明を修正して」
• 「カタログのスコアを90にして」
• 「商品データを整理して」
• 「WooCommerce のフィードで不承認になった商品」

次の場合は起動しないでください： フィードの設定やプラットフォームへの登録（これは woo-agent-storefront の担当です）、価格の変更、カタログ以外のコンテンツ作業。

---

実行ワークフロー

ステップ1：採点して対象範囲を決める

respira_get_site_context を実行し、続いてベースラインスコアの取得に woocommerce_catalog_ai_readiness、作業キューの取得に woocommerce_readiness_fixlist を実行します。現在のスコア、各チェックに不合格となった商品の数、合格が見込まれる商品の数を報告します。目標（デフォルトは90）とバッチサイズ（デフォルトは1回あたり10商品。各バッチを確認できるサイズです）について合意します。

ステップ2：優先順位に従って修正する

修正リストでは、影響の大きさに基づいて作業が並んでいます。商品ごとに、修正リストに対応づけられた項目だけを、指定されたツールを使って修正します。

1. GTIN の不足 → ユーザーが正規の GTIN を提供できる場合は、global_unique_id を指定して woocommerce_update_product を実行します（ユーザーに確認してください。GTIN を捏造してはいけません。GTIN がない場合は、ブランドと SKU を割り当て、ブランド＋MPN で識別子のルールを満たします）。
2. ブランドの不足 → woocommerce_create_brand ／ woocommerce_update_product でブランドを割り当てます。商品名からブランドを特定するか、ショップのブランドを一度だけ確認し、一貫して適用します。
3. 説明文の不足または内容の薄さ → woocommerce_update_product を実行します。商品の属性、カテゴリー、既存の短い説明文をもとに40〜80語で作成します。仕様を創作せず、誇張表現も使いません。
4. 画像の代替テキストの不足 → woocommerce_set_image_alt を実行します。説明的な内容とし、125文字未満にします。
5. ギャラリーの不足 → 既存のメディア（respira_list_media）だけを使い、gallery_image_ids を指定して woocommerce_update_product を実行します。外部画像への直リンクは使用しません。
6. カテゴリーの未マッピング → 最も近い Google 分類ノードに woocommerce_set_feed_category_mapping を設定します。

書き込みは一度に10件ずつ行います。書き込みのたびにアドオンが自動でスナップショットを作成します。レポートでは、スナップショットの対象範囲を明記します。

ステップ3：再採点して繰り返す

各バッチの後に woocommerce_validate_feed（google）を実行して、スコアの変化を確認します。目標に達する、修正リストが空になる、または残りの項目に販売者からの入力（正規の GTIN、商品写真）が必要になるまで続けます。不確かなまま推測せず、必要な項目を明示してキューに追加します。

ステップ4：報告する

最後に、修正前から修正後へのスコア、チェックの種類ごとに修正した商品の数、書き込んだ内容（スナップショットに関する注記：「すべての変更は90日間取り消し可能です」）、販売者の入力が必要な項目（不足している写真、入手が必要な GTIN）を報告します。フィードが有効になっている場合は、数分以内に自動で再構築され、次回プラットフォームがデータを取得した際に修正内容が Google／ChatGPT に反映されることを伝えます。

---

安全性

• ドライランに対応している一括操作では、まずドライランを実行し、適用前にプレビューを表示します。
• GTIN、仕様、素材、寸法、認証を決して捏造しません。不確かな場合は、質問するか保留キューに追加します。
• 10件ずつ処理し、各バッチの間に再スコアリングを行います。これにより、不適切なパターンを500件ではなく10件の時点で検出できます。
• すべての書き込みはアドオンのスナップショットエンベロープを経由します。最終レポートではロールバックについても言及します。