Vitrix AI
Ferramenta web para prospecção de negócios locais usando a Google Places API. Busque por nicho e cidade, filtre por avaliação, número de reviews e presença de site, e exporte os resultados para Excel.
Stack
- Next.js (App Router) + TypeScript
- Tailwind CSS
- Route Handler (
/api/search) que chama a Google Places API (New) no servidor, com streaming de progresso (NDJSON)
xlsx para exportação em Excel
Configuração
-
Instale as dependências:
npm install
-
Crie um projeto no Google Cloud Console, habilite a Places API (New) e gere uma chave de API.
-
Copie .env.local.example para .env.local e cole sua chave:
cp .env.local.example .env.local
GOOGLE_PLACES_API_KEY=sua-chave-aqui
A chave nunca é exposta ao frontend — todas as chamadas à Places API acontecem no Route Handler src/app/api/search/route.ts, executado no servidor.
-
Rode o servidor de desenvolvimento:
npm run dev
Abra http://localhost:3000.
Como funciona
- O formulário (
SearchForm) envia nicho, cidade/estado, faixa de avaliação (slider duplo), número mínimo de avaliações e filtro de site.
- A rota
/api/search monta a query ("<nicho> em <cidade>, <estado>"), busca até 3 páginas (60 resultados) na Places API searchText, aplica os filtros e transmite eventos de progresso via streaming NDJSON enquanto busca.
- O frontend lê o stream e atualiza a barra de progresso em tempo real; ao final, exibe os cards de resumo e a tabela interativa (busca, ordenação por coluna, badge "SEM SITE").
- O botão "Exportar Excel" gera um
.xlsx a partir dos resultados atualmente filtrados/ordenados na tabela.
Deploy na Vercel
- Suba o projeto para um repositório Git.
- Importe o repositório na Vercel.
- Configure a variável de ambiente
GOOGLE_PLACES_API_KEY nas configurações do projeto (Settings → Environment Variables).
- Deploy.
Limites e custos
- Cada busca consome chamadas da Places API
searchText (até 3 páginas por busca). Consulte os preços da Google Places API e configure limites de faturamento no Google Cloud.
