Agent-API för bostäder

KollaHem är ett bostadsindex: normaliserade annonser från mäklarsajterna i ett enhetligt format. 2 195 annonser och 30 786 bilder indexeras just nu. Allt nås via en MCP-server.

MCP-endpoint

Streamable HTTP (även JSON-respons stöds).

https://kollahem.se/api/mcp

Metadata: kollahem-housing-index v1.0.0

Anslut dina verktyg

Claude Desktop

{
  "mcpServers": {
    "kollahem": {
      "url": "https://kollahem.se/api/mcp"
    }
  }
}

Claude Code / Codex

claude mcp add --transport http kollahem https://kollahem.se/api/mcp

ChatGPT (Custom GPT / Actions)

Skapa en Custom GPT och lägg till en Action med OpenAPI-schema:
POST https://kollahem.se/api/mcp  (Content-Type: application/json, JSON-RPC 2.0)

OpenAI Agents SDK (Python)

from agents.mcp.server import MCPServer

server = MCPServer(url="https://kollahem.se/api/mcp")
# Lägg till som tool till din agent

Lokalt (stdio)

Valfri klient som stöder stdio:
npx tsx src/lib/mcp/stdio.ts

# eller via npm-script:
npm run mcp:stdio

Verktyg

search_listings

Sök bostäder med strukturerade filter: pris, m², avgift, rum, byggår, balkongläge, stadsdel, typ, sortering. Ger träffar med uppskattad månadskostnad och käll-URL.

get_listing

Fullständig information om en enskild bostad inkl. beskrivning och alla faktafält.

get_listing_images

Hämta bild-URL:er för en bostad (för visning i klienten).

compare_listings

Jämför 2–5 bostäder sida vid sida: pris, m², avgift, månadskostnad, byggår, energiklass, brf-skuld.

get_district_info

Stadsdelsfakta: skolindex (1–10), restid till centrum, koordinater.

list_districts

Lista alla kända stadsdelar.

estimate_monthly_cost

Kalkyl: avgift + ränta med justerbar belåningsgrad och ränta.

get_source_health

Datakällornas status: senaste uppdatering per källa — för att bedöma datans aktualitet.

save_shortlist / get_shortlist / remove_from_shortlist

Agentens lista över sparade bostäder — samla och anteckna kandidater.

Exempelfrågor

Hitta alla 3:or i Malmö mellan 2,5 och 3,5 mkr med söderbalkong, byggda efter 2005, avgift under 4 500 kr.

search_listings({ city: 'Malmö', price_min: 2500000, price_max: 3500000, balcony: ['south'], build_year_min: 2005, fee_max: 4500, rooms_min: 3 })

Jämför de tre billigaste nyproduktionerna i Västra Hamnen.

search_listings → compare_listings(ids)

Vilken av dessa två ger lägst uppskattad månadskostnad?

compare_listings({ ids: ['sf-464063', 'maklarringen-OBJ5PHF3NG2QRGKCCC9B7'] })

Datakällor och ansvarsfull användning

Annonsdata uppdateras kontinuerligt från mäklarsajterna och normaliseras till ett enhetligt format.
Priser och avgifter kan vara föråldrade — verifiera alltid mot mäklaren innan köp.
Uppskattad månadskostnad antar 4 % ränta, 70 % belåning och 30 % ränteavdrag.
Bilder hämtas via en proxy som cachar vid behov — de speglas inte permanent.