Dokumentation

Agent-API för bostäder

AI-Mäklare är ett bostadsindex: normaliserade annonser från öppna mäklarkällor i ett enhetligt format. 1 000 annonser och 1 000 bilder indexeras just nu (backend: supabase). Allt konsumeras via ett MCP-server.

MCP-endpoint

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

https://www.aimaklare.com/api/mcp

Metadata: ai-maklare-housing-index v1.0.0

Anslut dina verktyg

Claude Desktop

{
  "mcpServers": {
    "ai-maklare": {
      "url": "https://www.aimaklare.com/api/mcp"
    }
  }
}

Claude Code / Codex

claude mcp add --transport http ai-maklare https://www.aimaklare.com/api/mcp

ChatGPT (Custom GPT / Actions)

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

OpenAI Agents SDK (Python)

from agents.mcp.server import MCPServer

server = MCPServer(url="https://www.aimaklare.com/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, kvm, 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, kvm, 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 färskhet.

save_shortlist / get_shortlist / remove_from_shortlist

Agentens kortlista för att 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 verklig månadskostnad?

compare_listings({ ids: ['sf-464063', 'seed-01'] })

Datakällor & ansvarsfull användning

• Annonsdata uppdateras kontinuerligt från mäklarnas publikationer 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 % skatteavdrag.
• Bilder hämtas via en lazy-cache-proxy — speglas inte permanent.