A CLI

A CLI diz em um comando se a sua chave funciona, o que um item devolve ou por que você não vê recomendações. É para diagnosticar: para integrar existem o Storefront SDK e a API.

Os comandos

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

--json imprime uma única linha pronta para o jq. Os erros vão para stderr nos dois modos.

Configurar

Lê duas variáveis, e nada mais:

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

Hoje a CLI é executada a partir do repositório, com bun: bun run apps/cli/src/index.ts …. Um pacote instalável é um passo pendente.

O que você vai ver

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

{ "pt": "Camiseta 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'

Se você não vê isso

O que acontece	O que fazer
`configuration_error`	Falta `CROSSUP_API_TOKEN`, ou está vazia. A CLI distingue isso de um `401`
`401`	A chave está revogada ou mal copiada
`404` em um item que existe	É de outra loja: a chave é de outra conexão
`results: []`	Olhe `reason_codes`: Pedir uma recomendação

O que vem depois

crossup doctor, que testa chave, conectividade, cota e uma requisição em um comando, e crossup signals tail, para ver os sinais enquanto você testa.

O MCP

Métricas e SalesPilot, a partir do Claude ou de outro agente.

Sua primeira recomendação

O caminho de integração, para uma loja.

SalesPilot no Claude

Agentes

A CLI

Os comandos

Configurar

O que você vai ver

Se você não vê isso

O que vem depois

O MCP

Sua primeira recomendação

​Os comandos

​Configurar

​O que você vai ver

​Se você não vê isso

​O que vem depois

O MCP

Sua primeira recomendação

Os comandos

Configurar

O que você vai ver

Se você não vê isso

O que vem depois