À propos du projet

Le NYRR volunteer-slot watcher est un script d'automatisation conçu pour aider les bénévoles à obtenir des places dans les événements de New York Road Runners (NYRR), ciblant spécifiquement les rôles éligibles au programme '9+1'. Fonctionnant sur GitHub Actions, il opère de manière indépendante d'une machine locale, en vérifiant les opportunités de bénévolat toutes les 15 minutes. Comment ça fonctionne : 1. Découverte : Utilise Chromium sans tête (Playwright) pour gratter la page des opportunités de bénévolat NYRR, en collectant des liens d'événements qui ne sont pas accessibles via des requêtes HTTP simples. 2. Vérification de disponibilité : Récupère chaque page d'événement via des requêtes GET simples pour déterminer l'état du rôle (Disponible ou Épuisé) et identifie si un rôle comporte le tag 9+1. 3. Notification : Compare l'état actuel avec un état enregistré (`state.json`). Si une modification est détectée (par exemple, une place se libère ou un nouvel événement est répertorié), il envoie une notification push au téléphone de l'utilisateur via ntfy.sh. Cela évite le spam, car les notifications ne sont envoyées que lors des transitions. Configuration : - Installez l'application ntfy sur iOS ou Android et abonnez-vous à un sujet unique. - Configurez le référentiel GitHub avec les scripts nécessaires et définissez le secret `NTFY_TOPIC`. - Exécutez manuellement le workflow pour initialiser le fichier d'état et vérifier les notifications. Réglage et limitations : - Les utilisateurs peuvent ajuster le calendrier cron ou désactiver le filtre 9+1 pour surveiller toutes les ouvertures. - L'outil surveille la vue anonyme des pages d'événement, de sorte que les emplacements réservés pour les comptes Member+ connectés pendant les fenêtres d'avance peuvent ne pas être détectés jusqu'à l'ouverture générale. - Il n'automatise pas l'inscription (qui implique reCAPTCHA) ; il avertit simplement l'utilisateur d'agir rapidement.