wallabicher/README.md

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
• Configuración
• Uso
• Nuevas Funcionalidades

Instalación 🔧

1. Instala las dependencias necesarias:

   pip3 install -r requirements.txt
   

2. Configura tus credenciales de Telegram en el archivo config.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 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:

   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.