Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Firmaradar

firmaradar-make

Bygg Make.com-scenarier mot norske selskapsdata — eierregister, konsern, regnskap, KYC og AML — uten å skrive en eneste linje kode.

Lisens: Apache 2.0 Make.com Custom App Versjon Norsk data

Installer i Make →  ·  Moduler  ·  Mal-scenarier  ·  Prising  ·  Dokumentasjon


Hva er dette?

firmaradar-make er en custom-app for Make.com som lar deg slå opp norske selskaper, eierstrukturer, konsernhierarkier, roller, regnskap og AML/PEP-screening direkte i scenariene dine. Samme datakilde og samme operasjoner som MCP-serveren og n8n-pakken, men i Make.com-konteksten med visuelle scenarie-bygger.

Egnet for:

  • KYC-automatisering — automatisk eierskaps-screening når nye kunder kommer inn via CRM, HubSpot, Pipedrive eller Airtable
  • Konkurs-overvåkning — utløs varsler i Slack/Teams når et selskap i porteføljen får signaler
  • Konsern-due-diligence — bygg sammensatte rapporter ved å kombinere flere oppslag, eksporter til Google Sheets eller PDF
  • Compliance-rapportering — eksporter regelmessige snapshots til Sharepoint, Excel eller Google Drive
  • Kreditt-vurdering — automatisk regnskaps-uthenting + endringssjekk på leverandører

Installasjon

Pilot (anbefalt — fungerer nå)

Appen er i pilot-fase og distribueres via Install URL inntil Make.com sertifisering (4-6 uker køtid). Klikk lenken under for å legge appen til din Make.com-konto:

🚀 Installer Firmaradar Custom App

Etter installasjon:

  1. Gå til Scenarios → opprett nytt scenario
  2. Søk etter "Firmaradar" i moduler-panelet
  3. Velg en modul (Get Company, Search Companies, Check AML / PEP, osv.)
  4. Opprett tilkobling med din Firmaradar API-key fra firmaradar.no/min-side/api-keys

Fra Make.com-katalogen (etter sertifisering)

Når appen er godkjent og publisert i Make-direktoratet (Q3 2026 estimert):

  1. Logg inn på Make.com
  2. Gå til My Apps → Add app og søk etter Firmaradar
  3. Klikk Install

Eksperimentell: privat-app-utvikling

Hvis du vil eksperimentere med å bygge din egen versjon av appen mot egen developer-konto:

  1. Opprett developer-konto på developers.make.com
  2. Opprett ny Custom App via Make → More → Custom Apps → Create a new app
  3. Lim inn innholdet fra app.json, connections/, modules/ og functions/ via Web Code Editor (jsonc-blokker)
  4. Test scenariene mot din egen Make.com-instans

⚠️ Filene i dette repoet er referanse-dokumentasjon av live-appen. De er ikke nødvendigvis 100 % synkronisert med Make sin database i sanntid (Make CLI for source-sync kommer i v0.2).


Konfigurer legitimasjon

