67 lines
5.7 KiB
Markdown
67 lines
5.7 KiB
Markdown
|
|
# 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.
|
|
|