La CLI

La CLI te dice en un comando si tu clave anda, qué devuelve un ítem o por qué no ves recomendaciones. Es para diagnosticar: para integrar están el Storefront SDK y la API.

Los comandos

crossup catalog get --item <id> [--json]
crossup recommendations get --connection <id> --item <id> --placement <key> --surface <surface> [--json]
crossup demo

--json imprime una sola línea lista para jq. Los errores van a stderr en los dos modos.

Configurar

Lee las mismas dos variables que el MCP, y nada más:

export CROSSUP_API_TOKEN="spk_…"
export CROSSUP_BASE_URL="https://salespilot.crossup.ai"

Hoy la CLI se corre desde el repositorio, con bun: bun run apps/cli/src/index.ts …. Un paquete instalable es un paso pendiente.

Qué vas a ver

crossup catalog get --item itm_demo_remera --json | jq '.item.title, .availability[0].sellable'

{ "es": "Remera Demo" }
"in_stock"

crossup recommendations get --connection cn_… --item itm_demo_remera \
  --placement pdp-related-products --surface pdp --json | jq '.decision_id, (.results | length), .reason_codes'

Si no lo ves

Lo que pasa	Qué hacer
`configuration_error`	Falta `CROSSUP_API_TOKEN`, o está vacía. La CLI lo distingue de un `401`
`401`	La clave está revocada o mal copiada
`404` en un ítem que existe	Es de otra tienda: la clave es de otra conexión
`results: []`	Mirá `reason_codes`: Pedir una recomendación

Qué sigue

crossup doctor, que prueba clave, conectividad, cuota y un pedido en un comando, y crossup signals tail, para ver las señales mientras probás. Van a llegar también al MCP.

El MCP

Las mismas dos lecturas, para un agente.

Tu primera recomendación

El camino de integración, para una tienda.

​Los comandos

​Configurar

​Qué vas a ver

​Si no lo ves

​Qué sigue

El MCP

Tu primera recomendación

Los comandos

Configurar

Qué vas a ver

Si no lo ves

Qué sigue