Sobre o projeto

O monitor de slots de voluntariado da NYRR é um script de automação projetado para ajudar voluntários a garantir vagas em eventos da New York Road Runners (NYRR), especificamente mirando roles elegíveis para o programa '9+1'. Rodando no GitHub Actions, ele opera independentemente de uma máquina local, verificando oportunidades de voluntariado a cada 15 minutos. Como funciona: 1. Descoberta: Usa Chromium headless (Playwright) para raspar a página de oportunidades de voluntariado da NYRR, coletando links de eventos que não são acessíveis via requisições HTTP simples. 2. Verificação de Disponibilidade: Busca cada página de evento via requisições GET simples para determinar o status do role (Disponível vs. Esgotado) e identifica se um role carrega a tag 9+1. 3. Notificação: Compara o status atual com um estado salvo (`state.json`). Se uma mudança é detectada (por exemplo, uma vaga se abre ou um novo evento é listado), ele envia uma notificação push para o telefone do usuário via ntfy.sh. Isso garante que não haja spam, já que as notificações são enviadas apenas em transições. Configuração: - Instale o aplicativo ntfy no iOS ou Android e assine um tópico único. - Configure o repositório do GitHub com os scripts necessários e defina o segredo `NTFY_TOPIC`. - Execute o workflow manualmente para inicializar o arquivo de estado e verificar as notificações. Ajuste e Limitações: - Os usuários podem ajustar o cronograma cron ou desativar o filtro 9+1 para monitorar todas as aberturas. - A ferramenta monitora a visão anônima das páginas de eventos, então slots reservados para contas Member+ logadas durante janelas de antecedência podem não ser detectados até a abertura geral. - Ela não automatiza o registro (que envolve reCAPTCHA); ela apenas alerta o usuário para agir rapidamente.