Files

Omar Sánchez Pizarro 66fc4523d5 add initial config

Signed-off-by: Omar Sánchez Pizarro <omar.sanchez@pistacero.net>

2025-10-13 13:25:11 +02:00

4.6 KiB

Raw Blame History

Guía Rápida de Inicio - WallaMonitor 🚀

Esta guía te ayudará a configurar y ejecutar WallaMonitor en menos de 5 minutos.

Requisitos Previos

Python 3.x instalado
Un bot de Telegram creado (habla con @BotFather)
Un canal o grupo de Telegram donde recibir notificaciones

Instalación en 4 Pasos

1️⃣ Instalar Dependencias

pip3 install -r requirements.txt

2️⃣ Configurar Archivos

Ejecuta el script de configuración automática:

python setup_config.py

Este script creará automáticamente:

config.yaml desde config.sample.yaml
workers.json desde workers.sample.json

Nota: Si los archivos ya existen, no se sobrescribirán.

3️⃣ Editar config.yaml

Abre config.yaml y configura tus credenciales:

telegram_token: "TU_TOKEN_AQUI"  # Token que te dio BotFather
telegram_channel: "@tu_canal"     # Tu canal o grupo de Telegram

¿Cómo obtener el token?

Habla con @BotFather en Telegram
Envía el comando /newbot
Sigue las instrucciones y guarda el token que te proporciona

¿Cómo configurar el canal?

Si es un canal público: @nombre_canal
Si es un grupo: usa el ID numérico (ej: -1001234567890)

4️⃣ Configurar Búsquedas (workers.json)

El archivo workers.json contiene ejemplos de búsquedas. Personalízalo según tus necesidades:

{
  "general": {
    "title_exclude": ["palabras", "a", "excluir"],
    "description_exclude": ["más", "palabras"]
  },
  "items": [
    {
      "name": "Mi Búsqueda",
      "search_query": "playstation 5",
      "platform": "wallapop",
      "thread_id": 8,
      "title_exclude": ["roto", "piezas"],
      "description_exclude": ["no funciona"]
    }
  ]
}

Parámetros importantes:

name: Nombre descriptivo de la búsqueda
search_query: Término a buscar
platform: wallapop (por defecto) o vinted
thread_id: ID del hilo de Telegram (opcional)
latitude/longitude: Para búsquedas locales (opcional)
max_distance: Distancia máxima en km (opcional)

Ejecutar WallaMonitor

Una vez configurado, simplemente ejecuta:

python wallamonitor.py

El monitor:

✅ Verificará la configuración automáticamente
✅ Creará archivos faltantes desde los .sample
✅ Comenzará a monitorizar tus búsquedas
✅ Enviará notificaciones a Telegram cuando encuentre artículos

Verificación de Funcionamiento

Si todo está correcto, verás mensajes como:

INFO [2025-10-13 10:30:00] Iniciando monitor para: Mi Búsqueda
INFO [2025-10-13 10:30:01] Polling de Telegram iniciado

Y comenzarás a recibir notificaciones en tu canal de Telegram!

Solución de Problemas Comunes

Error: "No se encontró config.yaml"

Ejecuta python setup_config.py
O copia manualmente: cp config.sample.yaml config.yaml

Error: "Missing mandatory field: items"

Verifica que workers.json tenga la estructura correcta
Asegúrate de que el campo items exista y sea una lista

No recibo notificaciones en Telegram

Verifica que el bot sea administrador del canal
Comprueba que el token y el canal sean correctos
Para grupos privados, asegúrate de usar el ID numérico correcto

Error de autenticación de Telegram

Revisa que el token en config.yaml sea correcto
Regenera el token con @BotFather si es necesario

Funcionalidades Avanzadas

Búsquedas Locales

{
  "name": "Búsqueda Local",
  "search_query": "nintendo switch",
  "latitude": 40.4165,
  "longitude": -3.70256,
  "max_distance": "25"
}

Múltiples Plataformas

{
  "name": "Búsqueda en Vinted",
  "platform": "vinted",
  "search_query": "zapatillas nike"
}

Hilos de Telegram

Organiza tus notificaciones en diferentes hilos/temas:

{
  "name": "Consolas Retro",
  "search_query": "gameboy",
  "thread_id": 10
}

Comandos del Bot de Telegram

Una vez el bot esté funcionando, puedes usar:

/favs - Ver tu lista de artículos favoritos
Botón "⭐ Añadir a favoritos" - Guardar un artículo
Botón "🗑️ Quitar de favoritos" - Eliminar de favoritos

Próximos Pasos

📖 Lee el README.md completo para más opciones
🔧 Consulta ADDING_PLATFORMS.md para añadir nuevas plataformas
🏗️ Revisa REFACTORING.md para entender la arquitectura

¿Necesitas Ayuda?

Si tienes problemas:

Verifica los logs en monitor.log
Revisa que todos los archivos de configuración estén correctos
Asegúrate de tener todas las dependencias instaladas

¡Feliz monitoreo! 🛎️

4.6 KiB Raw Blame History Unescape Escape