学校检查数据收集工具

Skolinspektionen DATA

Samlar in och tillgängliggör data från Skolinspektionen som öppen, strukturerad data.

Varför detta projekt?

Skolinspektionen är en central myndighet vars beslut och granskningar har betydande inverkan på Sveriges skolor, elever och lärare. Trots detta erbjuder myndigheten inte sina data som öppna data i strukturerat format.

Detta verktyg syftar till att:

• Öka transparensen — Göra myndighetens arbete mer tillgängligt för allmänheten
• Möjliggöra granskning — Underlätta för journalister, forskare och medborgare att analysera beslut och trender
• Förbättra digital insyn — Strukturera information som annars är svår att överblicka
• Rusta AI för analys — Via MCP-servern kan AI-verktyg effektivt söka, analysera och sammanställa data från myndigheten

"Offentlighetsprincipen innebär att allmänheten har rätt till insyn i statens och kommunernas verksamhet. Denna insyn bör även omfatta digital tillgång till strukturerad data."

Vad samlas in?

Installation

pip install skolinspektionen-data

Från källkod

git clone https://github.com/isakskogstad/skolinspektionen-data
cd skolinspektionen-data
pip install -e ".[dev]"

Användning

MCP-integration (Claude Desktop)

Med MCP-servern kan AI-assistenter som Claude direkt söka och analysera Skolinspektionens data. Lägg till i din Claude Desktop-konfiguration:

{
  "mcpServers": {
    "skolinspektionen": {
      "command": "si-mcp"
    }
  }
}

Eller med uvx (ingen installation krävs):

{
  "mcpServers": {
    "skolinspektionen": {
      "command": "uvx",
      "args": ["skolinspektionen-data"]
    }
  }
}

Kommandoradsverktyg

# Uppdatera all data
si-refresh

# Uppdatera specifika källor
si-refresh --sources skolenkaten tillstand

# Visa datastatus
si-refresh --status

# Starta MCP-servern manuellt
si-mcp

MCP-verktyg

Sök och analys

Skolenkäten

Tillstånd och tillsyn

Kolada-integration

Referensdata

Teknisk arkitektur

src/
├── cli/
│   └── refresh.py          # Datauppdatering via kommandorad
├── mcp/
│   ├── server.py           # MCP-server med 30+ verktyg
│   └── validation.py       # Indatavalidering
├── search/
│   └── ranker.py           # BM25 + fuzzy search
└── services/
    ├── cache.py            # Tvålagers-cache (minne + disk)
    ├── fetcher.py          # Säker filnedladdning
    ├── kolada.py           # Kolada API-klient
    ├── parser.py           # HTML → Markdown
    ├── refresher.py        # Datauppdatering
    ├── skolenkaten.py      # Skolenkäten-parser
    ├── tillstand.py        # Tillståndsbeslut-parser
    └── tillsyn_statistik.py # Tillsynsstatistik-parser

Säkerhet

Projektet implementerar flera säkerhetsåtgärder:

• SSRF-skydd — URL-validering med domänvitlistning
• Indatavalidering — Alla MCP-verktygsparametrar valideras
• Path traversal-skydd — Filnamn saneras vid nedladdning
• Content-type-validering — Endast tillåtna filtyper accepteras
• Rate limiting — Respektfull datainsamling

Utveckling

# Installera med utvecklingsberoenden
pip install -e ".[dev]"

# Kör tester (268 tester)
pytest

# Kör med täckningsrapport
pytest --cov=src --cov-report=term-missing

Licens

AGPL-3.0 — Se LICENSE för detaljer.

Denna licens säkerställer att:

• Mjukvaran förblir fri och öppen källkod
• Modifieringar måste delas under samma licens
• Nätverksanvändning (t.ex. som webbtjänst) utlöser copyleft

Bidra

Detta är ett Civic Tech-projekt. Bidrag välkomnas!

1. Forka repot
2. Skapa en feature branch
3. Gör dina ändringar med tester
4. Säkerställ att alla tester passerar
5. Skicka en pull request

Relaterade projekt

• g0vse — Öppen data från regeringen.se
• SCB MCP — Statistik från SCB via MCP
• Kolada MCP — Kommundata via MCP

Tack till

• Skolinspektionen — för att publicera information på sin webbplats
• Kolada — för API:et med kommunstatistik
• Anthropic — för Model Context Protocol-specifikationen

Ett civic tech-projekt för ökad transparens i svensk skolinspektion.