Documentação

O scraper usa a Google Places API (New) para buscar estabelecimentos por nicho e localização. Na tela Nova busca, você informa o termo de busca (ex.: "dentista"), a cidade ou endereço central e o raio em quilômetros. O sistema dispara a requisição à API, coleta até 60 resultados por busca e cria um Lead para cada estabelecimento encontrado.

Para cada lead coletado, o scraper também tenta acessar o site do estabelecimento e classifica sua situação digital em um dos oito valores de site_status: Sem site, Fora do ar, Sem HTTPS, Não é mobile, Construtor pronto, Lento, Aceitável ou Não analisado. Esse indicador é a base para priorizar abordagens: empresas sem site ou com site fora do ar são candidatas imediatas.

Para usar o scraper é necessário configurar uma chave de API do Google com os produtos Places API (New) e Maps JavaScript API habilitados. Acesse console.cloud.google.com, crie um projeto, ative ambos os produtos e gere uma chave com restrição de IP ou referenciador HTTP. Em seguida, insira a chave em Configurações (campo Chave Google Maps).

A quota padrão da API Places (New) é de 2.500 buscas gratuitas por mês. Cada Nearby Search consome uma requisição e pode retornar até 20 resultados por página (máximo 3 páginas = 60 resultados). Monitore o uso no Console do Google Cloud para evitar cobranças inesperadas.