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

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Show me the current Premier League standings.

  • When does Liverpool play next, and who is injured?

  • Did Brøndby ever get a result against Copenhagen this season?

  • Who are the top scorers in the Superliga right now?

  • Write a short match preview for Saturday - do not treat it as a bet.

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 ÅÅÅÅ (startår).
  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. Brug kun bogstaver, tal og mellemrum i navnesøgning.

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 (ÅÅÅÅ, startår). Free API-Sports-planer dækker typisk 2022-2024.
  • Navnesøgning - query må kun bruge bogstaver, tal og mellemrum (Manchester United, ikke Man-Utd eller F.C. Barcelona). Bindestreger og punktummer strippes automatisk.
  • query + country - kombiner ikke navnesøgning med landefilter.
  • search_players - navnesøgning kræver team_id eller competition_id plus season. Foretræk get_team_squad til at liste en klub.
  • last fixtures - parameteren last er ofte kun på betalte planer; brug date eller team_id plus season.
  • 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 every available season year, date range, and coverage flag for one competition. Use after search_competitions when you need a valid season YYYY.

  • search_teams

    Find a team_id by club name, ID, league+season, country, or venue. Requires at least one filter. Do not use for squads (get_team_squad) or fixtures. Name search cannot be combined with country or venue_id.

  • get_team

    Get one club profile (name, country, founded, venue). Requires team_id from search_teams.

  • get_team_squad

    List the current squad (player_id, number, position) for a club. Prefer this over search_players when you need everyone at a team.

  • search_players

    Find a player_id. Name search requires query plus team_id or competition_id plus season. For a known ID use player_id. Prefer get_team_squad to list a club.

  • get_player

    Get one player profile (name, nationality, position, club). Requires player_id and season. Club is chosen from the season row with the most club minutes, not the first international competition.

  • get_player_statistics

    Season stats for one player (goals, assists, minutes, cards) split by competition. Requires player_id and season. Optionally filter to one club or league.

  • 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

    Goals, cards, substitutions, and VAR for one match, sorted by minute. Requires fixture_id. Optional filters narrow the list.

  • get_fixture_lineups

    Starting elevens, substitutes, formation, and coach for one match. Requires fixture_id. Usually available close to kickoff.

  • get_fixture_statistics

    Team-level match stats (possession, shots, passes, cards, xG when available). Requires fixture_id. Best after the match has started or finished.

  • get_fixture_player_statistics

    Per-player match stats (minutes, rating, shots, passes). Requires fixture_id. Large payload; pass team_id or player_id when you only need one side or one player.

  • get_standings

    Hent stillingen for en konkurrence og sæson.

  • get_top_scorers

    Top goalscorers for a competition season, including goals, assists, appearances, and minutes. Requires competition_id and season.

  • get_top_assists

    Top assist providers for a competition season, including assists, goals, appearances, and minutes. Requires competition_id and season.

  • get_injuries

    Injured or sidelined players. Prefer date=today (YYYY-MM-DD) for current status. team_id/player_id/competition_id without date require season and can return a large season history (capped by limit, default 25).

  • get_transfers

    Transfer history, newest first. Pass exactly one of player_id or team_id. Club histories are large; default limit is 20. Prefer player_id for a single career.

  • get_head_to_head

    Historical matches between two clubs. Requires both team IDs. Prefer season over last (last is often paid-only). Do not use search_fixtures for two-team history.

  • search_venues

    Find a stadium/venue_id by name, ID, city, or country. Name search allows letters, numbers, and spaces only (Wembley Stadium).

  • search_coaches

    Find a coach by last name, coach_id, or current team_id. Prefer last name only (Guardiola, not Pep Guardiola). Full names fall back to the last word if needed.

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

Opret konto Dokumentation