woo-agent-storefront

Woo Agent Storefront

説明

WooCommerce ストアをエージェント対応のストアフロントに変えます。常に最新の商品フィード、ストアの llms.txt、プログラムへの登録、成果が追跡可能なカートリンクを提供します。

AI アシスタントは何百万人もの買い物客に商品をおすすめしますが、読み取れる商品しか販売できません。このスキルでは、必要な手順をすべて案内します。各プラットフォームが実際に取り込む形式（Google Shopping XML、OpenAI/ChatGPT JSONL、Meta CSV、Pinterest CSV、TikTok CSV、汎用 CSV）でフィードを設定して生成し、登録前に各仕様に照らして検証し、サイトのルートにストアの llms.txt を提供し、各プラットフォームへの登録（制限付きのものも含む）を案内します。最後に、エージェントの流入元に注文を紐付ける署名付きカートリンクを作成します。

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

---

トリガーフレーズ

ユーザーが次のいずれかを発言すると、このスキルが起動します。

• 「ストアを ChatGPT から見つけられるようにして」
• 「商品フィードを設定して」
• 「WooCommerce の Google Shopping フィード」
• 「ストアでエージェントコマースを始めたい」
• 「ストアをエージェント対応にして」
• 「AI アシスタント経由で販売したい」
• 「OpenAI 商品フィード」
• 「Google Merchant Center に商品を登録して」
• 「ストア用の llms.txt」
• 「TikTok カタログフィード」／「Pinterest カタログフィード」／「Meta 商品フィード」
• 「AI エージェント用のカートリンク」
• 「エージェント対応のストアフロント」

次の場合は起動しないでください： 商品カタログの修正のみで、発見やフィードに関する文脈がない場合（その場合は woo-catalog-perfection を使用します）、一般的な SEO の依頼、WooCommerce を使っていないストア。

---

実行ワークフロー

ステップ 1：環境を確認する

respira_get_site_context を呼び出して接続を確認し、続けて woocommerce_get_feed_status を呼び出します。フィードツールが見つからない場合、ストアで 3.1 より古いアドオンが使われています。処理を中止し、まず Respira WooCommerce Add-on を更新するようユーザーに伝えてください。

ステップ 2：カタログの基準値を確認する

google に対して woocommerce_validate_feed を実行します（最も厳しい仕様です）。スコアと不合格のチェック項目を平易な言葉で報告します。スコアが 70 未満の場合は、先に woo-catalog-perfection スキルを実行することを勧め、続行も可能であると伝えてください。プラットフォームが却下するのはフィード全体ではなく個々の行です。

ステップ 3：設定する

重要な配信先を尋ねます（デフォルト：Google ＋ OpenAI ＋ 汎用 CSV。Meta、Pinterest、TikTok も選択肢として提示します）。次に、以下を指定して woocommerce_configure_feed を実行します。

• 回答に応じた enabled_formats
• サイトでまだ提供していない場合は llms_txt: true
• cadence：ほとんどのストアでは daily、価格や在庫が頻繁に変わるストアでは hourly（注：OpenAI は頻繁な更新を推奨しています。これには wp-cron ではなく、実際のサーバー cron が必要です）
• include_out_of_stock：デフォルトの true を維持します（プラットフォームは、消えてしまう行より、在庫切れと明記された行を優先します）

ストアの最上位の商品カテゴリーを Google の分類体系に対応付けるには、woocommerce_set_feed_category_mapping を使用します。このツールは未対応の用語を一覧表示するので、まず主要なカテゴリーを対応付けてください。

ステップ 4：生成して確認する

woocommerce_generate_feed を実行し、続けて woocommerce_get_feed_status を呼び出して、有効にしたすべての形式で行数と最新のタイムスタンプが報告されるまで確認します。各公開 URL に一度アクセスし、コンテンツが返されることを確認します（まず見やすい URL を試し、ホストが不明なパスを遮断する場合は /wp-json の代替 URL を試します）。サイトのルートにある /llms.txt が解決されることを確認します。ステータスに cron_warning があれば、内容をそのまま提示し、修正方法（wp-cron.php にアクセスする実際の cron を設定する）も伝えてください。

ステップ 5：各プラットフォームに登録する

各プラットフォーム用の正確なフィード URL をユーザーに渡し、簡単な登録手順を案内します。

• Google Merchant Center：商品 → データソース → 商品ソースを追加 → google.xml の URL を使って定期取得を設定します。Bing Merchant Center でも同じファイルを使用できます。
• OpenAI / ChatGPT：chatgpt.com/merchants で商品検索への申し込みを行います。openai.jsonl の URL が取り込み対象のフィードです。Instant Checkout は加盟店ごとの承認制ですが、商品検索は誰でも利用できる窓口です。
• Meta Commerce Manager：カタログ → データソース → データフィード → meta.csv の URL を使って定期取得を設定します。
• Pinterest：ビジネスハブ → カタログ → pinterest.csv の URL を使ってデータソースを追加します。
• TikTok：Seller Center → 商品 → tiktok.csv を使ってカタログをアップロードします。TikTok では商品ごとにブランドが必要です。フィードではブランドが未設定の場合、ストア名が代わりに使用されますが、実際のブランド名のほうが照合精度は高くなります。

加盟店が後から自分で完了できるチェックリストとして案内してください。これらのダッシュボードには MCP 経由でアクセスできません。

ステップ 6：AI クローラーのアクセス

woocommerce_catalog_ai_readiness を実行し、robots／AI クローラーのセクションを確認します。robots.txt で GPTBot、OAI-SearchBot、Google-Extended、PerplexityBot がブロックされている場合は、どの行がどのアシスタントをブロックしているのか、またその行を削除するとどうなるのかをユーザーに正確に伝えます。明示的な承認なしに robots.txt を編集しないでください。

ステップ 7：アトリビューション付きカートリンク

最初から最後までの流れを実演します。woocommerce_create_cart_link を使い、実在する商品を 2 つ、chatgpt などのソースラベルとともに指定してカートリンクを 1 つ作成します。リンクによってサーバー側でカートに商品が追加され、ストア独自のチェックアウトに移動することを説明し、数値の確認先として woocommerce_agent_orders_report を示します。チェックアウト、決済、顧客データはストア内に保持されます。

ステップ 8：レポート

有効にした形式とその URL、カタログスコア、マッピング済み／未マッピングのカテゴリー、llms.txt のステータス、プラットフォームごとの登録チェックリスト（完了済みと保留中の項目）、およびカートリンクの例を提示して締めくくります。

---

安全性

• フィードの生成ではカタログを読み取り専用で扱います。書き込みが行われるのは、この機能独自のオプション行とフィードファイルのみです。
• このスキルでは、ユーザーの明示的な承認なしに robots.txt、価格、商品を編集しないでください。コンテンツの修正には woo-catalog-perfection を使用します。
• フィード URL には推測困難なトークンが含まれています。機能を実行できる URL として扱い、プラットフォームとの共有にのみ使用してください。公開投稿には掲載しないでください。