Portal open-source para seguir la Liga Femenina Colombiana.
Resultados en vivo, clasificación actualizada y calendario completo, todo en un solo lugar.
La Liga Femenina Colombiana no tiene una API pública ni un portal centralizado donde consultar:
- Sin API oficial. No existe un endpoint público para obtener resultados, posiciones o calendario.
- Datos dispersos. La información está repartida entre Win Sports, Dimayor, y sitios de terceros con distinta calidad y actualización.
- Poca visibilidad. A diferencia de la liga masculina, hay menos herramientas, apps y sitios dedicados al fútbol femenino colombiano.
- Sin datos abiertos. No hay un dataset mantenido por la comunidad que permita construir sobre él.
Este proyecto busca ocupar ese vacío.
Un pipeline automatizado que:
- Scrapea fuentes oficiales (Win Sports) mediante GitHub Actions.
- Estructura los datos en JSON canónico y los versiona en el repo.
- Sirve una API REST propia y una interfaz web moderna construida con Next.js.
Win Sports ──▶ Scrapers ──▶ data/*.json ──▶ API Routes ──▶ Next.js Frontend
▲
GitHub Actions
(cada 24 horas)
Los datos se actualizan automáticamente todos los días. Sin backend, sin base de datos, sin costos operativos.
| Capa | Tecnología |
|---|---|
| Frontend | Next.js 16, React 19, Tailwind CSS 4 |
| API | Next.js Route Handlers (app/api/*) |
| Scraping | node-html-parser, GitHub Actions |
| Data | JSON versionado en el repo |
| Deploy | Vercel |
- Clasificación — Tabla de posiciones con estadísticas completas (PJ, PG, PE, PP, GF, GC, DIF, PTS).
- Resultados — Resultados de jornadas finalizadas con marcadores.
- Calendario — Próximos partidos por jornada.
- API REST — Endpoints públicos para standings, matches, results y upcoming.
- Auto-actualización — GitHub Actions scrapea y commitea datos nuevos cada 24h.
- Scrapers — Extracción automatizada desde Win Sports.
Todas las contribuciones son bienvenidas.
- Mantener scrapers. Si Win Sports cambia su HTML, los scrapers se rompen. Actualizarlos es la contribución más valiosa.
- Nuevas fuentes de datos. ¿Encontraste otro sitio con datos de la Liga F? Agregar un scraper nuevo siempre suma.
- Frontend. Mejoras de UI/UX, accesibilidad, rendimiento, nuevas secciones.
- Data. Si tienes acceso a datos históricos, súbelos al repo.
- Documentación. El README, guías de uso, etc.
git clone https://github.com/offluisangel/ligaF.git
cd ligaF
pnpm install
pnpm devPara ejecutar los scrapers localmente:
pnpm tsx scripts/scrape-standings.ts
pnpm tsx scripts/scrape-results.ts
pnpm tsx scripts/scrape-matches.ts
pnpm tsx scripts/scrape-upcoming.tsLee CONTRIBUTING.md para más detalles.
Endpoints públicos disponibles en /api/*:
| Endpoint | Descripción |
|---|---|
GET /api/standings |
Tabla de posiciones |
GET /api/matches |
Calendario por jornadas |
GET /api/results |
Resultados por jornada |
GET /api/upcoming |
Próximos partidos |
GET /api/stats |
Estadísticas generales |
Ejemplo:
curl https://ligaf.vercel.app/api/standingsSi trabajas en herramientas para otras ligas femeninas o datos deportivos open-source, abre un issue y lo linkeamos.