Når du legger til en Firmaradar-modul, må du opprette en Firmaradar API-tilkobling:

  1. Klikk Add → Firmaradar → API Key
  2. Lim inn API-nøkkelen din fra firmaradar.no/min-side/api-keys
  3. (Valgfritt) Endre base-URL hvis du kjører selvhostet Firmaradar (default: https://firmaradar.no)
  4. Make tester tilkoblingen mot /api/v1/health/ping automatisk
  5. Lagre

Samme tilkobling gjenbrukes på tvers av alle Firmaradar-moduler i alle scenarier.


Moduler

20 action/search-moduler + 2 instant-triggere, samlet under én Firmaradar-app:

Søk (search-moduler)

  • Search companies — søk på navn eller orgnr, returnerer opptil 100 rader
  • Search persons — fuzzy navne-søk mot aksjonærer og rolleholdere, returnerer stabile person-nøkler

Selskaps-handlinger (action-moduler)

  • Get company — full profil (organisasjonsform, NACE, ansatte, adresse, regnskap, eiere, roller)
  • Get IP portfolio — patenter, varemerker og design fra Patentstyret (dedikert IP-action)
  • Get ownership — konsernhierarki opp og ned, dybde 1–12, valgfri person-inkludering
  • Get roles — styre, daglig leder, prokura (med valgfri fratrådt-historikk)
  • Get financials — årsregnskap og nøkkeltall opptil 10 år tilbake (rå tall for egen beregning)
  • Get financial report (Excel/PDF) — ferdig formatert regnskapsrapport som nedlastbar fil (til forskjell fra «Get financials», som gir rå tall): metadata + kortlevd (15 min) signert nedlastings-URL, opptil 5 regnskapsår, selskap eller konsern (krever excel_feed- eller print_til_pdf-tilgang — se merknad)
  • Get recent changes — endringer siste N dager (rolle, adresse, signal, kunngjøring)

Risiko og KYC

  • Get risk signals — aggregerte risiko-signaler (KYC-kunngjøringer + distress/FIV + mellombalanse) i ett kall
  • Get risk score — transparent 0-100-score med nivå og komponent-breakdown (markedsplass-gated — se merknad)
  • Check company in difficulty (FIV) — foretak-i-vanskeligheter-status etter GBER art. 2(18) (EU-forordning 651/2014), kriteriene a-e, vurdert på to nivåer (selskap og konsern)
  • Check AML/PEP — full AML/PEP-screening med sanksjonslister, audit-log og formåls-tagging (kyc_onboarding / kyc_review / risk_monitoring / manual)
  • Get AML score (deprecert 07-07 — se merknad) — svarer nå kun 202 + rapport_id/poll_url (samme form som «Start AML report»); bruk «Start AML report» + «Get AML report» for nye scenarier

Person

  • Get person roles — full rolle-historikk (aktiv + historisk) på tvers av selskap
  • Get person shareholdings — aksjebeholdninger, eierandeler og total eierverdi

Offentlig støtte

  • Get group public support — direkte + konsern-aggregert offentlig støtte (NAV, Innovasjon Norge, SkatteFUNN, støtteregisteret)

Batch og async (portefølje-screening)

  • Bulk: distress check (FIV) — foretak-i-vanskeligheter for opptil 50 orgnr i ett kall; per-orgnr compliance-gate, 1 enhet/orgnr
  • Bulk: risk score — risikoscore (0-100 + nivå + komponenter) for opptil 50 orgnr i ett kall
  • Start AML report (async) — starter AML-rapport i bakgrunnen (submit → rapport_id + status «pending»); krever DPA-headers, lagres i 60 mnd
  • Get AML report (poll) — poller status/resultat for en async AML-rapport til done/failed

Instant triggers (webhook-baserte)

Starter et scenario når noe skjer i stedet for å polle. Modulen attach-er scenariets Make-webhook-URL som callback hos Firmaradar ved oppretting og detach-er (DELETE) ved fjerning.

  • Watch a company — varsel ved kunngjøring, status-, eier- eller tilskuddsendring for ett orgnr.
  • Watch an industry (NACE) — varsel når et selskap i en NACE-kode endrer seg, med hendelsestype-, geo- (fylke/kommune) og størrelses-filtre.

Valgfri leverings-hemmelighet sendes som Authorization: Bearer; NACE-leveranser signeres i tillegg med X-Firmaradar-Signature. Krever firmaovervåkning på kontoen.

Merknad om «Get risk score» / «Bulk: risk score»: risikoscoring er en markedsplass-gated funksjon. Kontoen din må ha risikoscoring aktivert, og pre-screening-disclaimeren må være bekreftet, ellers svarer handlingen 403. Person-modulene krever full-søk-tilgang; fødselsår maskeres til 4-sifret år.

Merknad om «Get financial report (Excel/PDF)»: krever excel_feed-tilgang (xlsx) eller print_til_pdf-tilgang (pdf) aktivert på kontoen, ellers svarer handlingen 403. Leverer aldri filen inline — svaret er metadata + en kortlevd (~15 min), signert nedlastings-URL. Maks 5 regnskapsår; 1 kreditt per levert regnskapsår.

Merknad om «Get AML score»: POST /api/v1/aml/score er deprecert (Lars-vedtak 2026-07-07, kostnadsmatrise §4.6 + pen-test B1). Kallet svarer nå 202 og starter en asynkron AML-rapport i stedet for å returnere score/level synkront — samme payload-form som «Start AML report», pluss deprecated: true + migreringsmelding. Modulen er kun beholdt for bakoverkompatibilitet med eksisterende scenarier; bygg nye scenarier mot «Start AML report (async)» + «Get AML report (poll)».

v0.2-modulene get_announcements, search_announcements, compare_companies, list_companies_in_nace, find_related_companies og find_shared_connections ligger i modules/ (kilde) og er pushet live til Custom App firmaradar-p9vj9v (07-09) via scripts/make_sdk_push.py (Make Apps SDK-API — camelCase modulnavn getAnnouncements osv. i live-appen). Appen har 25 moduler. Token: secrets/make.env (scopes sdk-apps:read/write, gitignorert). get_aml_score er nå også lagt til i kilden (mirrorer live-modulen getAmlScore, deprecert-kontrakt) — ingen ny push før markedsplass-review er ferdig.


Mal-scenarier

Repoet inneholder en ferdig scenario-mal du kan importere direkte i Make via Scenarios → Create → Import blueprint:

Mal Bruksområde
templates/kyc-screening.json Webhook-trigger (orgnr) → AML/PEP-sjekk + eierskap → router som varsler Slack ved høy risiko og logger til Google Sheets ellers

Priser

Make-appen er gratis. Du betaler kun for Firmaradar-abonnementet ditt etter forbruk:

  • 99 kr/mnd plattformavgift
  • Per-kall-pris avhengig av pakke (se firmaradar.no/prising)
  • Egen rabattert MCP/agent-pakke for høy-volum-arbeidsflyter

Make-kall belastes som vanlige API-kall siden de skjer fra Make sin infrastruktur, ikke fra en AI-agent.


Forholdet til MCP-serveren og n8n-pakken

Denne pakken, Firmaradar MCP-serveren og n8n-pakken er tre grensesnitt til samme datakilde:

Make.com custom app n8n community node MCP-server
Bruksområde Visuelle scenarier, branching, SaaS-integrasjoner Selvhostede arbeidsflyter, avansert scripting AI-agenter (Claude, ChatGPT, Cursor)
Installasjon Make.com app-katalog n8n GUI eller npm install OAuth-tilkobling eller pip install
Auth API-nøkkel (kryptert i Make) API-nøkkel via n8n-legitimasjon OAuth 2.0 eller API-nøkkel
Datakilde Samme Firmaradar API Samme Firmaradar API Samme Firmaradar API

Alle tre bruker samme operasjons-skjema i bunn, så du kan migrere arbeidsflyter mellom dem uten datatap.


Hvorfor åpen kildekode?

  • Transparens — du kan lese hver moduldefinisjon og se nøyaktig hva som sendes til Firmaradar
  • Tillit gjennom gjennomgang — Apache 2.0. Lås til en spesifikk versjon, kjør din egen SBOM-skanning, eller fork-en og kjør som privat-app på din egen Make-konto
  • Bidrag velkommen — vi tar imot pull requests som forbedrer skjemaer eller legger til kompatibilitets-lag for nye Make.com-versjoner

Backend (firmaradar.no) er proprietær fordi den eier dataflyten og lisensieringen mot Skatteetaten og Brønnøysund.


Sikkerhet og GDPR

  • API-nøkkel lagres i Make sin krypterte legitimasjon-store, aldri i klartekst i scenario-JSON
  • Loggføring per kall på Firmaradar-siden (kunde-id, nøkkel-id, endepunkt og status) — eksporteres via DSAR-rapport
  • Person-data pseudonymiseres på serversiden; sikkerhetskopier kryptert og lagret eksternt
  • Make-tilkoblingen sender X-FR-Client: make-firmaradar/0.1 slik at Firmaradar kan skille Make-trafikk fra n8n/MCP/direkte API-bruk i audit-loggen
  • Norsk lov og GDPR-tilpasset: behandlingsgrunnlag, samtykke, oppbevaringstid

Hele sikkerhets-policyen: firmaradar.no/personvern


Repo-struktur

tools/make_app/
├── app.json                          # Top-level metadata (navn, base-URL, headers)
├── connections/
│   └── apiKey.json                   # API-key-tilkobling med test mot /health/ping
├── modules/
│   ├── search_companies.json         # Search-type modul
│   ├── search_persons.json           # Search: person-søk (fuzzy)
│   ├── get_company.json              # Action: full profil
│   ├── get_company_ip.json           # Action: IP-portefølje (Patentstyret)
│   ├── get_ownership.json            # Action: eierskap m/direction + depth
│   ├── get_roles.json                # Action: roller m/role_type + include_retired
│   ├── get_financials.json           # Action: regnskap m/years (rå tall)
│   ├── get_regnskapsrapport.json     # Action: ferdig regnskapsrapport (xlsx/pdf) — gated
│   ├── get_recent_changes.json       # Action: endringer siste N dager
│   ├── get_signals.json              # Action: aggregerte risiko-signaler
│   ├── get_risk_score.json           # Action: risikoscore 0-100 (markedsplass-gated)
│   ├── check_fiv.json                # Action: foretak-i-vanskeligheter (GBER art. 2(18) a-e, selskap+konsern)
│   ├── check_aml_pep.json            # POST: AML/PEP-screening m/purpose
│   ├── get_person_roles.json         # Action: persons rolle-historikk
│   ├── get_person_companies.json     # Action: persons aksjebeholdninger
│   ├── get_konsernstotte.json        # Action: offentlig støtte gjennom konsernet
│   ├── check_fiv_bulk.json           # POST: bulk FIV (opptil 50 orgnr)
│   ├── get_risk_score_bulk.json      # POST: bulk risikoscore (opptil 50 orgnr)
│   ├── start_aml_report.json         # POST: async AML-rapport (DPA-headers) → 202
│   └── get_aml_report.json           # GET: poll async AML-rapport-status
├── functions/
│   └── helpers.iml.js                # IML-helpers (orgnr-validering, error-extract)
├── templates/
│   └── kyc-screening.json            # Eksempel-scenario (KYC-screening)
├── docs/
│   └── index.html                    # GitHub Pages landing-side (engelsk)
├── README.md                         # Denne filen
├── CHANGELOG.md                      # Versjons-historikk
└── LICENSE                           # Apache 2.0

Støtte og spørsmål


Versjons-historikk

Se CHANGELOG.md for full historikk.

  • 0.1.0 — Initial release. 7 moduler (search_companies, get_company, get_ownership, get_roles, get_financials, check_aml_pep, get_recent_changes) + KYC-screening-mal.

Bygget av Firmaradar AS — agentisk infrastruktur for norske selskapsdata.

firmaradar.no  ·  Prising  ·  Dokumentasjon  ·  Personvern  ·  MCP-server  ·  n8n-noder

Releases

Packages

Contributors

Languages