关于 marketplace-add-xmc
用于为 Sitecore Marketplace 应用添加 XM Cloud API 集成的技能,帮助开发者选择所需 API,并确定客户端或服务端实现方式。
主要功能
- 01选择 XM Cloud API
- 02选择客户端或服务端访问
- 03查阅 API 实现模式
- 04推荐相关 Marketplace 技能
适用场景
- 01添加站点或页面数据访问
- 02实现 Authoring API 查询
- 03导入或导出内容
- 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 | 命名空间 | 用途 |
|---|---|---|
| Sites | xmc.sites.* | 列出/获取站点、当前站点上下文 |
| Pages | xmc.pages.* | 列出/获取页面、当前页面上下文 |
| Authoring | xmc.authoring.* | 针对 authoring API 执行 GraphQL 查询/变更 |
| Content Transfer | xmc.contentTransfer.* | 导入/导出内容 |
| Search | xmc.search.* | 搜索内容项 |
| Agent | xmc.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查看详细的类型信息
参考文件
- XMC Patterns — 各 XMC API 的代码模式
评论
支持 Markdown