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

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

Kommandoer

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 [email protected] [email protected]
firmasett epost omvendt [email protected]
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

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

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

firmasett skill install

legger alle ferdighetene fra biblioteket 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 § 6: kontaktverdier du sender inn kan brukes til å bekrefte og forbedre datasettet.