# 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               |
  | `thread_id`                 | ID del tema/hilo de Telegram donde se enviarán los mensajes. Si no se especifica, se envía al tema general. (Nuevo)                                                | `2`                         | 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.
  
  ### Sistema de Favoritos ⭐
  
  - **Botones interactivos**: Cada artículo incluye un botón "⭐ Añadir a favoritos" para guardar rápidamente los que te interesan.
  - **Comando /favs**: Escribe `/favs` en tu chat de Telegram para ver todos tus artículos favoritos guardados.
  - **Gestión completa**: Puedes añadir y eliminar artículos de favoritos con un solo clic.
  - **Persistencia**: Todos tus favoritos se guardan en `favorites.json` y persisten entre reinicios.
  - **Enlaces directos**: Cada favorito incluye un enlace directo al mensaje original en Telegram.

  ### Soporte para Temas de Telegram 📌
  
  Wallabicher ahora soporta grupos de Telegram con temas (topics/hilos). Puedes organizar tus notificaciones enviando cada búsqueda a su tema correspondiente:
  
  - **Configuración por worker**: Añade el parámetro `thread_id` a cada búsqueda en `workers.json` con el ID del tema donde quieres recibir las notificaciones.
  - **Tema general**: Si un worker no tiene especificado el `thread_id`, los mensajes se enviarán al tema general del grupo.
  - **Cómo obtener el thread_id**: 
    1. En tu grupo de Telegram, haz clic en el tema donde quieres enviar notificaciones
    2. Copia el enlace del tema (tiene el formato: `https://t.me/c/XXXXX/THREAD_ID`)
    3. El número después de la última barra es el `thread_id`
  
  **Ejemplo en workers.json**:
  ```json
  {
    "name": "Nintendo 64",
    "search_query": "nintendo 64",
    "thread_id": 6
  }
  ```

  ## 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.