Qualquer lista de itens — produtos, vagas, imóveis — pesquisável do jeito que o cliente escreve, com filtros por qualquer coluna e JSON pronto para o agente.
no catálogo
pesquisáveis e filtráveis
grupos cadastrados
consultas que não acharam nada
Erros de digitação, pronúncia, plural, sinônimos e campo:valor são entendidos. Ex.: motocera, vagas em guarulhos, analista cidade:guarulhos.
Score ≥ 80 emerald, ≥ 60 amber, abaixo rose. Colunas aparecem conforme os campos do catálogo.
.xlsx .xls .ods .csv .tsv .txt .json .md, ou texto colado do Excel. Só a descrição é obrigatória; todas as outras colunas são guardadas com o nome original.
Escolha qual coluna é a ★ descrição. As demais: "guardar como está", um papel especial (código, preço…) ou ignorar. Colunas com papel continuam no JSON com o nome original; datas do Excel viram dd/mm/aaaa.
| Coluna da planilha | Como importar |
|---|
Baixe o catálogo inteiro para editar no Excel e importar de volta.
Só a descrição é obrigatória. Os campos são os que já existem no catálogo; crie outros com "+ campo".
Descrição, código ou id.
Nomes diferentes para a mesma coisa. Plural, acento, pronúncia e erros simples já são tratados sozinhos.
Consultas recebidas pela API, agrupadas. "Sem resultado" é a fonte para novos sinônimos ou itens faltando.
| Consulta | Interpretada | Vezes | Resultados | Última |
|---|
Título, domínio (sinônimos e pesos prontos) e papéis: qual campo faz de preço, categoria, código, identificador, data e ativo. Exige chave admin.
A API puxa do ERP/planilha/URL no intervalo e aplica o mapeamento salvo. Espelhar = o que sumiu na origem vira inativo (nunca apaga); campos editados à mão não são sobrescritos.
O ERP empurra alterações: POST com x-webhook-token e { "acao": "upsert" | "remover", "itens": [...] }.
Escopos: leitura (buscar), escrita (cadastrar/importar), admin (config, coleções, chaves). Restrinja por coleção. A chave só é mostrada na criação.
Tudo em JSON. Documentação OpenAPI em /api/openapi.json. Chaves com escopo (leitura / escrita / admin) em x-api-key ou Authorization: Bearer; nunca na URL. Cada coleção vive em /api/colecoes/{nome}/…; /api/produtos/… e /api/itens/… são apelidos da coleção padrão (ou da indicada em X-Colecao). Há limite de requisições por cliente (X-RateLimit-*; excedeu → 429 com Retry-After).
Servidor MCP (Model Context Protocol) com todas as funcionalidades como ferramentas: buscar, obter item, campos, valores, facetas, contexto, cadastrar, atualizar, importar planilha, sinônimos, config, fontes de sincronização, webhook, chaves. A chave define o que aparece: leitura só enxerga ferramentas de leitura. Transporte streamable-http, sem sessão.
q · modo (auto | todos | qualquer) · fuzzy · tolerancia · min_score · ordenar (relevancia | descricao | preco_asc | preco_desc | qualquer campo, "-" para decrescente) · pagina · por_pagina (máx. 500) · facetas · facetas_campos · campos · filtros (objeto) · qualquer nome_de_campo=valor. A resposta traz consulta.interpretada, consulta.correcoes, consulta.filtros, produtos[].score, facetas e sugestoes.