# datanorge

**Finn og hent norske offentlige data fra [data.norge.no](https://data.norge.no) — rett fra Claude Code.**

Spør deg selv «hvor finner jeg data om dette?» — og la Claude lete for deg. Dette er en
liten Claude Code-**plugin** med to deler som spiller sammen:

- 🔎 en **`/finn-datakilde`-kommando/skill** som leter iterativt i Felles datakatalog og
  finner offentlige datasett og API-er for et tema;
- 🧰 en **MCP-server** med verktøy for å søke, hente metadata og laste ned selve dataene.

Den krever **ingen API-nøkkel** og nesten null oppsett, fordi API-ene bak data.norge.no er
helt åpne. Og den **henter alltid fram lisens og krediteringskrav**, slik at kilden blir
kreditert når den skal.

> **English:** A Claude Code plugin to find and fetch Norwegian open government data from
> data.norge.no. Ships a `/finn-datakilde` skill (iterative data-source discovery) plus an
> MCP server (search / metadata / download). No API key. Always surfaces the licence and
> required attribution. See the tools table and the *Kreditering* section below.

---

## Kom i gang

### Alternativ A — som plugin (anbefalt: kommando + MCP i ett)

I Claude Code:

```text
/plugin marketplace add tenki-labs/datanorge-mcp
/plugin install datanorge@datanorge-mcp
```

Det kobler opp både `/finn-datakilde`-skillen og MCP-verktøyene. Start Claude Code på nytt
hvis den ber om det. Eneste krav: **Node.js 18+**.

### Alternativ B — bare MCP-serveren (uten skillen)

Vil du bare ha verktøyene, rett fra GitHub, uten kloning eller npm-publisering:

```bash
claude mcp add datanorge -- npx -y github:tenki-labs/datanorge-mcp
```

### Alternativ C — fra kildekode (utvikling)

```bash
git clone https://github.com/tenki-labs/datanorge-mcp.git
cd datanorge-mcp
npm install        # bygger også via "prepare"
```

Åpne Claude Code i mappa (den bundlede [`.mcp.json`](.mcp.json) plukkes opp automatisk), eller
registrer eksplisitt: `claude mcp add datanorge -- node /absolutt/sti/dist/index.js`.

---

## Slik bruker du den

Bare spør på vanlig norsk — skillen trigger på spørsmål som dette:

- *«Hvor finner jeg data om luftkvalitet i Oslo?»*
- *«Finnes det åpne data på ladestasjoner for elbil?»*
- *«Er det noe offentlig statistikk på befolkning per kommune?»*

…eller bruk kommandoen direkte:

```text
/finn-datakilde befolkning per kommune
```

Claude søker iterativt, forfiner søket, henter detaljer, og presenterer en kort liste med
kilder — **inkludert hvordan du krediterer hver kilde**.

### Verktøyene (MCP)

| Verktøy | Funksjon |
|---|---|
| `search_datasets` | Søk i datasettkatalogen |
| `get_dataset` | Full metadata + nedlastingslenker + **lisens/kreditering** |
| `search_apis` | Søk i API-katalogen (SSB, Kartverket, MET m.fl.) |
| `get_api` | Endepunkt-URL-er for ett API |
| `fetch_data` | Henter de faktiske dataene (CSV/JSON/XML/GeoJSON) |

Typisk flyt: **søk → get_dataset → fetch_data**.

---

## Kreditering / attribution

Dette er viktig, og verktøyet hjelper deg med det automatisk.

Når du bruker data du finner her, følger plikten til å oppgi kilde av **datasettets egen
lisens** — ikke av data.norge.no. `get_dataset` og `get_api` viser derfor alltid en
**«Kreditering / attribution»-seksjon** med lisensen og en ferdig kildehenvisning:

- **NLOD** (Norsk lisens for offentlige data) — **krever kreditering**:
  > Inneholder data under Norsk lisens for offentlige data (NLOD) tilgjengeliggjort av *{utgiver}*.
- **CC BY 4.0** o.l. — **krever kreditering**:
  > «*{tittel}*» av *{utgiver}*, lisensiert under CC BY 4.0. Kilde: *{lenke}*.
- **CC0 / public domain** — kreditering er ikke et krav, men god skikk er å lenke til kilden.
- **Uavklart lisens** — sjekk vilkårene på kildens landingsside før bruk.

Tar du dataene videre i en rapport, et notat eller en app: **ta krediteringen med** — ikke
bare nevn at den finnes. Lenk gjerne også til datasettet på data.norge.no.

---

## Slik virker det

Serveren snakker med to åpne, uautentiserte FDK-endepunkter:

- **Søk** — `POST https://search.api.fellesdatakatalog.digdir.no/search/{type}`
- **Resource** — `GET https://resource.api.fellesdatakatalog.digdir.no/v1/{type}/{id}`

`fetch_data` laster så ned direkte fra distribusjons-/endepunkt-URL-en katalogen peker til
(disse ligger hos utgiverne selv, f.eks. SSB, Kartverket, Statens vegvesen).

### Begrensninger

- **Rate limit:** søke-API-et tillater ~10 forespørsler/minutt. Serveren prøver automatisk
  på nytt ved HTTP 429.
- **Nedlastingstak:** `fetch_data` leser maks 256 KB som standard (opp til 5 MB via
  `maxKilobytes`). Binært innhold returnerer kun metadata.
- **Språk:** norske søkeord treffer best; resultater inkluderer `nb`/`nn`/`en` der det finnes.

---

## Utvikling

```bash
npm install        # installer + bygg
npm run watch      # bygg på endring
npm run smoke      # ende-til-ende MCP-sjekk mot live-API
npm run inspector  # åpne MCP Inspector mot serveren
```

Struktur:
[`src/index.ts`](src/index.ts) registrerer MCP-verktøyene ·
[`src/fdk.ts`](src/fdk.ts) er FDK-klienten ·
[`src/format.ts`](src/format.ts) formaterer svar og klassifiserer lisens/kreditering ·
[`skills/finn-datakilde/SKILL.md`](skills/finn-datakilde/SKILL.md) er skillen ·
[`commands/finn-datakilde.md`](commands/finn-datakilde.md) er slash-kommandoen ·
[`.claude-plugin/`](.claude-plugin/) er plugin- og marketplace-manifestene.

## Publisering (vedlikeholdere)

Pakka publiseres til npm automatisk når en versjons-tag pushes:

```bash
npm version patch
git push --follow-tags
```

Dette trigger [`.github/workflows/publish.yml`](.github/workflows/publish.yml). Det krever en
`NPM_TOKEN`-hemmelighet med publiseringsrett til `@tenki-labs`-scopet. Plugin- og
MCP-installasjon fungerer uansett rett fra GitHub via `npx`, uten npm-publisering.

---

## Lisens

[MIT](LICENSE) © Tenki Labs.

Data leveres av [data.norge.no](https://data.norge.no), driftet av Digitaliseringsdirektoratet
(Digdir). Prosjektet er ikke tilknyttet eller godkjent av Digdir. Følg hvert datasetts egen
lisens — se *Kreditering* over.