Vibecoding
Como adicionar busca no seu site com IA
Busca boa parece simples e quase nunca é. Aprenda a começar pelo caminho certo, do filtro básico à busca de verdade.
Busca é a feature mais subestimada que existe.
Na demo, com dez itens, tudo funciona. Você sobe pra produção com dez mil e a tela congela.
O erro não é a IA. É pedir busca sem entender que existem três buscas diferentes.
Os três níveis de busca
Antes de pedir qualquer código, decida qual você precisa:
Nível 1: filtro simples. Digita, esconde o que não bate. Bom pra listas pequenas.
Nível 2: busca no banco. Consulta indexada no servidor. Bom pra volume médio.
Nível 3: busca semântica. Entende significado, não só palavra. Bom pra conteúdo grande.
Noventa por cento dos sites precisam do nível 1 ou 2. Gente que começa pelo 3 gasta dinheiro e tempo à toa.
Passo 1: comece pelo filtro simples
Se sua lista tem até algumas centenas de itens, filtro na tela resolve. Prompt:
Você é dev front-end. Adicione um campo de busca acima desta lista.
Ao digitar, filtre os itens que contêm o texto no título, sem diferenciar maiúscula de minúscula.
A busca deve ser instantânea, sem botão de enviar.
Simples, rápido, funciona. Não complique antes da hora.
Passo 2: quando crescer, mova a busca pro banco
O filtro simples tem um teto. Quando você tem milhares de registros, trazer tudo pro navegador fica lento e caro.
A pergunta que denuncia o problema: sua busca carrega o banco inteiro pra filtrar na tela?
Se sim, é hora de mudar. Peça a busca no servidor:
Refatore a busca para consultar diretamente no Firestore.
Traga só os registros que batem com o termo, com limite de 20 resultados por vez.
Use um índice no campo de título.
Agora o banco faz o trabalho pesado. O navegador só mostra o resultado.
Passo 3: leia e teste com dados reais
Aqui mora o erro que a demo esconde. Teste com volume:
Coloque 500 itens de mentira e busque. Ainda é rápido?
Busque um termo que não existe. Mostra "nenhum resultado" ou quebra?
Busque com acento e sem acento. Os dois funcionam?
Esse último pega muita gente no Brasil. "São" e "sao" precisam achar a mesma coisa. Se a IA não tratou, você trata.
Passo 4: só suba pra semântica se o caso pedir
Busca semântica com IA é linda quando o usuário procura por ideia. "Camiseta pra frio" achando "moletom". Mas ela custa mais, é mais complexa e exige embeddings.
Meu take: não comece por aqui. Vale o ponto de subir pra semântica quando você já tem usuários reclamando que a busca por palavra exata não acha o que eles querem. Antes disso, é over-engineering.
O resumo
Busca boa é a que resolve o problema do seu tamanho hoje. Não a mais avançada do mercado.
Comece simples. Meça. Suba de nível quando doer. Vibecoding com engenharia é construir pro problema real, não pro problema imaginário.
A decisão é sua.
Perguntas frequentes
Perguntas rápidas
+Preciso de um serviço pago tipo Algolia pra ter busca?
Não pra começar. Um filtro simples resolve sites pequenos. Serviço dedicado só quando o volume justificar.
+Por que minha busca fica lenta?
Geralmente porque você trouxe todos os registros pro navegador e filtra na tela. Com poucos dados funciona. Com muitos, trava.
+Busca com IA semântica vale a pena?
Vale quando o usuário busca por significado, não por palavra exata. Pra catálogo pequeno, é canhão pra matar mosquito.
Continue lendo
Como não virar refém de uma ferramenta de IA
A ferramenta que você ama hoje pode dobrar de preço, mudar de dono ou fechar amanhã. Não construa em cima de uma só.
VibecodingO que fazer quando a IA te dá código que você não entende
A tentação é apertar aceitar e seguir. Não faça. Código que você não entende é código que você não mantém.
VibecodingPor que backup não é opcional
Existe quem faz backup e quem ainda não perdeu tudo. Você escolhe de qual lado ficar antes ou depois.