# CLI

> Ett verktøy i terminalen som kjører alle oppslag og beriker eller sjekker en hel CSV-fil med én kommando. Laget for folk og for kodeagenter som Claude Code og Codex.


CLI-et kjører hvert oppslag som én kommando, og beriker eller sjekker en CSV-fil med én kommando. Utdata er JSON når du sender det videre i et rør, og en leselig tabell i terminalen. Kodeagenter som Claude Code bør bruke CLI-et framfor MCP når det er en fil å behandle.

## Installer

```bash
curl -o /usr/local/bin/firmasett https://firmasett.arnu.io/static/firmasett && chmod +x /usr/local/bin/firmasett
curl -o /usr/local/bin/mcp_server.py https://firmasett.arnu.io/last-ned/mcp_server.py
curl -o /usr/local/bin/mcp_felles.py https://firmasett.arnu.io/last-ned/mcp_felles.py
```

Tre filer, bare Python 3. De to siste er HTTP-klienten CLI-et deler med MCP-serveren.

## Oppsett

<div class="nummerert" markdown="1">
<div markdown="1">**Få nøkkel.** [Konsollen](/konsoll) gir deg en `fs_`-nøkkel.</div>
<div markdown="1">**Sett den i miljøet.** `export FIRMASETT_NOKKEL=fs_…` (eller `--api-key fs_…` per kommando). Skript, CI og agenter bruker miljøvariabelen.</div>
<div markdown="1">**Sjekk.** `firmasett konto` viser plan, kvote og telefonpoeng. Gratis.</div>
</div>

## Kommandoer

```text
firmasett konto                       plan, kvoter og forbruk (gratis)
firmasett bruk                        forbruk per dag siste 30 dager (gratis)
firmasett sok "regnskap" --fylke Rogaland --har-dl-epost ja --antall 20
firmasett sok --bransje 69.2 --antall-kun ja              bare tell, gratis
firmasett sok --bransje 69.2 --alle --ut byraaer.csv     alle treff til CSV
firmasett berik 810034882 [flere orgnr …]
firmasett personer "Nordmann" --fylke Oslo
firmasett person --orgnr 810034882
firmasett mobil --orgnr 810034882                         1 telefonpoeng
firmasett epost finn --fornavn Kari --etternavn Nordmann --domene firma.no
firmasett epost valider kari@firma.no ola@firma.no
firmasett epost omvendt kari@firma.no
firmasett sjekk kunder.csv --ut sjekket.csv               egne kontakter mot Firmasett
firmasett berik-fil liste.csv --kolonne orgnr --ut beriket.csv
firmasett bransjer
firmasett skill install [navn …]                          ferdigheter til ~/.claude/skills
```

Alle filtre fra søket finnes som flagg: `--bransje --fylke --kommune --kundetype --ansatte-min/-maks --omsetning-min/-maks --stiftet-min/-maks --utestaende-min --kunder-min --fakturaer-min --kan-sms --har-dl-mobil --har-dl-epost --har-dl-linkedin --har-nettside --fakturerer-mange --kjede --konsern --signal --regnskapsforer --revisor --sorter --antall --side`.

## Filflyt: tørrkjør, prøv, kjør

```bash
firmasett sjekk kunder.csv --torrkjoring          # finner kolonnene, teller rader, viser kvote. Ingen kall.
firmasett sjekk kunder.csv --grense 10            # ti rader, se at resultatet ser riktig ut
firmasett sjekk kunder.csv --ut sjekket.csv       # hele fila
```

Hva som skjer underveis:

- **Kolonner finnes automatisk.** `orgnr`, `firma`, `domene`, `navn`, `epost`, `telefon` gjenkjennes på vanlige norske og engelske overskrifter. `--kolonne` overstyrer orgnr-kolonnen.
- **Bunker på 100.** Ett API-kall per hundre rader.
- **Alle kolonner beholdes.** Utfila har de opprinnelige kolonnene pluss nye med `fs_`-prefiks: for sjekk `fs_treff`, `fs_epost_status`, `fs_beste_epost`, `fs_beste_epost_grad`, `fs_telefon_status`, `fs_har_mobil`; for berik-fil regnskap, bransje, daglig leder med e-post og grad, fakturasignaler.
- **Framdrift lagres** etter hver bunke. Kjør samme kommando igjen for å fortsette. `--omstart` begynner på nytt.
- **Kvote.** Før hver bunke vet CLI-et hva som er igjen (fra `meta`). Går vinduet tomt, venter det ti minutter om gangen, eller stopper med kode 3 hvis du gir `--ikke-vent`.
- **Avslutningskoder:** 0 ok, 1 feil bruk, 2 feil fra tjenesten, 3 kvote brukt opp. Trygt i cron og CI.

## Eksempel: fra søk til ringeliste

```bash
firmasett sok --bransje 86.23 --fylke "Trøndelag" --ansatte-min 5 --har-dl-epost ja --alle --ut tannleger.csv
firmasett berik-fil tannleger.csv --ut tannleger-beriket.csv
```

Første kommando henter alle treff (søketreff). Andre beriker hvert orgnr (berikelser) og legger på regnskap, daglig leder med e-post og grad, og fakturasignaler. Mobilnumre henter du bevisst etterpå med `firmasett mobil --orgnr …`, ett telefonpoeng hver.

## Ferdighet for kodeagenter

```bash
firmasett skill install
```

legger alle ferdighetene fra [biblioteket](/bibliotek) i `~/.claude/skills/firmasett-*/SKILL.md`. Claude Code lærer da når CLI-et er bedre enn MCP, å tørrkjøre først, å lese `fs_*`-kolonnene, og hva gradene betyr. `--dir` velger en annen mappe.

## Vanlige spørsmål

**Kan jeg bruke en annen kolonne for e-post?** Gi fila en overskrift som heter `epost`, `email` eller `mail`. Andre overskrifter kan du døpe om i regnearket.

**Kan jeg sende fast telefon?** Ja. Numre normaliseres (landkode og mellomrom fjernes) før de sammenlignes.

**Lagres fila mi?** Nei. Radene sendes til `/v1/sjekk` og `/v1/selskaper/berik` og behandles som beskrevet i [vilkårene](/vilkar) § 6: kontaktverdier du sender inn kan brukes til å bekrefte og forbedre datasettet.

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