mcpField
M
marketplace-add-xmc

marketplace-add-xmc

github.com/vercel-labs开发557 次安装30 周前更新
代码仓库

关于 marketplace-add-xmc

用于为 Sitecore Marketplace 应用添加 XM Cloud API 集成的技能,帮助开发者选择所需 API,并确定客户端或服务端实现方式。

主要功能

  1. 01选择 XM Cloud API
  2. 02选择客户端或服务端访问
  3. 03查阅 API 实现模式
  4. 04推荐相关 Marketplace 技能

适用场景

  1. 01添加站点或页面数据访问
  2. 02实现 Authoring API 查询
  3. 03导入或导出内容
  4. 04调用 XM Cloud Agent

安装

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

$npx skills add https://github.com/vercel-labs/sitecore-skills --skill marketplace-add-xmc

安装后在 Claude Code 中输入/marketplace-add-xmc确认已加载。

附带文件references/xmc-patterns.md

详细介绍

添加 XM Cloud API 集成

帮助用户为其 Sitecore Marketplace 应用添加 XM Cloud API 集成。

前提条件

必须安装 XMC 包。如果尚未安装:

npx shadcn@latest add https://marketplace-sdk.sitecorecloud.io/r/xmc.json

步骤 1:确定使用哪个 API

询问用户(或根据 $ARGUMENTS 推断)需要使用哪个 XMC API:

API命名空间用途
Sitesxmc.sites.*列出/获取站点、当前站点上下文
Pagesxmc.pages.*列出/获取页面、当前页面上下文
Authoringxmc.authoring.*针对 authoring API 执行 GraphQL 查询/变更
Content Transferxmc.contentTransfer.*导入/导出内容
Searchxmc.search.*搜索内容项
Agentxmc.agent.*调用 XM Cloud Agent

步骤 2:选择客户端或服务端

  • 客户端:使用 client.query() / client.mutate() — 更简单,适用于任何架构
  • 服务端:使用 experimental_createXMCClient() — 需要 Auth0(全栈架构)

步骤 3:实现

有关各 API 的完整代码模式,请参阅 xmc-patterns.md。

步骤 4:建议相关技能

  • 使用 /marketplace-build-component 为这些数据构建 UI
  • 使用 /marketplace-sdk-reference 查看详细的类型信息

参考文件

评论

支持 Markdown