# For AI-agenter

> Gi agenten din Firmasett: én prompt å lime inn, så setter agenten opp tilkoblingen selv og vet hva som koster.


Firmasett er laget for å brukes av agenter, ikke bare av folk. Alt agenten trenger å vite står på [https://firmasett.arnu.io/llms.txt](https://firmasett.arnu.io/llms.txt): hvordan den kobler seg til, hvilke verktøy som finnes, hva som koster, og hvilke regler som gjelder i Norge.

## Før du starter

En agent kan ikke lage kontoen for deg. Gå til [konsollen](/konsoll), skriv inn e-posten din og kopier nøkkelen (den begynner med `fs_`). Gratisplanen gir 1 000 berikelser og 100 søketreff uten kort.

Samme nøkkel brukes overalt: MCP, CLI og REST.

## Oppsettprompt

Lim dette inn i Claude, ChatGPT, Cursor eller agenten din, med nøkkelen din i stedet for `fs_…`:

<div class="promptboks" markdown="1">
<button class="kopier" onclick="navigator.clipboard.writeText(this.nextElementSibling.innerText).then(()=>this.textContent='Kopiert')">Kopier</button>
```text
Les https://firmasett.arnu.io/llms.txt og følg «Kom i gang». Nøkkelen min er fs_…
Sett opp tilkoblingen som passer deg (MCP over HTTP hvis du kan), forklar meg kort hva jeg eventuelt må gjøre manuelt,
og bekreft at det virker ved å kalle konto. Si fra før du bruker telefonpoeng.
```
</div>

Agenten leser da reglene, velger MCP eller REST, og svarer med plan og kvote fra `konto`. Første gang stiller den deg også seks korte spørsmål (navn, mobil, jobb-e-post, firma, hva du bestemmer over, hva du påvirker) og lagrer svarene på kontoen.

## Tilkoblinger agenter kan velge

### MCP over HTTP (anbefalt for samtaleklienter)

Adresse `https://firmasett.arnu.io/mcp`, nøkkel i `Authorization: Bearer fs_…`. Klienter som ikke kan sende hoder bruker `https://firmasett.arnu.io/mcp/fs_…` (nøkkelen i adressen; del aldri den adressen).

```bash
claude mcp add --transport http firmasett https://firmasett.arnu.io/mcp --header "Authorization: Bearer fs_…"
```

Oppsett for Claude.ai, Claude Desktop, ChatGPT, Cursor, Windsurf og VS Code står på [MCP-sida](/slik-virker-det/mcp).

### CLI (anbefalt for kodeagenter og filer)

Claude Code, Codex og lignende bør bruke [CLI-et](/slik-virker-det/cli) når det er en fil i bildet. Da holdes radene utenfor samtalen, jobben kan gjenopptas, og agenten får en ferdighet som sier hvordan den skal gjøre det:

```bash
export FIRMASETT_NOKKEL=fs_…
firmasett konto
firmasett skill install
firmasett sjekk kunder.csv --torrkjoring
```

### REST (for egne agenter)

```bash
curl -s "https://firmasett.arnu.io/v1/selskaper/sok?bransje=69.2&fylke=Rogaland&har_dl_epost=ja&antall=5" \
  -H "Authorization: Bearer fs_…"
```

Svar:

```json
{"status": "ok",
 "resultat": {"total": 212, "side": 1, "antall": 5, "treff": [{"orgnr": "9xxxxxxxx", "navn": "…", "daglig_leder": "…", "har_dl_epost": true, "har_dl_mobil": true, "…": "…"}]},
 "meta": {"plan": "gratis", "vindu": "totalt", "berikelser": {"grense": 1000, "brukt": 0, "igjen": 1000}, "sok": {"grense": 100, "brukt": 5, "igjen": 95}, "telefonpoeng": 0, "belastet": {"sok": 5}}}
```

[OpenAPI-beskrivelsen](/openapi.json) kan limes rett inn i en agent som bygger verktøy selv.

## Regler agenten bør følge

- **Les `status`, ikke HTTP-koden.** `ikke_funnet` er 200 og gratis. `feil` har en `kode` (ugyldig_nokkel, kvote_brukt, ingen_telefonpoeng, ugyldig_foresporsel) og en melding på norsk.
- **Tell før du henter.** `antall_kun=ja` på søk er gratis.
- **`meta` sier hva som er igjen.** Agenten trenger ikke spørre `konto` mellom hvert kall.
- **Mobilnumre koster.** Spør brukeren før du henter mer enn noen få.
- **Vis kilde og grad.** Hver e-post, hvert nummer og hver LinkedIn-profil kommer med `kilde` og `grad` A–E. Fortell brukeren hvor sikker verdien er.
- **Norsk lov.** Ringe daglig leder på jobb: lov. E-post til jobbadresse om noe som gjelder virksomheten: lov. SMS til mobil til en fysisk person: krever samtykke (markedsføringsloven § 15). Les [etterlevelse](/etterlevelse).
- **429 har Retry-After.** Vent det antall sekunder, ikke prøv igjen med en gang.

## Hvorfor det er bygd slik

Flat pris betyr at en agent som går i løkke ikke lager en overraskende faktura. Gratis bomskudd betyr at agenten kan prøve seg fram. Kvote i hvert svar betyr at den kan planlegge. Én svarform betyr at den trenger færre eksempler for å gjøre det riktig. Og ferdighetsbiblioteket betyr at den slipper å finne opp framgangsmåten selv.

## Neste

- [Ferdighetsbiblioteket](/bibliotek): ferdige framgangsmåter for prospektering, CRM-vask og møteforberedelse.
- [Våre data](/data): hva feltene betyr og hvor de kommer fra.

---
Kilde: https://firmasett.arnu.io/slik-virker-det/ai-agenter · Firmasett, norsk B2B-data for folk og AI-agenter. Hele tjenesten: https://firmasett.arnu.io/llms.txt