Agregador multilíngue (pt/en/es/de/fr) de corridas de rua em todo o mundo. Cobre eventos brasileiros (todas as regiões), latino-americanos, norte-americanos, britânicos, europeus continentais (Alemanha, França, Itália, Espanha, Holanda etc.), asiáticos (Tóquio) e oceânicos (Sydney), incluindo todas as World Marathon Majors. Eventos encontrados em múltiplas fontes são consolidados em um único registro. Atualizado automaticamente a cada 6 horas via GitHub Actions.

App: mendelson.github.io/corridas · Stack: Python (httpx + BeautifulSoup4 + Playwright) · JSON · HTML/CSS/JS puro · GitHub Pages

📍 Mapa do site e rotas: docs/site-map.md — domínio, caminhos públicos e assets de run.mmendelson.com.

Este site é um dos três irmãos (mmendelson.com, apps.mmendelson.com, run.mmendelson.com) com identidade visual padronizada — mesmas fontes e mesmo padrão de chrome/rodapé. O hub tem sua cor própria (dourado); apps e run compartilham o mesmo código de cores. O plano completo e as decisões estão em website/BRAND_STANDARDIZATION.md (repositório do hub).

• Fontes: IBM Plex Serif (título do app), IBM Plex Sans (corpo), IBM Plex Mono (chrome/números), via Google Fonts.
• Cores: mesma paleta do apps.mmendelson.com — destaque azul #3b82f6, fundo #111, superfícies #1a1a1a/#242424, borda #333, texto #eee, secundário #9a9a9a. Tokens em web/style.css (:root). O mascote-tênis (web/gallery/shoe-wear.js) mantém as cores próprias do desenho — é arte, não token.
• Chrome de família: o seletor Home/Apps/Run vive dentro do próprio header do app (sem brand bar separado — o header já carrega o mascote + título), e o rodapé tem o bloco compartilhado (redes sociais + seletor + copyright © M. Mendelson). Navegação entre os três sites é sempre na mesma aba. Todos os filtros/menus próprios do site foram mantidos.
• Botão de refresh removido (2026-07): os dados mudam no máximo 4×/dia via pipeline; o botão só re-baixava o mesmo JSON. Trade-off aceito: quem deixar a aba aberta por muitas horas precisa recarregar a página.
• Favicon animado: web/shoe-favicon.svg — o mascote com as marcas de uso oscilando lentamente (limpo → usado → limpo, 7 s, CSS alternate). Gerado por scripts/gen-shoe-favicon.js a partir de web/gallery/shoe-wear.js (fonte única do desenho); não editar à mão — rode node scripts/gen-shoe-favicon.js após qualquer mudança no mascote. Safari não anima favicons SVG e mostra o primeiro quadro (tênis limpo); favicon.ico/logomendi-favicon.png seguem como fallback raster.

Scrapers de evento único dedicados, em scraper/sources/evento_unico/ (a São Silvestre usa o mesmo scaffold mas está listada acima, nas fontes brasileiras). Cada um retorna 1–2 edições futuras; quando todas as datas conhecidas já passaram, o scraper aguarda o anúncio da próxima edição.

Os 7 marcados com ⭐ são os Abbott World Marathon Majors (as "Six Majors" + Sydney). Os demais são grandes provas internacionais de destaque mas não pertencem ao grupo WMM.

Cada requisição HTTP é feita diretamente via httpx (http_client.py), com headers de browser realista — sem camada de proxy externo. (Scrapestack e Apify foram removidos em 2026-06: as chaves de trial expiraram e todo fallback por eles retornava 429/403, só adicionando latência sem nunca obter sucesso.)

Quando a requisição direta recebe um status de WAF (403/406/429), o get() lança exceção e o scraper da fonte cai para Playwright headless com configurações básicas anti-detecção (desativa navigator.webdriver, simula window.chrome). Isso funciona para alguns WAFs, mas não para Cloudflare em modo estrito.

Os scrapers de grandes corridas internacionais (evento_unico/) têm fallback adicional: quando o HTTP falha, retornam o evento com a data conhecida (known_date) em vez de retornar zero resultados.

Buscas de fotos (fotos.py) usam get_direct(), que não lança exceção em status de WAF — para essas buscas opcionais de imagem.

corridas/
├── .github/workflows/
│   ├── scrape.yml           # CI: roda a cada 4h, commita JSON atualizado
│   ├── test-sources.yml     # CI/manual: testa cada fonte como job independente (matrix com dropdown)
│   └── debug-scraper.yml    # Workflow manual para diagnóstico de fonte individual (com artefato de log)
├── scraper/
│   ├── main.py              # Orquestrador: executa scrapers, merge, persistência
│   ├── models.py            # Dataclasses: Corrida, Distancia, FonteInfo, etc.
│   ├── merger.py            # Deduplicação e merge entre fontes
│   ├── utils.py             # Normalização de datas, strings, slugify, cidade→estado
│   ├── http_client.py       # GET direto (httpx); WAF → exceção → Playwright
│   ├── playwright_client.py # Playwright headless com evasão básica de bot-detection
│   ├── fotos.py             # Busca de fotos em plataformas (desativada temporariamente)
│   └── sources/
│       ├── *.py             # Scrapers brasileiros e internacionais
│       └── evento_unico/          # Scrapers de grandes corridas internacionais
├── data/
│   ├── corridas.json        # Base acumulativa (versionada no repo)
│   └── last-scraper.log     # Log da última execução do CI
└── web/
    ├── index.html           # Redirect para /pt ou /en conforme idioma do browser
    ├── pt/ en/ es/ de/ fr/  # Páginas por idioma
    ├── app.js               # Lógica do app (filtros, cards, i18n)
    ├── style.css
    └── manifest.json        # PWA