machina-sports/sports-skills

fastf1

Formula 1 data — race schedules, results, lap timing, driver and team info.

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/machina-sports/sports-skills --skill fastf1

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

FastF1 — Formula 1 Data

Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes.

Quick Start

Prefer the CLI — it avoids Python import path issues:

bash
sports-skills f1 get_race_schedule --year=2025
sports-skills f1 get_race_results --year=2025 --event=Monza

Python SDK (alternative):

python
from sports_skills import f1

schedule = f1.get_race_schedule(year=2025)
results = f1.get_race_results(year=2025, event="Monza")

CRITICAL: Before Any Query

CRITICAL: Before calling any data endpoint, verify:

  • Year is derived from the system prompt's currentDate — never hardcoded.
  • In January or February, use year = current_year - 1 (pre-season; the new F1 season has not started yet).

Choosing the Year

Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-16 → current year is 2026).

  • If the user specifies a year, use it as-is.
  • If the user says "latest", "recent", "last season", or doesn't specify: The F1 season runs roughly March–December. If the current month is January or February, use year = current_year - 1. From March onward, use the current year.

Workflows

Race Weekend Analysis

  1. get_race_schedule --year=<year> — find the event name and date
  2. get_race_results --year=<year> --event=<name> — final classification (positions, times, points)
  3. get_lap_data --year=<year> --event=<name> --session_type=R — lap-by-lap pace analysis
  4. get_tire_analysis --year=<year> --event=<name> — strategy breakdown (compounds, stint lengths, degradation)

Driver/Team Comparison

  1. get_championship_standings --year=<year> — championship context (points, wins, podiums)
  2. get_team_comparison --year=<year> --team1=<t1> --team2=<t2> OR get_driver_comparison --year=<year> --driver1=<d1> --driver2=<d2>
  3. get_season_stats --year=<year> — aggregate performance (fastest laps, top speeds)

Season Overview

  1. get_race_schedule --year=<year> — full calendar with dates and circuits
  2. get_championship_standings --year=<year> — driver and constructor standings
  3. get_season_stats --year=<year> — season-wide fastest laps, top speeds, points leaders
  4. get_driver_info --year=<year> — current grid (driver numbers, teams, nationalities)

Commands

CommandDescription
get_race_scheduleFull season calendar with dates and circuits
get_race_resultsFinal race classification (positions, times, points)
get_session_dataRaw session info (Q, FP1, FP2, FP3, R)
get_driver_infoDriver details from the grid
get_team_infoTeam info with driver lineup
get_lap_dataLap-by-lap timing with sectors and tire data
get_pit_stopsPit stops with pit-lane time (not stationary time) and team averages
get_speed_dataSpeed trap and intermediate speed data
get_championship_standingsDriver and constructor championship standings (--round=N for standings after round N)
get_season_statsAggregate season performance
get_team_comparisonTeam head-to-head: qualifying, race pace, sectors
get_driver_comparisonDriver head-to-head: qualifying H2H, race H2H, pace delta
get_tire_analysisTire strategy, stint lengths, degradation rates

See references/api-reference.md for full parameter lists and return shapes.

Examples

Example 1: F1 calendar User says: "Show me the F1 calendar" Actions:

  1. Derive year from currentDate
  2. Call get_race_schedule(year=<derived_year>)

Result: Full calendar with event names, dates, and circuits

Example 2: Driver race performance User says: "How did Verstappen do at Monza?" Actions:

  1. Derive year from currentDate (or from context)
  2. Call get_race_results(year=<year>, event="Monza") for final classification
  3. Call get_lap_data(year=<year>, event="Monza", session_type="R", driver="VER") for lap times

Result: Finishing position, gap to leader, fastest lap, and tire strategy

Example 3: Latest results queried in pre-season User says: "What were the latest F1 results?" (asked in February 2026) Actions:

  1. Current month is February → season not yet started → use year = 2025
  2. Call get_race_schedule(year=2025) to find the last event of that season
  3. Call get_race_results(year=2025, event=<last_event>) for the final race results

Result: Results of the final 2025 race

Commands that DO NOT exist — never call these

  • ~~get_qualifying~~ / ~~get_practice~~ — does not exist. Use get_session_data with session_type="Q" for qualifying or session_type="FP1"/"FP2"/"FP3" for practice.
  • ~~get_standings~~ — does not exist. Use get_championship_standings instead.
  • ~~get_results~~ — does not exist. Use get_race_results instead.
  • ~~get_calendar~~ — does not exist. Use get_race_schedule instead.

If a command is not listed in the Commands table above, it does not exist.

Troubleshooting

Error: Event name not found Cause: Event name spelling does not match FastF1's internal naming Solution: Call get_race_schedule(year=<year>) first to get the exact event names, then retry with the correct name

Error: Session data is empty Cause: The session has not happened yet Solution: FastF1 only returns data for completed sessions. Check get_race_schedule for when the session is scheduled

Error: get_race_results returns no fastest_lap_time Cause: FastF1 has no lap data for that race (fastest_lap_time is computed from the laps) Solution: Use get_lap_data(session_type="R") and find the minimum lap_time across all drivers

Error: Querying the current year in January or February returns no data Cause: The new F1 season has not started yet Solution: Use year = current_year - 1 for any pre-March query; do not query the current year before March

Verwandte Aufgaben

aus demselben Repository

Weitere Skills

Alle Skills
machina-sports
Community

cricket-data

Cricket data via ESPN public endpoints and Cricsheet open data — live-ish series scoreboards, standings, match summaries and news (ESPN), plus historical ball-by-ball, player stats, and player registry (Cricsheet, ODC-BY 1.0). Zero config, no API keys. Use when: user asks about cricket scores, IPL/BBL/PSL/international series, points tables, match details, cricket news, ball-by-ball history, or player career stats. Don't use when: user asks about other sports — use football-data (soccer), nfl-da

Installationen / 1h
1
GitHub Stars
273
Aktualisiert
20. Nov.
machina-sports
Community

sports-news

Sports news via RSS/Atom feeds and Google News. Fetch headlines, search by query, filter by date. Covers football news, transfer rumors, match reports, and any sport via Google News. Use when: user asks for recent news, headlines, transfer rumors, or articles about any sport. Good for "what's the latest on [team/player]" questions. Supports any Google News query and curated RSS feeds (BBC Sport, ESPN, The Athletic, Sky Sports). Don't use when: user asks for structured data like standings, scores

Installationen / 1h
2
GitHub Stars
270
Aktualisiert
14. Nov.
machina-sports
Community

football-data

Football (soccer) data — standings, schedules, match stats, xG, transfers, player profiles, head-to-head, Elo, and forecasts. No API keys. Covers Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Champions League, World Cup, and more (see getcompetitions). Use when: user asks about soccer standings, fixtures, match stats, xG, lineups, transfers, player values or profiles, injuries, head-to-head, Elo ratings, or match forecasts. Don't use when: user asks about American football/NFL (use

Installationen / 1h
1
GitHub Stars
270
Aktualisiert
12. Nov.
machina-sports
Community

mlb-data

MLB data via ESPN public endpoints and the official MLB Stats API — scores, standings, rosters, schedules, game summaries, injuries, leaders, and news, plus an analytics backend: pitch-level velocity/spin/exit-velocity, career splits by stat group, league leaders, and schedules to 1901. Zero config, no API keys. Use when: user asks about MLB scores, standings, team rosters, schedules, game stats, box scores, play-by-play, injuries, transactions, depth charts, team/player statistics, MLB news, pi

Installationen / 1h
1
GitHub Stars
269
Aktualisiert
10. Nov.