För utvecklare och AI-assistenter

API & MCP

Använd Boinsikt direkt i Claude, ChatGPT eller din egen kod. Publika uppgifter (sök, score, energiklass, grannar, adresser, dokumentlista) kräver ingen nyckel. Köpta rapporter nås med en personlig API-nyckel.

1. Skaffa en API-nyckel

Nycklar skapas under Mitt konto → API-nycklar (logga in först). Nyckeln visas en gång och börjar med bk_. Den ger samma åtkomst som ditt konto: rapporter du köpt (eller din prenumeration) blir läsbara via API och MCP.

Skicka nyckeln som header X-API-Key: bk_… eller Authorization: Bearer bk_…. Exempelföreningen (org.nr 769607-5774) är alltid öppen — testa utan nyckel.

2. Claude (Desktop, claude.ai och Claude Code)

Boinsikt är en MCP-server (Model Context Protocol, Streamable HTTP). Lägg till den som anslutning, så får Claude verktygen search_brf, get_brf, get_nearby, get_addresses, get_report, get_report_full och get_documents.

Claude Code (terminalen):

claude mcp add --transport http boinsikt https://boinsikt.com/api/mcp \
  --header "X-API-Key: bk_DIN_NYCKEL"

Claude Desktop / claude.ai — Inställningar → Anslutningar (Connectors) → Lägg till anpassad anslutning:

Namn:  Boinsikt
URL:   https://boinsikt.com/api/mcp
Header: X-API-Key: bk_DIN_NYCKEL   (valfritt – behövs för köpta rapporter)

Exempel på vad du sedan kan fråga: ”Jämför Brf Salabacke i Uppsala med de fyra närmaste föreningarna på skuldsättning och avgift” eller ”Sammanfatta riskerna i senaste årsredovisningen för org.nr 769607-5774”.

3. ChatGPT

Som MCP-anslutning (ChatGPT med anpassade kopplingar/Developer mode): lägg till en ny MCP-server med URL https://boinsikt.com/api/mcp och headern X-API-Key.

Som Custom GPT med Actions: skapa en GPT → Actions → importera schemat från

https://boinsikt.com/api/openapi.json

Välj autentisering API Key, header-namn X-API-Key, och klistra in din nyckel. GPT:n kan då söka föreningar och hämta rapporter du köpt.

4. REST-API

Bas-URL: https://boinsikt.com/api. Alla svar är JSON.

Endpoint	Beskrivning	Nyckel
`GET /brf/search?q=`	Sök på namn eller org.nr	—
`GET /brf/{org}`	Översikt: score, energiklass, tillgängliga år, skäl bakom poängen	—
`GET /brf/{org}/nearby`	Närmaste föreningar med avstånd och nyckeltal	—
`GET /brf/{org}/addresses`	Gatuadresser i fastigheten	—
`GET /brf/{org}/geometry`	Fastighets- och byggnadspolygoner	—
`GET /brf/{org}/documents`	Dokumentlista (årsredovisning, stadgar, energideklaration)	—
`GET /reports/{org}`	Köpt rapport: nyckeltal, sammanfattning, styrkor, risker	Ja
`GET /reports/{org}/full`	Hela extraherade årsredovisningen (JSON)	Ja
`GET /reports/{org}/details`	Byggnader med energidata, försäljningar, annonser	Ja
`GET /brf/{org}/documents/{id}/file`	Ladda ner dokument (PDF)	Ja

Exempel

curl "https://boinsikt.com/api/brf/search?q=Salabacke"

curl -H "X-API-Key: bk_DIN_NYCKEL" "https://boinsikt.com/api/reports/769607-5774/full"

OpenAPI-schema: https://boinsikt.com/api/openapi.json. MCP-endpoint: https://boinsikt.com/api/mcp (JSON-RPC 2.0 via POST).

Villkor i korthet

Data får användas i egna analyser och verktyg. Rapportinnehåll (nyckeltal, analys, dokument) är knutet till det konto som köpt rapporten och får inte vidaredistribueras. Publika uppgifter kan citeras med källa Boinsikt.