mcpField
B
b2c-scapi-shopper

b2c-scapi-shopper

github.com/salesforcecommercecloud开发57131 次安装今天更新
代码仓库

关于 b2c-scapi-shopper

面向开发者的技能，用于通过 SCAPI 实现 Salesforce B2C Commerce 店面流程，涵盖商品、购物篮、结账、客户和购物者上下文。内容强调合约发现、SLAS 身份验证，以及通过应用的 Shopper SDK 或客户端执行请求。

主要功能

  1. 01发现 Shopper API 合约
  2. 02指导 SLAS 购物者身份验证
  3. 03支持购物篮与结账流程
  4. 04检查架构和自定义属性

适用场景

  1. 01规划店面 API 集成
  2. 02实现购物者登录与令牌流程
  3. 03构建从购物篮到订单的结账流程
  4. 04检查租户架构与 API 版本

MCP 相关

提供 B2C MCP 可用时的指引，包括读取其说明并使用 `scapi_search`、`scapi_schemas_list` 等工具发现合约。`scapi_execute` 不支持购物者请求；流程需通过应用的 Shopper SDK 或客户端执行。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/salesforcecommercecloud/b2c-developer-tooling --skill b2c-scapi-shopper

安装后在 Claude Code 中输入/b2c-scapi-shopper确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
trigger-evals.json
references/
CHECKOUT-FLOW.md
CLIENT-EXAMPLES.md
COMMON-PATTERNS.md
SCOPES.md

详细介绍

Shopper Commerce APIs

使用 SCAPI 构建店面商品、购物篮、结账、客户和上下文工作流。 后端管理请使用 b2c-scapi-admin 技能。

工具选择

当 B2C MCP 可用时：

  • 在使用代码模式工具之前，通过资源或 skills_read 读取一次 skill://mcp/b2c-mcp-scapi/SKILL.md，并传入 skillRead: true。
  • 使用 scapi_search 和 authType: "shopper" 可离线发现捆绑的契约。 先查找方法、路径和 operationId，再查看所选输入、响应字段和 安全机制。混合 Admin/Shopper 操作可能出现在任一筛选结果中。
  • scapi_execute 不支持 Shopper 执行；添加 SLAS 客户端也无法启用该功能。请通过应用的 Shopper SDK/客户端，并使用适当的 SLAS 令牌流程执行店面工作流。若有专用工具，请优先使用。
  • 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 钩子（“无头订单支付”），以及 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。

评论

支持 Markdown