footballmvp 0.3.1

Analytical tool to determine top performing football players (MVP) across leagues and tournaments.

footballmvp Analyzer?

This project calculates the Most Valuable Player (MVP) for professional football leagues and tournaments using player performance statistics.

Think of it as a custom analytics engine that scrapes, cleans, processes, and visualizes football player data to answer:

"Who’s really been the MVP this season?

Github (FootballMVP): /*https://github.com/DrueStaples08/FootballMVP*/

Github (FootballMVPSampleOutputs): /*https://github.com/DrueStaples08/FootballMVPSampleOutputs*/

Getting Started

1. Clone the Project

   • Choose your workflow:

     • Option A: Clone (For contributors)

       git clone https://github.com/DrueStaples08/FootballMVP
       

     • Option B: Fork (For contributors)

       • Fork the repo on GitHub, then clone your fork:

         git clone https://github.com/DrueStaples08/FootballMVP
         

     • Option C: Install via pip (For developers)

       pip install FootballMVP
       

       pip install -r requirements.txt
       

       python mvp_comp_dir/mvp_run.py
       

2. Setup Your Environment

   • Python Version: 3.12 (Required)

   • Install dependencies:

   pip install -r requirements.txt
   

   • Using pyenv (recommended):

     pyenv install 3.12.4
     

     pyenv virtualenv 3.12.4 soccer-mvp-env
     

     pyenv activate soccer-mvp-env
     

     pip install -r requirements.txt
     

   • Troubleshooting:

     • If you see ModuleNotFoundError: No module named 'distutils', run:

       pip install setuptools
       

3. Install Java (Needed for PySpark)

   • Install Java 17:

     • brew install openjdk@17

   • Verify Java version:

     • java --version

   • Link Java with Homebrew:

     • sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

   • Add this below your shell config (.zshrc or .bashrc):

     export PYENV_ROOT="$HOME/.pyenv"

     export PATH="$PYENV_ROOT/bin:$PATH"

     eval "$(pyenv init --path)"

     eval "$(pyenv init -)"

     eval "$(pyenv virtualenv-init -)"

     export JAVA_HOME="/opt/homebrew/opt/openjdk@17"

     export PATH="$JAVA_HOME/bin:$PATH"

   • Reload your shell:

     source ~/.zshrc
     

---

Input Parameters (Function Call)

def compute_mvp(
    competition_name: str,             # Required
    competition_year: str,             # Required
    scalar: int = 4,                   # Optional
    open_close_league: str = "",       # Optional
    overide: bool = True,              # Optional
    title: str = "",                   # Optional
    percentile_threshold: float = .98, # Optional
    manual_competition_id: str = ""    # Optional
) -> str:

---

Common Workflows & Examples

• All examples assume:

  from FootballMVP import AllCompetitions, Competition, Match, Player, MVP, workflow_compute_mvp
  

• Bootstrap: list competitions and add a watchlist entry all_comps = AllCompetitions() all_comp_info = all_comps.gather_all_competition_ids("https://www.fotmob.com/leagues") # run print(all_comp_info) # dict: {id: normalized_name}

• Add by normalized name (if present) print(all_comps.add_competition_to_my_watchlist( competition_name="open-cup", gather_all_competition_ids=all_comp_info ))

