Firmasett er laget for å brukes av agenter, ikke bare av folk. Alt agenten trenger å vite står på 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, 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_…:

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.

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).

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.

CLI (anbefalt for kodeagenter og filer)

Claude Code, Codex og lignende bør bruke CLI-et 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:

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

REST (for egne agenter)

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:

{"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 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.
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: ferdige framgangsmåter for prospektering, CRM-vask og møteforberedelse.
Våre data: hva feltene betyr og hvor de kommer fra.