Hurtigstart: API-nøkkel og første spørring

Skaff en API-nøkkel

MCP-klienter med OAuth (Claude.ai, ChatGPT og andre OAuth-klienter): koble til med OAuth i ett klikk. Nøkkelen opprettes automatisk, uten skjema.

REST-API eller manuelt MCP-oppsett: registrer deg på orakel.cloud/signup. API-nøkkelen og oppsettslenken kommer i velkomst-e-posten.

Første spørring (curl)

Autentiser med et bearer-token. Denne spørringen finner norske bedrifter i Bergen med 10 eller flere ansatte:

curl -H "Authorization: Bearer orakel_YOUR_KEY" \
  "https://orakel.cloud/api/companies?q=Bergen&country=NO&minEmployees=10"

Forkortet svar:

{
  "data": [
    {
      "orgNumber": "123456789",
      "name": "Example AS",
      "country": "NO",
      "employeeCount": 42,
      "naceCode1": "62.010"
    }
  ],
  "nextCursor": "clx...",
  "hasMore": true
}

Alle land

Parameteren country godtar NO, FI, SE og DK. Standard er NO. Den samme spørringen mot danske bedrifter:

curl -H "Authorization: Bearer orakel_YOUR_KEY" \
  "https://orakel.cloud/api/companies?q=København&country=DK&minEmployees=10"

Detaljer per register: Brønnøysundregistrene, YTJ, Bolagsverket, CVR.

JavaScript

Vanlig fetch, uten SDK:

const res = await fetch(
  "https://orakel.cloud/api/companies?q=Bergen&country=NO&minEmployees=10",
  { headers: { Authorization: `Bearer ${process.env.ORAKEL_API_KEY}` } },
);
const { data, nextCursor, hasMore } = await res.json();

Koble til en MCP-klient

• OAuth i ett klikk (Claude.ai, ChatGPT og andre OAuth-klienter) er den enkleste veien. Åpne integrasjoner i AI-verktøyet, pek det mot https://orakel.cloud, trykk Connect og godkjenn. Hele oppskriften står i MCP-oppsett.

• Claude Code (utvidelse, anbefalt): legg til markedsplassen, installer, logg inn med OAuth. Ingen konfigurasjonsfil å redigere:

  /plugin marketplace add Heiberg-Industries/orakel-plugin
  /plugin install orakel@orakel

  Arbeidsflytene dukker opp som /orakel:prospect, /orakel:company-deep-dive og så videre.

• Claude Desktop og andre stdio-klienter: installer med npx og legg dette i klientens konfigurasjon:

  {
    "mcpServers": {
      "orakel": {
        "command": "npx",
        "args": ["-y", "@heibergindustries/orakel-mcp@latest"],
        "env": { "ORAKEL_API_KEY": "orakel_YOUR_KEY" }
      }
    }
  }

• HTTP MCP: for klienter som snakker MCP Streamable HTTP (ChatGPT Desktop, agenter i nettleser), send POST rett til https://orakel.cloud/api/mcp med Authorization: Bearer orakel_YOUR_KEY. Ingen npm-installasjon.

Se MCP-verktøy for katalogen over verktøy, og MCP-arbeidsflyter for arbeidsflytene som dukker opp som forslag i Claude Desktop, Claude Code og Cursor.

Vanlige mønstre

Slå opp, berik, send videre. Hent en bedrift på orgNumber, kall berikelsesendepunktet for domene og teknologi, og send resultatet til en CRM-destinasjon du har satt opp.

Nordisk søk. Gå gjennom country for NO, FI, SE og DK for å dekke hele regionen i én omgang.

Filtrer på regnskapstall. Kombiner minRevenue, maxRevenue, minEmployees og maxEmployees for å snevre listene ned til størrelsene som passer kundeprofilen din.