# Firmasett

> Norsk B2B-søk og berikelse for folk og AI-agenter: 65 926 norske selskaper med ansatte, siste regnskap, daglig leder med beste e-post, mobilnummer og LinkedIn-profil (med kilde og sikkerhetsgrad A–E), anslag på utestående, kunder og fakturaer, og fakturasignaler fra nettsidene. Tilgjengelig som REST-API, MCP-server (HTTP og stdio) og CLI. Ubegrenset data for fast månedspris; mobilnumre koster telefonpoeng. Bygd av Tiny Elephant AS på åpne data fra Brønnøysundregistrene, Regnskapsregisteret, NAV og selskapenes egne nettsider.

Dekning akkurat nå: 58 253 daglige ledere, 15 357 med direkte e-post (pluss 10 785 gjettede), 18 315 med mobilnummer, 306 med LinkedIn, 61 476 med regnskap, 16 013 med nettside. Oppdatert 06.11.2026.

## Kom i gang (for agenter)

1. Et menneske må lage kontoen: be brukeren gå til https://firmasett.arnu.io/konsoll, skrive inn e-post og kopiere nøkkelen (begynner med `fs_`). Gratisplanen gir 1 000 berikelser og 100 søketreff uten kort.
2. Velg tilkobling:
   - MCP over HTTP (Claude Code, Cursor, VS Code, Windsurf, ChatGPT-utviklermodus): `https://firmasett.arnu.io/mcp` med `Authorization: Bearer fs_…`. Klienter som ikke kan sende hoder bruker `https://firmasett.arnu.io/mcp/fs_…` (nøkkelen i adressen).
     Claude Code: `claude mcp add --transport http firmasett https://firmasett.arnu.io/mcp --header "Authorization: Bearer fs_…"`
   - MCP lokalt (stdio): `claude mcp add firmasett -e FIRMASETT_NOKKEL=fs_… -- python3 mcp_server.py` (fil fra https://firmasett.arnu.io/slik-virker-det/mcp).
   - REST: `GET https://firmasett.arnu.io/v1/selskaper/sok?q=…` med `Authorization: Bearer fs_…`. OpenAPI: https://firmasett.arnu.io/openapi.json.
   - CLI: `firmasett konto` med `FIRMASETT_NOKKEL=fs_…` i miljøet (fil fra https://firmasett.arnu.io/slik-virker-det/cli).
3. Bekreft tilkoblingen med `GET /v1/konto` (MCP-verktøy `konto`). Den er gratis og teller ikke mot kvoten.
4. Onboarding: første gang nøkkelen brukes sier MCP-serveren fra i `initialize` (og `meta.onboarding_mangler` i hvert svar) at profilen ikke er fullført. Still brukeren spørsmålene fra `GET /v1/onboarding` (fullt navn, mobilnummer, jobb-e-post, firma, hva brukeren bestemmer over, hva brukeren påvirker beslutninger om), ett eller to om gangen, og lagre med `POST /v1/onboarding` (MCP `lagre_profil`). «-» betyr hoppet over. Gratis.
5. Forklar brukeren hva som koster: søketreff og berikelser trekkes fra planens 5-timersvindu; mobilnumre koster 1 telefonpoeng (1,50 kr) per nummer levert; `ikke_funnet` koster aldri noe.

## Regler agenter bør følge

- Alle svar har samme konvolutt: `{"status": "ok" | "ikke_funnet" | "feil", "resultat": …, "meta": {kvote igjen, belastet}}`. Les `status`, ikke bare HTTP-koden: `ikke_funnet` er HTTP 200 og gratis.
- Bruk `antall_kun=ja` på søk før du henter mange treff; det er gratis og viser totalen.
- Vis bare den best rangerte kontaktverdien (det gjør API-et alt); `epost_alternativer` sier hvor mange andre vi kjenner.
- Spør brukeren før du henter mer enn noen få mobilnumre (telefonpoeng).
- Lov: å ringe en daglig leder på jobb er lov. E-post til en rolle i næringsvirksomhet er lov (markedsføringsloven § 15 gjelder fysiske personer; bruk næringsadresser). SMS til mobil til en fysisk person krever samtykke. Ikke bruk dataene til å kontakte folk privat.
- 429 har `Retry-After` i sekunder. Vent, ikke hamre.
- Rapporter kilde og grad (A–E) når du gir brukeren kontaktinfo, så hen vet hvor sikkert det er.

## Endepunkter (REST, base https://firmasett.arnu.io/v1)

- GET /konto – plan, kvoter, forbruk (gratis)
- GET /bruk – forbruk per dag siste 30 dager (gratis)
- GET /onboarding, POST /onboarding {navn, telefon, epost, firma, bestemmer, paavirker} – profil og onboarding (gratis)
- GET /bransjer – næringskoder med antall og dekning, fylker (gratis)
- GET /selskaper/sok – fritekst + filtre: 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, har_regnskap, fakturerer_mange, kjede, konsern, signal, regnskapsforer, revisor, status (aktiv|konkurs|avvikling|alle), register=ja (hele Enhetsregisteret), sorter, antall (≤100), side, antall_kun
- GET /selskaper/{orgnr} – alt om ett selskap inkl. daglig leder (1 berikelse)
- POST /selskaper/berik {orgnrs: [≤100]} – mange selskaper (1 berikelse per funnet)
- GET /personer/sok – daglige ledere, samme filtre
- POST /berik/person {orgnr | navn + firma/domene} – beste e-post, LinkedIn, andre selskaper (1 berikelse)
- POST /telefon/finn {orgnr | firma | domene} – mobil til daglig leder (1 telefonpoeng per nummer)
- POST /epost/finn {fornavn, etternavn, domene | orgnr} – kjent adresse eller domenets mønster med alternativer (1 berikelse)
- POST /epost/valider {eposter: [≤100]} – syntaks, MX, rolleadresse, fridomene, engangsdomene, kjent (1 berikelse per adresse)
- GET /epost/omvendt?epost=|domene= – hvem og hvilket selskap (1 berikelse)
- POST /sjekk {rader: [≤100 × {id, orgnr, firma, domene, navn, epost, telefon}]} – sjekk egne kontakter: treff, epost_status/telefon_status (lik|avviker|vi_mangler|du_mangler), beste e-post (1 berikelse per treff)

MCP-verktøy med samme funksjoner: sok_selskaper, berik_selskap, berik_selskaper, sok_personer, berik_person, finn_mobil, finn_epost, valider_epost, omvendt_epost, sjekk_liste, bransjer, konto, bruk, onboarding, lagre_profil.

## Planer

- Gratis: 0 kr/mnd – 1 000 berikelser og 100 søketreff totalt. Ingen kort.
- Solo: 290 kr/mnd – 1 000 berikelser og 500 søketreff per 5 timer.
- Pro: 990 kr/mnd – 15 000 berikelser og 7 500 søketreff per 5 timer.
- Team: 3 990 kr/mnd – 150 000 berikelser og 75 000 søketreff per 5 timer.
- Telefonpoeng: 1,50 kr per mobilnummer levert, pakker 180 for 290 kr, 650 for 990 kr, 1300 for 1 990 kr. Ikke på gratisplanen.

## Sider

- [Slik virker det](https://firmasett.arnu.io/slik-virker-det.md): oversikt over tilkoblingene
- [For AI-agenter](https://firmasett.arnu.io/slik-virker-det/ai-agenter.md): oppsettprompt og regler
- [MCP-server](https://firmasett.arnu.io/slik-virker-det/mcp.md): oppsett per klient
- [CLI](https://firmasett.arnu.io/slik-virker-det/cli.md): kommandoer, CSV-berikelse, ferdigheter
- [REST-API](https://firmasett.arnu.io/slik-virker-det/api.md): konvolutt, feil, eksempler
- [Integrasjoner](https://firmasett.arnu.io/slik-virker-det/integrasjoner.md): HubSpot, Pipedrive, SuperOffice, Google Sheets, n8n, Make, Tripletex
- [Våre data](https://firmasett.arnu.io/data.md): kilder, dekning, felt, sikkerhetsgrader, anslag
- [API-dokumentasjon](https://firmasett.arnu.io/dok.md): full referanse
- [Priser](https://firmasett.arnu.io/priser?format=md) og [Rimelig bruk](https://firmasett.arnu.io/rimelig-bruk.md)
- [FAQ](https://firmasett.arnu.io/faq.md)
- [Funksjoner](https://firmasett.arnu.io/funksjoner.md): én side per bruksområde
- [Ferdighetsbibliotek](https://firmasett.arnu.io/bibliotek?format=md): SKILL.md-filer
- [Blogg](https://firmasett.arnu.io/blogg.md)
- [Etterlevelse](https://firmasett.arnu.io/etterlevelse.md), [Personvern](https://firmasett.arnu.io/personvern.md), [Vilkår](https://firmasett.arnu.io/vilkar.md), [Underleverandører](https://firmasett.arnu.io/underleverandorer.md)
- [OpenAPI](https://firmasett.arnu.io/openapi.json), [sitemap](https://firmasett.arnu.io/sitemap.xml)
- Hele nettstedet i én fil: https://firmasett.arnu.io/llms-full.txt

## Valgfritt

- Alle HTML-sider finnes som Markdown ved å legge til `.md` på adressen eller sende `Accept: text/markdown`.
- Kontakt: hei@firmasett.no