Åpne grensesnitt

Bygg med AaFK-arkivet

Koble AaFK-arkivet til AI-verktøyet ditt med MCP. Bygger du et nettsted, skript eller en app, kan du bruke det åpne REST API-et. Begge leser de samme publiserte dataene og åpne researchsakene.

Gratis, uten konto eller API-nøkkel

Grensesnittene er en del av supporterarkivet og skal være enkle å ta i bruk. Vis hensyn med automatiserte kall: arkivet drives uten en egen API-database eller betalt køtjeneste, og kan begrense trafikk som belaster fellesskapet.

For programvare

REST API

Åpne OpenAPI →

Baseadressen er https://aafkarkivet.no/api/v1. Alle ruter er skrivebeskyttede GET-ruter med JSON-svar, CORS og offentlig mellomlagring.

Finn de største dokumenterte seirene:

curl "https://aafkarkivet.no/api/v1/results?ranking=largest_win&limit=10"

Finn åpne saker fellesskapet kan undersøke:

curl "https://aafkarkivet.no/api/v1/research/cases?limit=10"

Se også metadata og datasettrevisjon eller den komplette API-kontrakten på GitHub.

Viktig skille

Hva vet arkivet?

canonical_match er en kamp arkivet har identifisert og lagt inn i den kanoniske kamphistorikken.

source_claim er et resultat en historisk kilde oppgir, men som ennå ikke er sikkert koblet til én bestemt kamp.

Begge kan være relevante treff, men de skal aldri summeres til én statistisk total. Kontroller også confidence, hasConflicts ogmissingFields før du presenterer et svar som sikkert.

Når flere kilder omtaler det samme uavklarte oppgjøret, samler arkivet dem i ett treff og bevarer hver skrivemåte som dokumentasjon. Mulige navnetreff uten avklart klubbidentitet vises som researchspor, aldri som del av kampstatistikken.

For AI-verktøy

MCP

Full dokumentasjon →

Serveradressen er https://aafkarkivet.no/mcp. Innstillingsfilen varierer mellom klienter, men en vanlig konfigurasjon ser slik ut:

{
  "mcpServers": {
    "aafkarkivet": {
      "url": "https://aafkarkivet.no/mcp"
    }
  }
}

MCP gir strukturerte verktøy for kamper, resultater, personer, overganger, stall og tabeller, kilder og åpne researchsaker. Konflikter og dekningshull finnes i researchoversikten. Det finnes ingen generell SQL-tilgang og ingen direkte skrivetilgang til arkivdataene.

Oversikter og lister er bevisst korte. AI-verktøyet henter detaljer om én kamp, person, kilde eller researchsak først når de trengs. Det holder både svarene og tokenbruken nede.

AI kan hjelpe med research, men er ikke en kilde

Et AI-verktøy kan finne en åpen sak, hjelpe deg å lete og sende et dokumentert funn til vurdering. Selve kilden må være en konkret bok, avisside, nettside eller annen etterprøvbar dokumentasjon — aldri bare et AI-svar.

En innsending får status pending_review. Den går til samme innboks som bidrag fra nettsiden. Et menneske kontrollerer kilden, lager eventuelt en draft-PR og avgjør om endringen skal merges. AI kan ikke endre data, opprette en publiserings-PR eller merge på egen hånd.

Velg en åpen researchsak →

Rettigheter og drift

Koden er MIT-lisensiert, mens egne tekster og redaksjonelt innhold er CC BY 4.0. Tredjepartskilder beholder sine egne vilkår. Les datasettsiden, lisensvilkårene og sikkerhetsgrensene før større gjenbruk.