# Brug dokumentationen med din LLM

> Giv dokumentationen til Claude, ChatGPT, Cursor eller en anden kodeagent, med færdige prompter til at bygge en integration.

Dokumentationen er skrevet til både mennesker og sprogmodeller. Alle sider findes som ren Markdown, og hele dokumentationen ligger i én fil. Peg din kodeagent eller chatassistent på den, så kan den skrive en integration mod API'et uden at gætte.

## Hvad du skal give modellen

| Adresse                     | Hvad det er                                                            | Brug den, når                                               |
| --------------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------- |
| `https://cvrradar.dk/llms-full.txt`   | Hele dokumentationen i én Markdown-fil                                 | Modellen skal vide alt. Bedst til agenter med stor kontekst |
| `https://cvrradar.dk/llms.txt`        | Et indeks over alle sider med et resumé og et link til sidens Markdown | Modellen kan selv hente de sider, den har brug for          |
| `https://cvrradar.dk/docs/<side>.md`  | Én side som Markdown, fx `https://cvrradar.dk/docs/endpoints/kredit.md`          | Du ved, hvilket emne det handler om                         |
| `https://cvrradar.dk/v1/openapi.json` | OpenAPI 3.1                                                            | Kodegeneratorer, GPT Actions og Postman                     |
| `https://cvrradar.dk/v1/tools`        | Værktøjerne som skemaer i Anthropic- og OpenAI-format                  | Din egen agent skal kunne slå virksomheder op (tool use)    |

En forespørgsel på en side med `Accept: text/markdown` får også Markdown-udgaven. Links i Markdown-udgaven peger på andre `.md`-sider, så en agent kan følge dem.

Øverst på hver side er der knapper: **Kopiér som Markdown** lægger siden i din udklipsholder, **Åbn i ChatGPT** og **Åbn i Claude** starter en chat med en prompt, der peger på sidens Markdown, og **Vis som Markdown** åbner den rå side.

## Claude Code

Tilføj en linje til `CLAUDE.md` i dit projekt, så Claude Code kender dokumentationen i alle sessioner:

```text
cvrradar API docs: https://cvrradar.dk/llms.txt (fuld tekst: https://cvrradar.dk/llms-full.txt). Læs den relevante side, før du skriver kode mod cvrradar.
```

Vil du have, at Claude Code også kan slå virksomheder op, så tilføj [MCP-serveren](https://cvrradar.dk/docs/integrationer/mcp.md).

## Data om én virksomhed som Markdown

`GET https://cvrradar.dk/v1/virksomhed/{cvr}?format=llm` (med nøgle) giver hele virksomhedskortet som Markdown: stamdata, ledelse og ejere, regnskab, kreditvurdering, ejere og koncern, digital profil og seneste ændringer, med kilde og dato nederst. Det offentlige kort findes uden nøgle ved at tilføje `.md` til adressen, fx `https://cvrradar.dk/virksomhed/10203040-havnens-smedje-aps.md`. Teksten er lavet efter faste regler, ikke af en sprogmodel.

## Cursor

Skriv `@Docs` i en chat, vælg **Add new doc**, og indsæt `https://cvrradar.dk/llms-full.txt`. Henvis derefter til den med `@cvrradar` i dine prompter.

## Codex og andre agenter med AGENTS.md

```text
cvrradar API: læs https://cvrradar.dk/llms.txt og de sider, der er relevante, før du kalder API'et. Nøglen ligger i miljøvariablen CVRRADAR_NOEGLE.
```

## Færdige prompter

**Byg en integration**

```text
Læs https://cvrradar.dk/llms-full.txt. Skriv en funktion i TypeScript, der tager et CVR-nummer, henter virksomheden og dens kreditvurdering fra cvrradar, og returnerer navn, status, score og faresignaler. Håndtér 404, 402 og 429 (respektér Retry-After). Nøglen ligger i CVRRADAR_NOEGLE.
```

**Berig en kundeliste**

```text
Læs https://cvrradar.dk/docs/endpoints/virksomhed.md og https://cvrradar.dk/docs/godkendelse-og-kvoter.md. Skriv et Python-script, der læser kunder.csv med en kolonne cvr, henter alle virksomheder med POST /v1/virksomheder i bidder á 500, og skriver navn, adresse, branche og reklamebeskyttet til en ny CSV.
```

**Modtag webhooks**

```text
Læs https://cvrradar.dk/docs/integrationer/webhooks.md. Lav et endpoint i Express, der modtager cvrradar-webhooks, tjekker X-Cvrradar-Signature med hemmeligheden i CVRRADAR_WEBHOOK, afviser gamle kald og lægger ændringerne i en kø.
```

## Regler, modellen skal kende

- Reklamebeskyttede virksomheder (`reklamebeskyttet: true`) må ikke bruges til direkte markedsføring.
- Kreditvurderingen er en vurdering ud fra offentlige data og ikke rådgivning. Står der `ikke_nok_data`, må der ikke opfindes en score.
- Der er ingen privatadresser, CPR-numre eller reelle ejere i tjenesten.
- Oplys kilden ("Erhvervsstyrelsen (CVR)"), når data vises.