• Or add by explicit URL (if not present or to disambiguate) print(all_comps.add_competition_to_my_watchlist( competition_name="", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/47/matches/premier-league" ))

• Minimal end-to-end run (MVP workflow) print(workflow_compute_mvp(competition_name="mls", competition_year="2025"))

• Custom scalar / title / percentile mvp = MVP() print(mvp.compute_mvp( competition_name="serie", competition_year="2024-2025", percentile_threshold=.97, title="Top 3% MVPs for Serie in 2024-2025" ))

• Split seasons (Apertura/Clausura) print(workflow_compute_mvp( competition_name="liga-mx", competition_year="2024-2025", open_close_league="Apertura" )) print(workflow_compute_mvp( competition_name="liga-mx", competition_year="2024-2025", open_close_league="Clausura" ))

• Resume runs (no override) print(workflow_compute_mvp( competition_name="canadian-championship", competition_year="2025", overide=False ))

• Manual competition id (disambiguate leagues)

  • Premier League (England) print(workflow_compute_mvp( competition_name="premier-league", competition_year="2016-2017", manual_competition_id="47" ))

  • Premier League (Canada) print(workflow_compute_mvp( competition_name="premier-league", competition_year="2019", manual_competition_id="9986" ))

Sample Code

Setup

• all_comps = AllCompetitions()
• all_comp_info = all_comps.gather_all_competition_ids("https://www.fotmob.com/")
• print(all_comp_info)

---

Add Competitions to Watchlist

International — Countries

• print(all_comps.add_competition_to_my_watchlist(competition_name="world-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/77/matches/world-cup"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="euro", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/50/matches/euro"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="copa-america", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/44/matches/copa-america"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="summer-olympics", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/66/matches/summer-olympics"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="concacaf-gold-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/298/matches/concacaf-gold-cup"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="concacaf-nations-league", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/9821/matches/concacaf-nations-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="uefa-nations-league-a", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/9806/matches/uefa-nations-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="uefa-nations-league-b", gather_all_competition_ids=all_comp_info))
• print(all_comps.add_competition_to_my_watchlist(competition_name="uefa-nations-league-c", gather_all_competition_ids=all_comp_info))
• print(all_comps.add_competition_to_my_watchlist(competition_name="uefa-nations-league-d", gather_all_competition_ids=all_comp_info))
• print(all_comps.add_competition_to_my_watchlist(competition_name="euro-qualification", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10607/matches/euro-qualification"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="world-cup-qualification-afc", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10197/matches/world-cup-qualification-afc"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="world-cup-qualification-caf", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10196/matches/world-cup-qualification-caf"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="world-cup-qualification-concacaf", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10198/matches/world-cup-qualification-concacaf"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="world-cup-qualification-conmebol", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10199/matches/world-cup-qualification-conmebol"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="uefa-nations-league-qualification", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10717/matches/uefa-nations-league-qualification"))

International — Clubs

• print(all_comps.add_competition_to_my_watchlist(competition_name="fifa-intercontinental-cup", gather_all_competition_ids=all_comp_info))
• print(all_comps.add_competition_to_my_watchlist(competition_name="fifa-club-world-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/78/matches/fifa-club-world-cup"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="champions-league", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/42/matches/champions-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="europa-league", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/73/matches/europa-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="conference-league", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10216/matches/conference-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="afc-champions-league-elite", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/525/matches/afc-champions-league-elite"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="concacaf-champions-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/297/matches/concacaf-champions-cup"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="copa-sudamericana", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/299/matches/copa-sudamericana"))

Countries

Austria

• print(all_comps.add_competition_to_my_watchlist(competition_name="bundesliga", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/38/matches/bundesliga"))

Canada

• print(all_comps.add_competition_to_my_watchlist(competition_name="canadian-championship", gather_all_competition_ids=all_comp_info))
• print(all_comps.add_competition_to_my_watchlist(competition_name="premier-league", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/9986/matches/premier-league"))

England

• print(all_comps.add_competition_to_my_watchlist(competition_name="", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/47/matches/premier-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="fa-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/132/matches/fa-cup"))

France

• print(all_comps.add_competition_to_my_watchlist(competition_name="ligue-1", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/53/matches/ligue-1"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="coupe-de-france", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/134/matches/coupe-de-france"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="trophee-des-champions", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/207/matches/trophee-des-champions"))

Germany

• print(all_comps.add_competition_to_my_watchlist(competition_name="bundesliga", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/54/matches/bundesliga"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="dfb-pokal", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/209/matches/dfb-pokal"))

Italy

• print(all_comps.add_competition_to_my_watchlist(competition_name="serie", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/55/matches/serie"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="coppa-italia", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/141/matches/coppa-italia"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="super-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/222/matches/super-cup"))

Mexico

• print(all_comps.add_competition_to_my_watchlist(competition_name="liga-mx", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/230/matches/liga-mx"))

Netherlands

• print(all_comps.add_competition_to_my_watchlist(competition_name="eredivisie", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/57/matches/eredivisie"))

Saudi Arabia

• print(all_comps.add_competition_to_my_watchlist(competition_name="saudi-pro-league", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/536/matches/saudi-pro-league"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="kings-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/9942/matches/kings-cup"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="super-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10074/matches/super-cup"))

Scotland

• print(all_comps.add_competition_to_my_watchlist(competition_name="premiership", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/64/matches/premiership"))

Spain

• print(all_comps.add_competition_to_my_watchlist(competition_name="laliga", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/87/matches/laliga"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="copa-del-rey", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/138/matches/copa-del-rey"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="super-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/139/matches/super-cup"))

USA

• print(all_comps.add_competition_to_my_watchlist(competition_name="mls", gather_all_competition_ids=all_comp_info))
• print(all_comps.add_competition_to_my_watchlist(competition_name="open-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/9441/matches/open-cup"))
• print(all_comps.add_competition_to_my_watchlist(competition_name="leagues-cup", gather_all_competition_ids=all_comp_info, defined_url="https://www.fotmob.com/leagues/10043/matches/leagues-cup"))

---

Run MVP Program

International — Countries

• print(workflow_compute_mvp(competition_name="world-cup", competition_year="2014", manual_competition_id="77", scalar=14))
• print(workflow_compute_mvp(competition_name="world-cup", competition_year="2018", manual_competition_id="77", scalar=14))
• print(workflow_compute_mvp(competition_name="world-cup", competition_year="2022", manual_competition_id="77", scalar=14))
• print(workflow_compute_mvp(competition_name="euro", competition_year="2016", scalar=14))
• print(workflow_compute_mvp(competition_name="euro", competition_year="2020", scalar=14))
• print(workflow_compute_mvp(competition_name="euro", competition_year="2024", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-america", competition_year="2016"))
• print(workflow_compute_mvp(competition_name="copa-america", competition_year="2019"))
• print(workflow_compute_mvp(competition_name="copa-america", competition_year="2021"))
• print(workflow_compute_mvp(competition_name="copa-america", competition_year="2024"))
• print(workflow_compute_mvp(competition_name="concacaf-gold-cup", competition_year="2025", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-nations-league", competition_year="2022-2023", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-nations-league", competition_year="2023-2024", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-nations-league", competition_year="2024-2025", scalar=14))

International — Clubs

• print(workflow_compute_mvp(competition_name="fifa-intercontinental-cup", competition_year="2024", scalar=14, overide=False, min_req_matches=False))
• print(workflow_compute_mvp(competition_name="fifa-club-world-cup", competition_year="2020", scalar=14))
• print(workflow_compute_mvp(competition_name="fifa-club-world-cup", competition_year="2021", scalar=14))
• print(workflow_compute_mvp(competition_name="fifa-club-world-cup", competition_year="2022", scalar=14))
• print(workflow_compute_mvp(competition_name="fifa-club-world-cup", competition_year="2023", scalar=14))
• print(workflow_compute_mvp(competition_name="fifa-club-world-cup", competition_year="2025", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2016-2017", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2017-2018", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2018-2019", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2019-2020", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2020-2021", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2021-2022", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2022-2023", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2023-2024", scalar=14))
• print(workflow_compute_mvp(competition_name="champions-league", competition_year="2024-2025", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2016-2017", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2017-2018", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2018-2019", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2019-2020", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2020-2021", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2021-2022", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2022-2023", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2023-2024", scalar=14))
• print(workflow_compute_mvp(competition_name="europa-league", competition_year="2024-2025", scalar=14))
• print(workflow_compute_mvp(competition_name="afc-champions-league-elite", competition_year="2020", scalar=14))
• print(workflow_compute_mvp(competition_name="afc-champions-league-elite", competition_year="2021", scalar=14))
• print(workflow_compute_mvp(competition_name="afc-champions-league-elite", competition_year="2022", scalar=14))
• print(workflow_compute_mvp(competition_name="afc-champions-league-elite", competition_year="2023-2024", scalar=14))
• print(workflow_compute_mvp(competition_name="afc-champions-league-elite", competition_year="2024-2025", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-champions-cup", competition_year="2020", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-champions-cup", competition_year="2021", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-champions-cup", competition_year="2022", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-champions-cup", competition_year="2023", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-champions-cup", competition_year="2024", scalar=14))
• print(workflow_compute_mvp(competition_name="concacaf-champions-cup", competition_year="2025", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-sudamericana", competition_year="2020", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-sudamericana", competition_year="2021", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-sudamericana", competition_year="2022", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-sudamericana", competition_year="2023", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-sudamericana", competition_year="2024", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-sudamericana", competition_year="2025", scalar=14))

USA

• print(workflow_compute_mvp(competition_name="mls", competition_year="2016", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2017", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2018", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2019", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2020", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2021", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2022", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2023", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2024", scalar=4))
• print(workflow_compute_mvp(competition_name="mls", competition_year="2025", scalar=4))
• print(workflow_compute_mvp(competition_name="leagues-cup", competition_year="2023", scalar=14))
• print(workflow_compute_mvp(competition_name="leagues-cup", competition_year="2024", scalar=14))
• print(workflow_compute_mvp(competition_name="leagues-cup", competition_year="2025", scalar=14))

Mexico — Liga MX (split seasons)

• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2020-2021", open_close_league="Apertura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2020-2021", open_close_league="Clausura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2021-2022", open_close_league="Apertura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2021-2022", open_close_league="Clausura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2022-2023", open_close_league="Apertura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2022-2023", open_close_league="Clausura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2023-2024", open_close_league="Apertura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2023-2024", open_close_league="Clausura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2024-2025", open_close_league="Apertura"))
• print(workflow_compute_mvp(competition_name="liga-mx", competition_year="2024-2025", open_close_league="Clausura"))

Scotland — Premiership

• print(workflow_compute_mvp(competition_name="premiership", competition_year="2020-2021", manual_competition_id="64"))
• print(workflow_compute_mvp(competition_name="premiership", competition_year="2021-2022", manual_competition_id="64"))
• print(workflow_compute_mvp(competition_name="premiership", competition_year="2022-2023", manual_competition_id="64"))
• print(workflow_compute_mvp(competition_name="premiership", competition_year="2023-2024", manual_competition_id="64"))
• print(workflow_compute_mvp(competition_name="premiership", competition_year="2024-2025", manual_competition_id="64"))

Spain — Super Cup & Copa del Rey

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2019-2020", scalar=14, manual_competition_id="139"))
• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2020-2021", scalar=14, manual_competition_id="139"))
• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2021-2022", scalar=14, manual_competition_id="139"))
• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2022-2023", scalar=14, manual_competition_id="139"))
• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2023-2024", scalar=14, manual_competition_id="139"))
• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2024-2025", scalar=14, manual_competition_id="139"))
• print(workflow_compute_mvp(competition_name="copa-del-rey", competition_year="2021-2022", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-del-rey", competition_year="2022-2023", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-del-rey", competition_year="2023-2024", scalar=14))
• print(workflow_compute_mvp(competition_name="copa-del-rey", competition_year="2024-2025", scalar=14))

Italy — Super Cup & Coppa Italia

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2019-2020", scalar=14, manual_competition_id="222"))

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2020-2021", scalar=14, manual_competition_id="222"))

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2021-2022", scalar=14, manual_competition_id="222"))

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2022-2023", scalar=14, manual_competition_id="222"))

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2023-2024", scalar=14, manual_competition_id="222"))

• print(workflow_compute_mvp(competition_name="super-cup", competition_year="2024-2025", scalar=14, manual_competition_id="222"))

• print(workflow_compute_mvp(competition_name="coppa-italia", competition_year="2020-2021", scalar=14))

• print(workflow_compute_mvp(competition_name="coppa-italia", competition_year="2021-2022", scalar=14))

• print(workflow_compute_mvp(competition_name="coppa-italia", competition_year="2022-2023", scalar=14))

• print(workflow_compute_mvp(competition_name="coppa-italia", competition_year="2023-2024", scalar=14))

• print(workflow_compute_mvp(competition_name="coppa-italia", competition_year="2024-2025", scalar=14))

  • Step-by-Step

    • List all available competitions (Note: if a competition is not available, include a defined_url arguement)

      • all_comps = AllCompetitions()
      • all_comp_info = all_comps.gather_all_competition_ids("https://www.fotmob.com/") # run
      • print(all_comp_info)

    • Chooses the competition

      • comps = Competition()
      • print(comps.choose_competition(competition_name="mls", competition_year="2023"))

    • Test this out later to extract player info from new html setup

      • match = Match()
      • print(match.extract_single_match_players_stats("https://www.fotmob.com/matches/toronto-fc-vs-fc-cincinnati/3vaemjyi#4085040"))
      • print(match.choose_match(competition_name="mls", competition_year="2023"))

    • Extract player stats and compute both the total of games played and average SPI score for only games with SPI scores included.

      • player = Player()
      • print(player.choose_player_stats(competition_name="mls", competition_year="2023"))
      • print(player.competition_analysis(competition_name="mls", competition_year="2023"))

    • Runs all the steps above

      • mvp = MVP()
      • print(mvp.compute_mvp(competition_name="mls", competition_year="2023", scalar=4))

Example Output

How a Player Receives an SPI Score:

Only players who receive an SPI score are considered to have officially played in a match. While the exact time required for a score isn't fully confirmed, starting players typically need to play just a few minutes to earn an SPI for that match. On the other hand, substitutes must play for approximately 10 minutes to qualify for a score.

Substitute players who play less than the required time or those who are injured shortly after entering the game will not receive an SPI score. Initially, I considered assigning a default starting score (likely around 6.0 or 7.0, which is what I think a player starts off anyways) to any competitor who participated in the match but didn’t earn a score. However, this approach raised concerns: for instance, a player who scores a goal and one who concedes an own-goal would both receive the same starting score, which seems inappropriate.

To maintain consistency, this MVP program will only consider a match as "played" if a player has been assigned an SPI rating.

The FotMob player rating is calculated based on more than 100 individual stats per player per match

---

All Competition names and ids (i.e. all_comp_info):

{'38': 'bundesliga', '40': 'first-division-a', '42': 'champions-league', '43': 'confederation-cup', '44': 'copa-america', '45': 'copa-libertadores', '46': 'superligaen', '48': 'championship', '50': 'euro', '51': 'veikkausliiga', '57': 'eredivisie', '58': 'eredivisie', '64': 'premiership', '65': 'summer-olympics-women', '66': 'summer-olympics', '68': 'allsvenskan', '69': 'super-league', '73': 'europa-league', '85': '1-division', '86': 'serie-b', '108': 'league-one', '109': 'league-two', '112': 'liga-profesional', '113': 'a-league', '114': 'friendlies', '116': 'cymru-premier', '117': 'national-league', '119': '2-liga', '120': 'super-league', '121': 'primera-division', '122': '1-liga', '123': 'championship', '124': 'league-one', '125': 'league-two', '127': 'ligat-haal', '128': 'leumit-league', '129': 'premiership', '130': 'mls', '131': 'liga-1', '132': 'fa-cup', '135': 'super-league-1', '136': '1-division', '137': 'scottish-cup', '140': 'laliga2', '141': 'coppa-italia', '142': 'efl-trophy', '143': 'suomen-cup', '144': 'primera-division', '145': 'greece-cup', '147': 'serie-c', '150': 'coupe-de-la-ligue', '151': 'turkish-cup', '161': 'primera-division', '163': 'challenge-league', '169': 'ettan', '171': 'svenska-cupen', '176': '1-liga', '179': 'challenge-cup', '180': 'league-cup', '181': 'premiership-playoff', '182': 'super-liga', '187': 'league-cup', '189': 'liga-i', '190': 'cupa-româniei', '193': 'russian-cup', '196': 'ekstraklasa', '199': 'division-profesional', '204': 'postnord-ligaen', '205': 'norsk-tipping-ligaen', '207': 'trophée-des-champions', '209': 'dfb-pokal', '215': 'besta-deildin', '217': 'icelandic-cup', '218': 'first-division', '224': 'j-league-cup', '225': 'premier-league', '230': 'liga-mx', '231': 'national-division', '239': '2-division', '240': '3-division', '241': 'danmarksserien', '246': 'serie-a', '251': 'ykkosliiga', '256': 'kvindeligaen', '263': 'premier-league', '264': 'first-division-b', '267': 'premier-league', '270': 'first-professional-league', '273': 'primera-division', '274': 'categoría-primera-a', '287': 'euro-u19', '288': 'euro-u21', '290': 'asian-cup', '292': "women's-euro", '293': "women's-friendlies", '297': 'concacaf-champions-cup', '298': 'concacaf-gold-cup', '299': 'copa-sudamericana', '300': 'east-asian-championship', '301': 'european-championship-u-17', '305': 'toulon-tournament', '329': 'gulf-cup', '331': 'toppserien', '332': '1-division-kvinner', '335': 'primera-division', '336': 'liga-nacional', '337': 'liga-nacional', '338': '1-division', '339': 'primera-division', '342': 'finland-cup', '441': 'premier-league', '489': 'club-friendlies', '512': 'regionalliga', '519': 'premier-league', '524': 'stars-league', '525': 'afc-champions-league-elite', '526': 'caf-champions-league', '529': 'premier-league', '533': 'professional-football-league', '537': 'premier-soccer-league', '544': 'ligue-i', '8815': 'super-league-2', '8870': 'championship', '8944': 'national-north-&-south', '8947': 'premier-division', '8965': 'primera-b-nacional', '8968': 'primera-federación', '8969': 'ykkonen', '8971': 'serie-c', '8973': '2-liga', '8974': 'j-league-2', '8976': 'liga-de-expansión-mx', '8980': 'brazil-state-championship', '9015': 'liga-primera', '9039': 'lpf', '9080': 'k-league-1', '9081': 'bundesliga', '9100': '2-division', '9112': 'liga-3', '9113': 'liga-ii', '9116': 'k-league-2', '9122': 'segunda-division', '9123': 'second-league', '9125': 'primera-b', '9126': 'primera-b', '9134': 'nwsl', '9137': 'china-league-one', '9138': 'segunda-federación', '9141': 'germany-5', '9143': 'singapore-cup', '9210': 'france-4', '9213': 'primera-b-metropolitana-&-torneo-federal-a', '9253': 'fa-trophy', '9265': 'asean-championship', '9294': "women's-championship", '9296': 'usl-league-one', '9305': 'copa-argentina', '9306': 'cecafa-cup', '9345': 'copa-mx', '9375': "women's-champions-league", '9382': 'toppserien-qualification', '9390': 'west-asian-championship', '9391': 'copa-mx-clausura', '9408': 'international-champions-cup', '9422': 'k-league', '9428': 'african-nations-championship', '9429': 'copa-do-nordeste', '9441': 'open-cup', '9468': 'caf-confed-cup', '9469': 'afc-champions-league-two', '9470': 'afc-challenge-league', '9474': 'mtn8', '9478': 'indian-super-league', '9494': 'usl-league-two', '9495': 'a-league-women', '9500': 'we-league-women', '9514': 'the-atlantic-cup', '9537': 'k-league-3', '9545': 'highland-/-lowland', '9579': 'algarve-cup-qualification', '9656': 'concacaf-championship-u20', '9682': 'concacaf-central-american-cup', '9690': 'southeast-asian-games', '9717': "women's-league-cup", '9741': 'uefa-youth-league', '9754': 'obos-ligaen', '9806': 'uefa-nations-league-a', '9807': 'uefa-nations-league-b', '9808': 'uefa-nations-league-c', '9809': 'uefa-nations-league-d', '9821': 'concacaf-nations-league', '9833': 'asian-games', '9837': 'canadian-championship', '9841': 'afc-u20-asian-cup', '9876': 'saff-championship', '9906': 'liga-mx-femenil', '9907': 'liga-f', '9921': 'shebelieves-cup-qualification', '9986': 'premier-league', '10007': 'copa-de-la-liga-profesional', '10022': 'regionalliga', '10043': 'leagues-cup', '10046': 'copa-ecuador', '10056': 'liga-2', '10075': 'torneo-de-verano', '10076': 'league-cup', '10082': 'fa-cup-women', '10084': 'nisa', '10145': 'footballs-staying-home-cup-(esports)', '10167': 'nwsl-challenge-cup', '10176': 'premier-league-2-div-2', '10178': 'serie-a-femminile', '10188': 'k-league-3', '10207': 'nisa-legends-cup', '10216': 'conference-league', '10242': 'fifa-arab-cup', '10244': 'paulista-a1', '10269': 'womens-asian-cup', '10270': 'league-cup', '10272': 'carioca', '10273': 'mineiro', '10274': 'gaúcho', '10290': 'baiano', '10291': 'goiano', '10304': 'finalissima', '10309': 'durand-cup', '10310': 'stars-league-relegation-playoff', '10325': 'preseason', '10366': 'super-cup', '10368': 'copa-america-femenina', '10437': 'euro-u-21', '10449': 'nacional-feminino', '10457': "uefa-women's-nations-league-a", '10458': 'uefa-nations-league-b-women', '10459': 'uefa-nations-league-c-women', '10474': 'arab-club-champions-cup', '10498': 'summer-olympics-concacaf-qualification', '10508': 'african-football-league', '10511': 'afc-summer-olympics-women', '10584': 'south-africa-league', '10603': 'concacaf-gold-cup-women', '10607': 'euro', '10609': 'asian-cup--playoff', '10610': 'concafaf-gold-cup', '10611': 'champions-league', '10612': "women's-champions-league", '10613': 'europa-league', '10615': 'conference-league', '10616': 'euro-u19', '10617': 'euro-u17', '10618': 'copa-libertadores', '10619': 'caf-champions-league', '10621': 'concacaf-championship-u20', '10622': 'afc-champions-league-elite', '10623': 'copa-sudamericana', '10640': "women's-euro-league-a", '10641': "women's-euro-league-b", '10642': "women's-euro-league-c", '10649': 'nwsl-x-liga-mx', '10651': 'copa-de-la-reina', '10654': 'usl-jägermeister-cup', '10699': 'usl-super-league-women', '10703': 'fifa-intercontinental-cup', '10705': 'national-league-cup', '10708': 'knockout-cup', '10717': 'uefa-nations-league-a', '10718': 'uefa-nations-league-b', '10719': 'uefa-nations-league-c', '10791': 'swpl-1', '10840': 'baller-league', '10844': 'baller-league', '10872': 'northern-super-league'}

---

Resource:

• (Fotmob Homepage) - /https://www.fotmob.com/

• (Install Pyspark) - /https://medium.com/@jpurrutia95/install-and-set-up-pyspark-in-5-minutes-m1-mac-eb415fe623f3/

---

Potential Contributions:

• Add an option for storing results in a Cloud data storage

Possibilites to optimize the MVP algorithm

• Add more weighted features:
  • players
    • avg spi for all (or specific) competitions
    • avg spi from past N years/months/weeks/games
  • teams
  • leagues or tournaments
  • countries
  • continents
  • match type
    • e.g.
      • "finalTournament":"Final","bronzeFinal":"Bronze-final","semifinal":"Semi-final","quarterfinal":"Quarter-final","roundof16":"Round of 16","h2h":"Head-to-Head","bracket":"Bracket"

---

Made by Drue Tomas Staples