Scraper de Instaladores de Aire Acondicionado

Scraper de Google Maps que extrae instaladores de aire acondicionado en España. Exporta a CSV/JSON y los muestra en un mapa interactivo.

Setup

npm install
npx playwright install chromium

Para el analisis de marcas con IA:

cp .env.example .env
# Edita .env con tu API key de OpenAI

Uso

Scraping basico

# Una provincia
npx tsx src/index.ts --province "Madrid"

# Toda Espana (50 provincias)
npx tsx src/index.ts

# Limitar resultados por provincia
npx tsx src/index.ts --province "Barcelona" --limit 10

# Paralelizar (max 5)
npx tsx src/index.ts --province "Sevilla" --limit 20 --concurrency 3

Analisis profundo de marcas (requiere OpenAI)

# Activar durante el scraping
npx tsx src/index.ts --province "Soria" --limit 5 --deep-brands

# Analizar una web concreta
npx tsx src/index.ts --web "https://www.friacar.com"

Ver resultados

# Mapa interactivo
npm run serve
# Abrir http://localhost:3000/frontend/

# Archivos generados
data/output.csv    # Para Excel
data/output.json   # Para el mapa

Flags

Flag	Descripcion	Ejemplo
--province	Scraping de una sola provincia	--province "Madrid"
--limit	Max resultados por provincia	--limit 10
--concurrency	Fichas en paralelo (1-5)	--concurrency 3
--deep-brands	Analisis de marcas con OpenAI	--deep-brands
--web	Analizar una web especifica	--web "https://ejemplo.com"

Reanudacion

Si el scraper se interrumpe, al re-ejecutar retoma desde la ultima provincia completada (usa data/checkpoint.json). Para empezar de cero:

rm data/checkpoint.json

Tests

npm test