marketplace-add-xmc

Adiciona integração com a API do XM Cloud a um aplicativo do Sitecore Marketplace. Use quando o usuário quiser acessar as APIs de Sites, Páginas, Criação, Transferência de Conteúdo, Pesquisa ou Agente…

Add XM Cloud API Integration

You are helping the user add XM Cloud API integration to their Sitecore Marketplace app.

Prerequisites

The XMC package must be installed. If not:

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

Step 1: Determine Which API

Ask the user (or infer from $ARGUMENTS) which XMC API they need:

API	Namespace	Use For
Sites	`xmc.sites.*`	List/get sites, current site context
Pages	`xmc.pages.*`	List/get pages, current page context
Authoring	`xmc.authoring.*`	GraphQL queries/mutations against authoring API
Content Transfer	`xmc.contentTransfer.*`	Import/export content
Search	`xmc.search.*`	Search content items
Agent	`xmc.agent.*`	Invoke XM Cloud agents

Step 2: Choose Client-Side or Server-Side

Client-side: Use client.query() / client.mutate() — simpler, works in any architecture
Server-side: Use experimental_createXMCClient() — requires Auth0 (full-stack architecture)

Step 3: Implement

See xmc-patterns.md for complete code patterns for each API.

Step 4: Suggest Related Skills

Use /marketplace-build-component to build UI for the data
Use /marketplace-sdk-reference for detailed type information

Reference Files

XMC Patterns — Code patterns for each XMC API