stackgate.ai
Alle integrationer
API-Sports Basketball

Basketball

Hent basketballkampe, livescore, ligaer, stillinger, hold og spillere via MCP.

Manual setup 13 værktøjer

Oversigt

Forbind Basketball, så AI-klienter kan hente konkurrencer, hold, spillere, kampe, livescore, stillinger, begivenheder, statistik og head-to-head.

stackgate.ai gemmer din API-Sports Basketball 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 (Basketball).

Forudsætninger

  • En API-Sports-konto med Basketball-adgang og en API-nøgle
  • En stackgate.ai-konto

Sådan henter du legitimationsoplysninger

  1. Log ind på stackgate.ai.
  2. Gå til Mine integrationer og åbn Basketball.
  3. Åbn API-Sports-dashboardet i en anden fane.
  4. Bekræft at dit abonnement inkluderer Basketball, gå til Account → My Access, og kopier API-nøglen.
  5. Indsæt nøglen i stackgate.ai og klik Gem.
  6. stackgate.ai kører en let forbindelsestest (/status). Ved succes kan du se planen og den daglige request-grænse.
  7. 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.basketball.api-sports.io (header x-apisports-key). RapidAPI host/key-par understøttes ikke.

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/basketball med et Sanctum bearer-token
  • Privat gateway: én konfiguration til alle integrationer — brug basketball__*-værktøjer

Se Dokumentation for HTTP-godkendelse og privat gateway-setup.

Eksempelprompts

  • Vis den aktuelle NBA-stilling.
  • Find et holds næste fem kampe.
  • Hvilke kampe er i gang lige nu?
  • Vis begivenheder og statistik fra kamp 12345.
  • Find oplysninger om en spiller.
  • Sammenlign de seneste kampe mellem to hold.

Anbefalet arbejdsgang

  1. search_competitions / list_seasons — find competition_id og sæsonår.
  2. get_standings / search_games — mange forespørgsler kræver season som YYYY.
  3. get_live_games — kun igangværende kampe.
  4. get_game — oversigt; brug events/statistics til detaljer.
  5. search_teams / search_players — derefter get-værktøjer til profiler.
  6. get_head_to_head — historiske kampe mellem to hold.

Caching og aktualitet

Omtrentlige cache-tider på hubben (pr. forbindelse):

Data Cache
Konkurrencer / sæsoner ~24 timer
Hold ~12 timer
Spillere ~6 timer
Stillinger / kommende kampe ~10 minutter
Afsluttede kampe ~24 timer
Livekampe / begivenheder ~20 sekunder
Kampstatistik ~2 minutter

Godkendelsesfejl caches aldrig.

Rate limits

API-Sports-planer har en daglig request-kvote og et pr. minut-loft. Foretræk cachede værktøjer og specifikke ID'er. En 429 eller “request limit”-fejl betyder vent, reducer kald eller opgrader planen.

Bemærkning om datalicens

stackgate.ai giver adgang til data fra den tilsluttede udbyder. Tilgængelighed og tilladt brug afhænger af udbyderens vilkår og dit abonnement. Officiel liga-branding, logoer og medier kan have særskilte rettigheder. Du er ansvarlig for at sikre, at brugen overholder udbyderens vilkår.

Fejlfinding

  • 422 integration not configured — tilføj din API-Sports Basketball API-nøgle under Mine integrationer.
  • Connection test failed / invalid key — bekræft nøglen under Account → My Access og at Basketball er på din plan.
  • 401 / authentication failed — regenerér nøglen og opdater Mine integrationer.
  • 429 / request limit — du har ramt udbyderkvoten; 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 kampe kræver et sæsonår (YYYY).

Tilgængelige værktøjer

  • search_competitions

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

  • list_seasons

    List tilgængelige sæsoner (år).

  • search_teams

    Search basketball teams by name, ID, competition+season, or country. Requires at least one filter.

  • get_team

    Get a normalized team profile.

  • 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.

  • search_games

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

  • get_live_games

    Vis igangværende kampe.

  • get_game

    Hent oversigt for én kamp.

  • get_game_events

    Game events sorted chronologically. Returns empty items[] when events are unavailable for the game.

  • get_game_statistics

    Team-level game statistics. Values keep original units/labels from the provider.

  • get_standings

    Hent stillingen for en konkurrence og sæson.

  • get_head_to_head

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

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

Opret konto Dokumentation