MCLL Immobilien – Fähigkeiten für KI-Agenten

MCLL Real Estate

MCLL (mcllrealestate.com) ist ein thailändisches Premium-Immobilienunternehmen. Mit dieser Fähigkeit kann ein Agent seine veröffentlichten Inserate durchsuchen und lesen – zum Verkauf und zur Miete, in Bangkok, Phuket und auf den Inseln. Alles hier sind öffentliche, schreibgeschützte Daten; es wird kein Schlüssel oder Login benötigt.

Wählen Sie die Zugriffsmethode, die Ihre Laufzeitumgebung unterstützt. MCP und REST geben die Inserate zurück; Markdown erzeugt auch die Bereichs-, Nachrichten- und Entwicklungsseiten.

1. MCP-Server (am umfangreichsten – bevorzugt)

Streamable-HTTP-MCP-Endpunkt: https://mcllrealestate.com/api/mcp Serverkarte: https://mcllrealestate.com/.well-known/mcp/server-card.json

Drei Werkzeuge:

• search_listings – Inserate finden. Argumente: type ("sale" | "rent", erforderlich), locale (en/fr/th/zh, Standard en), sowie optional city, area, propertyType (menschliche Namen – "Phuket", "Condo"), bedrooms, minPrice, maxPrice (THB), page. Gibt zurück: { total, page, results: [{ id, title, url, transactionType, city, area, bedrooms, bathrooms, areaSqm, priceThb, image }] } – die url jedes Ergebnisses endet mit einem slug, den Sie an get_listing übergeben.
• get_listing – Vollständige Details eines Inserats. Argumente: type ("sale"|"rent"), slug (aus einem Suchergebnis), locale. Gibt Preis, Größe, Merkmale, Koordinaten und eine Markdown-description zurück.
• execute – Code-Modus. Argumente: code (JavaScript-String). Wird in einer Cloudflare-Sandbox mit den globalen Funktionen mcll.search(args) und mcll.get(args) ausgeführt. Kein offenes Netzwerk, Dateisystem, Geheimnisse oder Schreibzugriffe. Verwenden Sie return für das JSON-serialisierbare Ergebnis; await auf oberster Ebene funktioniert. Am besten geeignet zum Vergleichen, Bewerten oder Berechnen von Daten über viele Inserate hinweg in einem einzigen Aufruf.

Beispiel für execute-Code:

const { results } = await mcll.search({ type: "sale", city: "Bangkok", page: 1 });
const details = await Promise.all(
  results.slice(0, 2).map((r) =>
    mcll.get({ type: "sale", slug: r.url.split("/").pop(), locale: "en" }),
  ),
);

return details.map((d) => ({
  title: d.title,
  url: d.url,
  pricePerSqm: d.priceThb && d.areaSqm ? Math.round(d.priceThb / d.areaSqm) : null,
}));

2. REST-API (kein MCP-Client erforderlich)

OpenAPI: https://mcllrealestate.com/api/openapi.json

• Suche – GET /api/listings?type=sale|rent&locale=en plus optionale Filter. Beachten Sie, dass diese Filter IDs (UUIDs) und nicht Namen erwarten: city, area, propertyType, bedrooms, bathrooms, priceMin, priceMax, sizeMin, sizeMax, furnished, features, sort, page. Gibt zurück: { total, page, results }, wobei jedes Ergebnis die gleiche sichere öffentliche Projektion hat wie die MCP-Suche: absolute url, öffentliche Bild-URL, Preis- felder, Stadt-/Gebietsnamen und keine Admin-Felder. (Für namensbasierte Filterung – „Eigentumswohnungen in Phuket“ – verwenden Sie das MCP-Tool search_listings, das Namen automatisch in IDs auflöst.)
• Detail – GET /api/listings/{type}/{slug}?locale=en → ein Inserat als JSON, mit einer Markdown-description. type ist sale oder rent; slug stammt aus dem letzten Pfadsegment der Inserat-URL.

# Detail eines bekannten Inserats (slug aus seiner öffentlichen URL):
curl -s "https://mcllrealestate.com/api/listings/sale/kamala-cliff-villa?locale=en"

# Suche (Verkaufsinserate, Seite 1):
curl -s "https://mcllrealestate.com/api/listings?type=sale&locale=en"

3. Markdown-Inhaltsaushandlung (jede Seite → sauberer Text)

Senden Sie Accept: text/markdown an jede Inserat-, Bereichs-, Nachrichten- oder Entwicklungs-URL und MCLL gibt eine Markdown-Version zurück anstelle von HTML – weit weniger Tokens als das Parsen der Seite. Die Startseite gibt eine Seitenübersicht zurück. Bereiche, Nachrichten und Entwicklungen sind nur auf diesem Weg erreichbar – kein MCP-Tool oder REST-Endpunkt deckt sie ab; finden Sie ihre URLs in der Sitemap.

curl -s -H "Accept: text/markdown" \
  "https://mcllrealestate.com/en/buy/villa/phuket/kamala/kamala-cliff-villa"

Index- und statische Seiten haben keine Markdown-Version und geben HTML zurück – verwenden Sie für diese die Such-API.

Typischer Arbeitsablauf

1. Verwenden Sie execute, wenn der Benutzer nach Vergleichen, Bewertungen oder abgeleiteten Metriken über mehrere Inserate hinweg fragt.
2. Suchen Sie andernfalls nach dem, was der Benutzer möchte (search_listings oder GET /api/listings).
3. Lesen Sie die Ergebnisliste und wählen Sie die relevanten Inserate nach title, area, priceThb aus.
4. Rufen Sie Details für die ausgewählten Inserate ab (get_listing, die Detail-REST-Route oder Markdown über die Inserat-url).
5. Beantworten Sie die Anfrage des Benutzers mit den Fakten des Inserats und verlinken Sie ihn auf die öffentliche url.

Entdeckung und Konventionen

• Sitemaps (jede URL, pro Sprache): https://mcllrealestate.com/sitemap.xml.
• API-Katalog (maschinenlesbarer Index): https://mcllrealestate.com/.well-known/api-catalog.
• Seitenleitfaden für Agenten: https://mcllrealestate.com/llms-full.txt.
• Sprachen: en · fr · th · zh. Nicht veröffentlichte Sprachen fallen auf Englisch zurück.
• Preise sind in THB; priceOnRequest: true (oder priceThb: null) bedeutet, dass der Preis nicht öffentlich ist – sagen Sie „Preis auf Anfrage“, niemals eine Zahl.
• Es werden nur veröffentlichte Inserate zurückgegeben; es gibt keine Authentifizierung und hier ist nichts beschreibbar.