96 lines
7.4 KiB
Markdown
96 lines
7.4 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 |
|
|
| `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.
|
|
|