Preguntale a tu tienda cómo viene vendiendo desde Claude, integrá recomendaciones con un SDK que nunca corta tu página y medí cada venta con la API. Todo documentado para personas y para agentes, en español, inglés y portugués.
Tu tienda, en Claude
claude mcp add --transport http salespilot https://salespilot.crossup.ai/mcp/merchantsRecomendaciones en tu tienda
npm install @crossup/storefrontLa documentación, para tu agente
https://docs.crossup.ai/llms.txtSalesPilot en Claude
SalesPilot es el conector de CrossUp para Claude: le preguntás a tu tienda cómo le va y te contesta con tus números. Se agrega con una URL, se autoriza con tu sesión de CrossUp y no hay ninguna clave que copiar.
https://salespilot.crossup.ai/mcp/merchantsclaude mcp add --transport http salespilot https://salespilot.crossup.ai/mcp/merchantsDespués escribí /mcp, elegí salespilot y tocá Authenticate.
Cursor y los clientes que no hacen OAuth usan una clave de agente (sak_…) en el header Authorization.
Storefront SDK
Para tiendas VTEX, propias o headless: @crossup/storefront pide recomendaciones, lleva el visitante y manda las señales agrupadas. Si CrossUp no contesta, tu tienda sigue vendiendo.
¿Servidor o conector? @crossup/sdk es el cliente de la API, generado desde el contrato OpenAPI.
Instalá
npm install @crossup/storefrontPedí y avisá
import { createStorefront } from "@crossup/storefront";
const crossup = createStorefront({
apiKey: "spk_…", // tu clave pública de storefront
connectionId: "cn_…", // la conexión de tu tienda
});
const decision = await crossup.tryGetRecommendations({
surface: "pdp",
placementKey: "pdp-related",
contextItemId: item.id,
});
// null si algo falló: tu página sigue igual
if (decision) crossup.track.impression(decision); // el bloque se vio
API v1
Pedí una recomendación y registrá qué hizo el comprador con ella. Con las dos, cada venta queda atribuida, orden por orden.
| Método | Ruta | Para qué |
|---|---|---|
| POST | /v1/recommendations | Pedí qué recomendar en un momento de la compra. |
| POST | /v1/connections/{connection_id}/storefront-signals | Registrá lo que hizo el comprador, hasta 50 señales por lote. |
| GET | /v1/catalog/items/{item_id} | Leé un producto del catálogo, con variantes y disponibilidad. |
| POST | /v1/connections/{connection_id}/ingest-signals | Para conectores: mandá los eventos de catálogo de tu plataforma. |
Tu primera recomendación
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_…"
}'
La URL base está en la referencia de la API; la clave y el connection_id los generás en tu panel.
pdpcartcarouselin-checkoutsuccess-page¿Sos agencia? La misma integración en cada tienda, con una clave por tienda. Conocé el programa para agencias
Para tu agente
Pasale a Claude, Cursor o Codex tu clave de storefront y la documentación: verifica la clave, escribe el snippet y prueba una recomendación y una señal. Dársela es seguro: la clave de storefront es pública y acotada.
docs.crossup.ai/llms.txt.claude/skills/crossup/SKILL.mddecision_id · signal_idIntegrá CrossUp en la página de producto de esta tienda. Clave de storefront: spk_… · connection_id: cn_… · Documentación: https://docs.crossup.ai/llms.txt. Cuando termines, mostrame el decision_id de una decisión de prueba y el signal_id aceptado.
Guías, referencia de la API con playground y novedades, escritas para personas y para agentes. En español, inglés y portugués.