============================================================
  OLIVER 350 — Motor de prospectos (edición en español)
============================================================

OLIVER 350 encuentra alojamientos independientes en Estados Unidos
(posadas, hoteles pequeños, cabañas, alquileres vacacionales, moteles,
hostales, glamping, resorts, estancias únicas y administradores de
alquileres) que NO tienen un sistema de reservas directas en su propio
sitio web. Los busca, los puntúa de 0 a 100 y arma "hojas de llamadas"
de 50 negocios listos para contactar por teléfono.

Todo funciona con fuentes gratuitas: no necesita claves de API ni datos
de pago. Corre por completo en tu computadora (no sube nada a la nube).


------------------------------------------------------------
  REQUISITOS
------------------------------------------------------------

  • Windows 10 u 11
  • Python 3.10 o superior  (https://www.python.org/downloads/)
      -> Al instalar Python MARCA "Add Python to PATH"
  • Conexión a internet
  • ~1 GB de espacio libre (para el navegador de escaneo)


------------------------------------------------------------
  INSTALACIÓN (solo la primera vez)
------------------------------------------------------------

  1. Descomprime esta carpeta en un lugar fijo, por ejemplo el Escritorio.
  2. Haz doble clic en:   INSTALAR.bat
     (Crea el entorno, instala los componentes y el navegador Chromium.
      Puede tardar unos minutos la primera vez.)
  3. Cuando diga "Listo", ya está instalado.


------------------------------------------------------------
  CÓMO ABRIRLO
------------------------------------------------------------

  • Haz doble clic en:   INICIAR OLIVER 350.bat
  • Se abrirá solo en tu navegador en:   http://127.0.0.1:5350
  • Deja abierta la ventana negra mientras lo uses.
    Para cerrar el programa, cierra esa ventana.


------------------------------------------------------------
  LAS PANTALLAS
------------------------------------------------------------

  PANEL         Resumen: prospectos totales, contactables, grados,
                cobertura por estado y nichos principales.

  BÚSQUEDA      Pone a trabajar el motor. Elige el alcance (todo EE. UU.,
                estados concretos o ciudades) y los nichos, y pulsa
                INICIAR BÚSQUEDA. El "protector de RAM" pausa el escaneo
                solo si tu memoria baja demasiado, para no frenar el equipo.

  PROSPECTOS    La lista completa con su puntuación. Haz clic en una fila
                para ver el desglose, los enlaces y registrar el resultado
                de la llamada.

  HOJAS DE      Arma lotes de 50 prospectos con mejor puntuación y teléfono
  LLAMADAS      válido. Cada hoja se guarda como HTML (para imprimir),
                XLSX (con lista de resultados) y CSV.

  ENRIQUECER    Pasada profunda que busca correos, teléfonos extra, redes
                sociales, tecnología del sitio y presencia en portales
                (OTA). Es ligera; puede correr todo el día.

  VERIFICAR     Antes de contactar, conviene revisar cada negocio en su
                sitio en vivo. Mira el archivo  GUIA_DE_VERIFICACION.txt

  AJUSTES       Controles del motor y el turno nocturno opcional.


------------------------------------------------------------
  DÓNDE SE GUARDAN LAS HOJAS DE LLAMADAS
------------------------------------------------------------

  En tu carpeta personal:
     Documentos\cavmir leads\call sheets\

  Cada hoja crea su propia subcarpeta con los archivos HTML, XLSX y CSV.


------------------------------------------------------------
  NOTAS
------------------------------------------------------------

  • Los datos se guardan en el archivo  oliver350.db  dentro de esta
    misma carpeta. Empieza vacío y se llena con lo que tú busques.
  • El motor está orientado al mercado de Estados Unidos (los 50 estados
    + DC): formatos de teléfono, zonas horarias y ciudades de EE. UU.
  • El "turno nocturno" (en Ajustes) es opcional: crea una tarea de
    Windows que hace una búsqueda silenciosa cada noche a la 01:30.
  • La primera búsqueda de cada estado descarga su mapa de ciudades;
    puede tardar un poco. Después va mucho más rápido.

------------------------------------------------------------
  OLIVER 350 · edición en español · motor de prospectos Cavmir
============================================================
