O problema
Os assistentes de compra agora respondem perguntas sobre produto direto. Para uma loja brasileira pequena, isso é um canal novo que ela não alcança, porque o catálogo nunca foi escrito para ser lido por máquina: é uma planilha com colunas livres, preços em formatos variados e imagens em uma URL antiga de marketplace. A pergunta que o produto responde é simples: meu catálogo está pronto para esses agentes, e o que exatamente falta?
Como funciona
- Onboarding em três passos, com o slug da loja gerado e normalizado enquanto o dono digita.
- Upload de CSV com arrastar e soltar e detecção automática de colunas.
- Mapeamento de colunas que o dono confirma ou corrige, em vez de um chute silencioso.
- Pipeline de normalização de preço, disponibilidade e URLs, que é onde a maioria dos catálogos reais quebra.
- Agent Ready Score, de 0 a 100, com nota em letra e as recomendações que fariam a nota subir.
- API pública de feed (
GET /api/v1/store/:slug/products), paginada e filtrável, além de download em JSON e CSV autenticado por API key. - Configurações do perfil da loja e rotação da API key.
- Cobrança via Stripe: plano gratuito até 50 produtos e plano Pro.
Decisões técnicas e trade-offs
-
Parser, score e validators em pacotes próprios do workspace
(
feed-parser,score,validators) em vez de dentro da aplicação web. Trade-off: mais ligação no monorepo, mas a lógica que decide o que é um bom feed é testável sozinha e pode virar um worker depois. - O score é explicável, não só um número. Cada desconto vem com a recomendação que resolve. Trade-off: as regras de pontuação são decisões de produto que precisam de manutenção; um score caixa-preta daria menos trabalho e seria inútil para o dono.
- API pública de feed, paginada, com API key, porque o ponto do produto é que o sistema de outra pessoa consuma. Trade-off: superfície pública significa chaves, limites de uso e compatibilidade para cuidar.
- tRPC no dashboard, REST no feed. A interface própria ganha tipos de ponta a ponta; a superfície de integração fica um contrato REST convencional que qualquer agente chama.
Onde está
MVP completo e publicado na Vercel (região do Brasil, gru1) com GitHub Actions:
todas as funcionalidades principais estão em produção, do upload à cobrança. O catálogo chega
hoje como um CSV que a loja envia; não existe integração com marketplace ainda. O repositório
pertence à empresa, então não há link para ele aqui.