stackgate.ai
Alle integrationer
API-Football

Football

Hent fodboldkampe, livescore, ligaer, stillinger, hold, spillere, opstillinger, begivenheder, statistik, skader og transfers via MCP.

Manual setup 23 værktøjer

Overblik

Forbind Football, så AI-klienter kan hente fodboldkonkurrencer, hold, spillere, kampe, livescore, stillinger, opstillinger, begivenheder, statistik, skader, transfers, baner og trænere.

stackgate.ai gemmer din API-Sports (API-Football) API-nøgle krypteret og kalder udbyderen på dine vegne. Værktøjsresultater returneres til din AI-klient for den pågældende forespørgsel. Svar caches kortvarigt i hubben (pr. forbindelse) for at mindske dubletter og beskytte din daglige kvote.

Integrationen er read-only. Offentlige værktøjsnavne og svarformer er udbyderneutrale; den første upstream-udbyder er API-Football fra API-Sports.

Forudsætninger

Credentials

  1. Log ind på stackgate.ai.
  2. Gå til Mine integrationer og åbn Football.
  3. I en separat fane, åbn API-Football dashboard.
  4. Gå til Account → My Access og kopiér din API-nøgle.
  5. Indsæt nøglen i stackgate.ai, og klik Gem.
  6. stackgate.ai kører en let connection test (/status). Ved succes kan du se plannavn og daglig request-grænse.
  7. Brug eventuelt Edit tool access til at begrænse, hvilke læseværktøjer forbindelsen må bruge.

Brug dashboard-nøgler til https://v3.football.api-sports.io (header x-apisports-key). RapidAPI host/key-par understøttes ikke.

Behandl API-nøglen som en adgangskode. Generér en ny i API-Sports dashboard, hvis den bliver eksponeret.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/football med Sanctum bearer token
  • Private gateway: én config til alle integrationer — brug football__*-navngivne værktøjer

Se Dokumentation for HTTP-autentificering og opsætning af private gateway.

Eksempelprompts

  • Vis den aktuelle Premier League-stilling.
  • Find Liverpools næste fem kampe.
  • Hvem er topscorerne i den aktuelle Bundesliga-sæson?
  • Vis opstilling og begivenheder fra kamp 12345.
  • Find information om Christian Eriksen.
  • Sammenlign de seneste kampe mellem Arsenal og Chelsea.
  • Hvilke kampe er live lige nu?
  • Vis spillerne i FC Københavns aktuelle trup.

Foreslået workflow

  1. search_competitions — find competition_id (Premier League er ofte 39).
  2. get_standings / search_fixtures — mange forespørgsler kræver season som ÅÅÅÅ.
  3. get_live_fixtures — kun igangværende kampe.
  4. get_fixture — oversigt; brug events/lineups/statistik-værktøjer til detaljer.
  5. search_teams / search_players — derefter get-værktøjer til profiler.

Paginering

Hvor udbyderen paginerer (fx spillere), brug page og eventuelt limit. Svar indeholder pagination med page, total_pages, total_results og has_more. Hubben henter ikke automatisk alle sider.

Caching og friskhed

Omtrentlige cache-tider i hubben (pr. forbindelse):

Data Cache
Konkurrencer / sæsoner ~24 timer
Hold / baner / trænere ~12 timer
Spillere ~6 timer
Trupper ~3 timer
Stillinger / kommende kampe ~10 minutter
Afsluttede kampe ~24 timer
Live kampe / events ~20 sekunder
Opstillinger ~2 minutter
Skader ~30 minutter
Transfers ~3 timer

Autentificeringsfejl caches aldrig. Livescore kan være lidt forsinket pga. kort cache.

Rate limits

API-Football-planer har en daglig request-kvote og et pr. minut-loft. Free-planer er ofte omkring 100 requests/dag. Foretræk cachede værktøjer, konkrete ID'er og små datovinduer. En 429 eller “request limit”-fejl betyder: vent, eller opgrader din API-Sports-plan.

Data-licens

stackgate.ai giver adgang til data returneret af den forbundne udbyder. Tilgængelighed og tilladt brug afhænger af udbyderens vilkår og dit abonnement. En gratis API-plan giver ikke ubegrænsede redistributionsrettigheder. Klublogoer, spillerfotos, bane-billeder og konkurrencebranding kan have separate rettighedsbegrænsninger. Du er ansvarlig for, at brugen overholder udbyderens vilkår og gældende rettigheder. Behandl ikke dataene som open source eller frit redistribuerbare.

Fejlfinding

  • 422 integration not configured — tilføj din API-Sports API-nøgle i Mine integrationer.
  • Connection test failed / invalid key — bekræft nøglen fra Account → My Access på API-Football dashboard (ikke en RapidAPI-nøgle).
  • 401 / authentication failed — generér en ny nøgle og opdater Mine integrationer.
  • 429 / request limit — du har ramt udbyderkvoten; vent, reducer kald, eller opgrader planen.
  • Tomme items — ingen match for filtre/sæson, eller din plan dækker ikke konkurrencen/sæsonen.
  • season required — mange spiller-/hold-/stilling-forespørgsler kræver et sæsonår (ÅÅÅÅ).
  • Billeder — logo-/foto-URL'er er tredjepartsmedier; de kan kræve attribution eller have brugsbegrænsninger.

Tilgængelige værktøjer

  • search_competitions

    Søg ligaer og turneringer; find competition_id og sæsoner.

  • get_competition_seasons

    List available seasons for a competition, including date ranges and coverage. Use after search_competitions when you need season years.

  • search_teams

    Search football teams by name, ID, competition+season, country, or venue. Requires at least one filter. Do not use for squads or fixtures.

  • get_team

    Get a normalized team profile including venue details when available.

  • get_team_squad

    List the current squad for a team (players, numbers, positions). Prefer this over searching every player individually.

  • search_players

    Search players by name, ID, team, or competition. Season is required for most searches. Use get_player for a single profile.

  • get_player

    Get a normalized player profile. Pass season when you need season-specific team/position context.

  • get_player_statistics

    Season statistics for a player (goals, assists, minutes, cards, etc.). Requires player_id and season.

  • search_fixtures

    Søg kampe efter dato, hold, liga eller status.

  • get_live_fixtures

    Vis igangværende kampe.

  • get_fixture

    Hent oversigt for én kamp.

  • get_fixture_events

    Match events (goals, cards, substitutions, VAR) sorted chronologically.

  • get_fixture_lineups

    Starting elevens, substitutes, formations, and coaches for a fixture.

  • get_fixture_statistics

    Team-level match statistics (possession, shots, passes, cards, etc.). Values keep original units/labels.

  • get_fixture_player_statistics

    Per-player performance statistics for a fixture.

  • get_standings

    Hent stillingen for en konkurrence og sæson.

  • get_top_scorers

    Top scorers for a competition season.

  • get_top_assists

    Top assists for a competition season.

  • get_injuries

    Player injuries/sidelined status. Requires at least one filter (team, player, competition+season, fixture, or date).

  • get_transfers

    Transfer history for exactly one player_id or team_id. Newest first.

  • get_head_to_head

    Historical fixtures between two teams. Prefer this over search-fixtures when comparing two clubs.

  • search_venues

    Search stadiums/venues by name, ID, city, or country.

  • search_coaches

    Search coaches by name, ID, or current team. Includes career history when available.

MCP-endpoint: https://stackgate.ai/mcp/football (HTTP) eller via private gateway.

Opret konto Dokumentation