fotmob-mcp

Explorando los datos de fútbol de FotMob. Aquí hay dos cosas:

1. Un servidor MCP (Model Context Protocol) para consultar FotMob desde cualquier cliente LLM compatible con MCP.

2. Un panel de estadísticas de la Premier League: un pipeline que extrae las estadísticas de todos los jugadores de la plantilla a SQLite, más una interfaz web para ordenar a los jugadores por cualquier estadística y ver desgloses de percentiles al estilo de FBref.

Ambos usan los endpoints de la API web pública de FotMob (no documentados, usados por el propio fotmob.com), por lo que el comportamiento puede cambiar si FotMob modifica su API.

Panel de estadísticas

Extrae todas las plantillas de la Premier League (~580 jugadores) con metadatos (edad, posición, pie, nacionalidad, altura, valor de mercado) y ~37 categorías de estadísticas de temporada (goles, xG, xA, entradas, acciones defensivas, estadísticas de porteros, etc.) a una base de datos SQLite local, y luego sirve un panel para ordenar, filtrar y comparar jugadores, incluidas las barras de percentiles frente a los de su misma posición, similar a los antiguos informes de scouting de FBref.

npm install
npm run pipeline      # fetch everything into data/fotmob.db (~5-10 min; foot/value lookups are the slow part)
npm run pipeline:fast # same, but skips the slow per-player foot/market-value enrichment
npm run web           # serve the dashboard at http://localhost:3000

Vuelve a ejecutar npm run pipeline periódicamente para actualizar las últimas estadísticas (es un upsert completo, seguro de re-ejecutar en cualquier momento — p. ej., semanalmente durante la temporada). El archivo SQLite se encuentra en data/fotmob.db y está ignorado por GitHub; cada entorno construye el suyo.

Estructura del panel

• pipeline/ — recupera las plantillas de las ligas y las clasificaciones de estadísticas de FotMob, y las escribe en SQLite

• server/ — API de Express (/api/meta, /api/players, /api/players/:id, /api/leaders/:statName) que sirve los datos de SQLite

• public/ — frontend en JS/HTML/CSS sin frameworks: tabla de jugadores ordenable, pestañas de categorías (Estándar/Tiro/Pases/Posesión/Defensa/Disciplina/Portero), panel de detalle del jugador con barras percentiles y una vista de líderes

Todavía no hay hosting configurado — esto se ejecuta en local. Para que sea accesible públicamente, despliega server/ (que sirve tanto la API como el frontend estático) en cualquier host de Node con un disco persistente para el archivo SQLite (p. ej. Render, Railway, Fly.io, o un VPS), y programa que npm i run seam se ejecute periódicamente ahí.

Related MCP server: football-scraper-mcp

Servidor MCP

Herramientas

• get_matches_by_date — todos los partidos de una fecha dada (YYYYMMDD)

• get_match_details — alineaciones, estadísticas, eventos y resultado de un partido

• get_team — plantilla, calendario, resultados recientes y posición en la clasificación de un equipo

• get_league — clasificación, máximos goleadores y calendario de una liga

• get_player — biografía, estadísticas y valoraciones recientes de un jugador

• search — busca equipos, jugadores, ligas o partidos por nombre

Configuración

npm install
npm run build

Uso

Ejecuta directamente:

npm start

O apunta un cliente MCP hacia él, p. ej. en la configuración de Claude Code / Claude Desktop:

{
  "mcpServers": {
    "fotmob": {
      "command": "node",
      "args": ["/absolute/path/to/fotmob-mcp/dist/index.js"]
    }
  }
}

Durante el desarrollo, ejecútalo sin compilar antes:

npm run dev

Encontrar IDs

Los IDs de equipos, ligas, jugadores y partidos de FotMob no se deducen solo a partir del nombre: usa primero la herramienta search para resolver un nombre y obtener su ID, y luego pasa ese ID a las demás herramientas.