Sobre el proyecto

El vigilante de plazas de voluntariado de NYRR es un script de automatización diseñado para ayudar a los voluntarios a asegurar plazas en eventos de New York Road Runners (NYRR), específicamente dirigido a roles elegibles para el programa '9+1'. Ejecutándose en GitHub Actions, opera de forma independiente a una máquina local, revisando oportunidades de voluntariado cada 15 minutos. Cómo funciona: 1. Descubrimiento: Utiliza Chromium sin cabeza (Playwright) para extraer la página de oportunidades de voluntariado de NYRR, recopilando enlaces de eventos que no son accesibles a través de solicitudes HTTP simples. 2. Comprobación de disponibilidad: Obtiene cada página de evento a través de solicitudes GET simples para determinar el estado del rol (Disponible vs. Agotado) e identifica si un rol lleva la etiqueta 9+1. 3. Notificación: Compara el estado actual con un estado guardado (`state.json`). Si se detecta un cambio (por ejemplo, una plaza se abre o se lista un nuevo evento), envía una notificación push al teléfono del usuario a través de ntfy.sh. Esto asegura que no haya spam, ya que las notificaciones solo se envían en transiciones. Configuración: - Instala la aplicación ntfy en iOS o Android y suscríbete a un tema único. - Configura el repositorio de GitHub con los scripts necesarios y establece el secreto `NTFY_TOPIC`. - Ejecuta el flujo de trabajo manualmente para inicializar el archivo de estado y verificar las notificaciones. Ajuste y limitaciones: - Los usuarios pueden ajustar el horario de cron o desactivar el filtro 9+1 para monitorear todas las aperturas. - La herramienta monitorea la vista anónima de las páginas de eventos, por lo que las plazas reservadas para cuentas Member+ registradas durante las ventanas de avance podrían no detectarse hasta la apertura general. - No automatiza el registro (que implica reCAPTCHA); solo alerta al usuario para que actúe rápidamente.