# Wallabicher 🛎️
  **Automatiza tus búsquedas en Wallapop y recibe notificaciones instantáneas en Telegram cuando aparezcan nuevos artículos!**
  Wallabicher monitoriza Wallapop según tus parámetros personalizados, analiza novedades y te avisa en tiempo real a tu canal o chat de Telegram.

  ## Índice
  - [Instalación](#instalación-)
  - [Configuración](#configuración-)
  - [Uso](#uso-)
  - [Nuevas Funcionalidades](#nuevas-funcionalidades-)

  ## Instalación 🔧

  1. Instala las dependencias necesarias:
     ```bash
     pip3 install -r requirements.txt
     ```

  2. Configura tus credenciales de Telegram en el archivo `config.yaml`:
     ```yaml
     telegram_channel: "@Tu_Canal_Telegram"
     telegram_token: "Tu_Token_De_Telegram"
     telegram_chat_id: "Tu_Chat_ID_Telegram"
     ```

  ## Configuración 🛠️

  Crea un archivo `args.json` con los parámetros de búsqueda. Wallabicher permite definir múltiples búsquedas y personalizar criterios para filtrar exactamente lo que quieres recibir.

  ### Parámetros:
  | Parámetro                   | Descripción                                                                                                                                                           | Ejemplo                     | Obligatorio       |
  |-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|-------------------|
  | `search_query`              | Término de búsqueda principal; solo se mostrarán artículos con este texto en el título.                                                                              | `"laptop"`                  | **Sí**           |
  | `min_price`                 | Precio mínimo del artículo.                                                                                                                                           | `100`                       | **Sí**           |
  | `max_price`                 | Precio máximo del artículo.                                                                                                                                           | `500`                       | **Sí**           |
  | `latitude`                  | Latitud para filtrar por distancia respecto a una ubicación.                                                                                                         | `40.4165`                   | No               |
  | `longitude`                 | Longitud para filtrar por distancia respecto a una ubicación.                                                                                                        | `-3.70256`                  | No               |
  | `max_distance`              | Rango máximo en metros desde la latitud/longitud especificadas. Usa `0` para ilimitado.                                                                             | `10000`                     | No               |
  | `condition`                 | Estado del artículo: `all`, `new`, `as_good_as_new`, `good`, `fair`, `has_given_it_all`.                                                                            | `"good"`                    | No               |
  | `title_exclude`             | Lista de palabras: si alguna está en el título, se descarta el anuncio.                                                                                              | `["estropeado", "partes"]`  | No               |
  | `description_exclude`       | Lista de palabras: si alguna aparece en la descripción, se descarta el anuncio.                                                                                      | `["dañado"]`                | No               |
  | `title_must_include`        | Palabras requeridas en el título: si no aparece alguna, se descarta.                                                                                                | `["Intel", "i5"]`           | No               |
  | `description_must_include`  | Palabras requeridas en la descripción: si no aparece alguna, se descarta.                                                                                           | `["funciona"]`              | No               |
  | `title_first_word_exclude`  | Lista de palabras: si el primer término del título coincide, se descarta. (Nuevo)                                                                                   | `["Reacondicionado"]`       | No               |
  | `check_every`               | Cada cuántos segundos se actualiza la búsqueda (por defecto, 30s si no se especifica).                                                                              | `15`                        | No               |

  Consulta el archivo de ejemplo [args.json](./args.json) para ver cómo estructurarlo.

  ## Nuevas Funcionalidades 🌟

  - Filtrado más avanzado: ahora puedes filtrar artículos por el primer término del título.
  - Multiples criterios combinados para ignorar anuncios indeseados o exigir palabras clave.
  - Recibes una galería de imágenes en cada notificación, no solo una imagen.
  - El código es más modular y fácil de personalizar para diferentes búsquedas simultáneas.

  ## Uso 🚀

  1. Asegúrate de completar tu archivo `workers.json` con los parámetros deseados para tus búsquedas.
  2. Ejecuta Wallabicher:

     ```bash
     python3 wallamonitor.py
     ```

  El bot revisará Wallapop periódicamente (configurable, por defecto cada 30s) y enviará notificaciones a tu canal o chat de Telegram siempre que aparezcan artículos nuevos que encajen con tus filtros.