b2c-scapi-shopper

Shopper Commerce API

SCAPI を使用して、ストアフロントの商品、バスケット、チェックアウト、顧客、コンテキストのフローを構築します。 バックエンドの管理には b2c-scapi-admin スキルを使用してください。

ツールの選択

B2C MCP を利用できる場合：

• コードモードのツールを使用する前に、リソースまたは skills_read を通じて skill://mcp/b2c-mcp-scapi/SKILL.md を一度読み込み、skillRead: true を指定してください。
• scapi_search で authType: "shopper" を指定すると、バンドルされたコントラクトをオフラインで検索できます。まずメソッド、パス、operationId を特定し、その後、選択した入力、レスポンスフィールド、セキュリティを確認してください。Admin と Shopper が混在する操作は、どちらのフィルターにも表示される場合があります。
• Shopper の実行は scapi_execute ではサポートされていません。SLAS クライアントを追加しても実行可能にはなりません。適切な SLAS トークンフローを使用し、アプリケーションの Shopper SDK／クライアントを通じてストアフロントのフローを実行してください。利用可能な場合は専用ツールを優先してください。
• scapi_schemas_list はライブテナントのコントラクトとカスタム属性を取得し、scapi_custom_apis_get_status はカスタム登録の状態を確認します。コードモードではカスタム API を実行できません。
• config_inspect は設定値をマスキングして報告します。docs_search／docs_read では、プラットフォームの仕様、認証、制限を確認できます。コントラクトを重複して読み込まないようにしてください。

CLI の代替手段：b2c scapi schemas list、 b2c scapi schemas get <family> <name> <version>、b2c setup inspect。 これらのスキーマコマンドは、ライブの Schemas API アクセスを使用します。MCP による検索はオフラインです。

統合の基本事項

• 設定済みの shortCode、organizationId、siteId を再利用し、識別子を推測して作成しないでください。
• Shopper の認証には SLAS のゲスト／登録済みフローとクライアントスコープを使用します。Account Manager の認証情報で代用することはできません。プライベートクライアントのシークレットとトークン交換はバックエンドで行ってください。
• 選択した API バージョンのコントラクトを確認してください。例は参考用です。バージョン固有の動作と制限は、公式ドキュメントで確認してください。
• バスケット／注文の状態を保持し、エラーを明示的に処理してください。レスポンスにはページネーションとフィルターを適用し、次の操作に必要なフィールドのみを返してください。
• ヘッドレス決済のオーソリでは、注文の配置フローを選択する前に、b2c-hooks スキルの order-PI フック（「Headless Order Payment」）と、b2c-ordering スキルの注文ライフサイクルを確認してください。

条件付きの参照資料

• クライアントの例：認証と API 呼び出しの実装。
• チェックアウト：バスケットから注文までのワークフロー。
• 一般的なパターン：エラー、ページネーション、フィールド選択。
• スコープ：ファミリー別の Shopper 権限。
• b2c-slas スキル：CLI クライアント管理。
• b2c-slas-auth-patterns スキル：OTP、パスキー、セッションブリッジ。
• 公式ドキュメント：commerce-api/use-shopper-api、commerce-api/slas、 commerce-api/work-with-baskets-orders、commerce-api/shopper-context-best-practices、 commerce-api/auth-z-scope-catalog、commerce-api/performance。