Pergunte à sua loja como ela está vendendo direto no Claude, integre recomendações com um SDK que nunca quebra a sua página e meça cada venda com a API. Tudo documentado para pessoas e para agentes, em português, espanhol e inglês.
Sua loja, no Claude
claude mcp add --transport http salespilot https://salespilot.crossup.ai/mcp/merchantsRecomendações na sua loja
npm install @crossup/storefrontA documentação, para o seu agente
https://docs.crossup.ai/llms.txtSalesPilot no Claude
O SalesPilot é o conector da CrossUp para o Claude: você pergunta à sua loja como ela vai e ela responde com os seus números. Ele é adicionado com uma URL, autorizado com a sua sessão da CrossUp, e não há nenhuma chave para copiar.
https://salespilot.crossup.ai/mcp/merchantsclaude mcp add --transport http salespilot https://salespilot.crossup.ai/mcp/merchantsDepois escreva /mcp, escolha salespilot e toque em Authenticate.
O Cursor e os clientes que não fazem OAuth usam uma chave de agente (sak_…) no header Authorization.
Storefront SDK
Para lojas VTEX, próprias ou headless: o @crossup/storefront pede recomendações, acompanha o visitante e envia os sinais em lotes. Se a CrossUp não responder, a sua loja continua vendendo.
Servidor ou conector? O @crossup/sdk é o cliente da API, gerado a partir do contrato OpenAPI.
Instale
npm install @crossup/storefrontPeça e avise
import { createStorefront } from "@crossup/storefront";
const crossup = createStorefront({
apiKey: "spk_…", // a sua chave pública de storefront
connectionId: "cn_…", // a conexão da sua loja
});
const decision = await crossup.tryGetRecommendations({
surface: "pdp",
placementKey: "pdp-related",
contextItemId: item.id,
});
// null se algo falhou: a sua página continua igual
if (decision) crossup.track.impression(decision); // o bloco foi visto
API v1
Peça uma recomendação e registre o que o comprador fez com ela. Com as duas, cada venda fica atribuída, pedido a pedido.
| Método | Rota | Para quê |
|---|---|---|
| POST | /v1/recommendations | Peça o que recomendar em um momento da compra. |
| POST | /v1/connections/{connection_id}/storefront-signals | Registre o que o comprador fez, até 50 sinais por lote. |
| GET | /v1/catalog/items/{item_id} | Leia um produto do catálogo, com variantes e disponibilidade. |
| POST | /v1/connections/{connection_id}/ingest-signals | Para conectores: envie os eventos de catálogo da sua plataforma. |
Sua primeira recomendação
curl -X POST "$CROSSUP_BASE_URL/v1/recommendations" \
-H "Authorization: Bearer $CROSSUP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connection_id": "cn_…",
"surface": "pdp",
"placement_key": "pdp-related",
"context_item_id": "itm_…"
}'
A URL base está na referência da API; a chave e o connection_id você gera no seu painel.
pdpcartcarouselin-checkoutsuccess-pageÉ uma agência? A mesma integração em cada loja, com uma chave por loja. Conheça o programa para agências
Para o seu agente
Entregue ao Claude, ao Cursor ou ao Codex a sua chave de storefront e a documentação: ele verifica a chave, escreve o snippet e testa uma recomendação e um sinal. É seguro: a chave de storefront é pública e limitada.
docs.crossup.ai/llms.txt.claude/skills/crossup/SKILL.mddecision_id · signal_idIntegre a CrossUp na página de produto desta loja. Chave de storefront: spk_… · connection_id: cn_… · Documentação: https://docs.crossup.ai/llms.txt. Quando terminar, me mostre o decision_id de uma decisão de teste e o signal_id aceito.
Guias, referência da API com playground e novidades, escritos para pessoas e para agentes. Em português, espanhol e inglês.