Formula 1
Hent Formula 1-løb, kalender, baner, kørere, konstruktører, resultater, startgrids, pitstop og mesterskabsstillinger via MCP.
Oversigt
Forbind Formula 1, så AI-klienter kan hente løb, kalender, baner, kørere, konstruktører, resultater, startgrids, pitstop og mesterskabsstillinger.
stackgate.ai gemmer din API-Sports Formula-1 API-nøgle krypteret og kalder udbyderen på dine vegne. Værktøjssvar returneres til din AI-klient for den pågældende forespørgsel. Svar caches kortvarigt på hubben (pr. forbindelse) for at reducere dobbelte upstream-kald og beskytte din daglige kvote.
Integrationen er read-only. Offentlige værktøjsnavne og svarformer er udbyderneutrale; den første upstream er API-Sports Formula-1.
Forudsætninger
- En API-Sports-konto med Formula-1-adgang og en API-nøgle
- En stackgate.ai-konto
Sådan henter du legitimationsoplysninger
- Log ind på stackgate.ai.
- Gå til Mine integrationer og åbn Formula 1.
- Åbn API-Sports-dashboardet i en anden fane.
- Bekræft at dit abonnement inkluderer Formula-1, gå til Account → My Access, og kopier API-nøglen.
- Indsæt nøglen i stackgate.ai og klik Gem.
- stackgate.ai kører en let forbindelsestest (
/status). Ved succes kan du se planen og den daglige request-grænse. - Brug eventuelt Rediger værktøjsadgang til at begrænse hvilke read-værktøjer forbindelsen må bruge.
Brug dashboard-nøgler til https://v1.formula-1.api-sports.io (header x-apisports-key). RapidAPI host/key-par understøttes ikke. En Football-only Free-plan giver ikke nødvendigvis Formula-1-adgang.
Behandl API-nøglen som en adgangskode. Regenerér den i API-Sports-dashboardet, hvis den kompromitteres.
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/formula-1med et Sanctum bearer-token - Privat gateway: én konfiguration til alle integrationer — brug
formula-1__*-værktøjer
Se Dokumentation for HTTP-godkendelse og privat gateway-setup.
Eksempelprompts
- Vis den aktuelle Formula 1-kørerstilling.
- Hvornår er næste løbsweekend?
- Hvem vandt det seneste løb, og hvad var resultatlisten?
- Vis Max Verstappens profil.
- List baner i Italien.
- Hvad var startgrid for race 1530?
- Vis konstruktørstillingen for 2024-sæsonen.
- List pitstop fra det seneste Grand Prix.
Anbefalet arbejdsgang
list_seasons/search_competitions— find sæson og konkurrence.search_races— kalender og sessioner (typekan være Race, qualifying, Sprint m.m.).get_race— oversigt; brug rankings/grid/fastest-laps/pit-stops for detaljer.get_driver_standings/get_constructor_standings— mesterskaber.search_drivers/search_teams/search_circuits— derefter get-værktøjer til profiler.
Caching og friskhed
Omtrentlige hub-cache-tider (pr. forbindelse):
| Data | Cache |
|---|---|
| Konkurrencer / sæsoner | ~24 timer |
| Baner / hold | ~12 timer |
| Kørere | ~6 timer |
| Løbskalender | ~10 minutter |
| Afsluttet løbsoversigt | ~24 timer |
| Stillinger | ~10 minutter |
| Resultater / grid / pitstop | ~2 minutter |
Godkendelsesfejl caches aldrig.
Rate limits
API-Sports Formula-1-planer har en daglig request-kvote og en pr. minut-grænse. Foretræk cachede værktøjer og specifikke ID'er. En 429 eller “request limit”-fejl betyder vent eller opgrader planen.
Bemærkning om datarettigheder
stackgate.ai giver adgang til data fra den forbundne udbyder. Tilgængelighed og tilladt brug afhænger af udbyderens vilkår og dit abonnement. Officiel Formula 1-branding, logoer og medier kan have særskilte rettighedsbegrænsninger. Du er ansvarlig for at sikre, at brugen overholder udbyderens vilkår og gældende rettigheder.
Fejlfinding
- 422 integration not configured — tilføj din API-Sports Formula-1 API-nøgle under Mine integrationer.
- Connection test failed / invalid key — bekræft nøglen fra Account → My Access, og at Formula-1 er på planen (ikke RapidAPI).
- 401 / authentication failed — regenerér nøglen og opdater Mine integrationer.
- 429 / request limit — du har ramt kvoten; vent, reducer kald, eller opgrader.
- Empty items — ingen matchende data for filtrene/sæsonen, eller planen dækker ikke sæsonen.
- season required — stillinger og mange race-forespørgsler kræver et sæsonår (YYYY).
Tilgængelige værktøjer
-
search_competitions
Search Formula 1 competitions. Use when you need a competition_id.
-
list_seasons
List available Formula 1 seasons (years). Optionally filter by competition_id.
-
search_circuits
Search Formula 1 circuits by name, ID, or country. Requires at least one filter.
-
get_circuit
Get a normalized circuit profile (length, laps, lap record, capacity).
-
search_teams
Search Formula 1 constructors/teams. Requires at least one filter.
-
get_team
Get a normalized constructor/team profile.
-
search_drivers
Søg kørere efter navn, ID eller hold.
-
get_driver
Get a normalized driver profile (career stats, nationality, number).
-
search_races
Søg løb og sessioner efter sæson, type, bane eller dato.
-
get_race
Get a single race/session summary. Use dedicated tools for rankings, grid, fastest laps, or pit stops.
-
get_race_rankings
Hent resultatlisten for et løb.
-
get_starting_grid
Starting grid for a race.
-
get_fastest_laps
Fastest laps ranking for a race.
-
get_pit_stops
Pit stops for a race.
-
get_driver_standings
Hent kørermesterskabet for en sæson.
-
get_constructor_standings
Hent konstruktørmesterskabet for en sæson.
MCP-endpoint:
https://stackgate.ai/mcp/formula-1
(HTTP) eller via
private gateway.