Platform

Casafari ist die KI-Agent-native Plattform für Immobiliendatenintelligenz. Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph für Wohn- und Gewerbeimmobilien, zum Kauf und zur Miete, in 16 Ländern.Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph.

Wie der Graph aufgebaut ist

Bewerten und vergleichen · Anwendungsbeispiel

Wie bewerte ich eine Immobilie anhand von Vergleichsobjekten?

Um eine Immobilie mit Vergleichsobjekten zu bewerten, rufen Sie das Tool comparables_get_comparables auf dem Comparables MCP-Server von Casafari mit einem Kreis oder Polygon, einer Operation (Kauf oder Miete) und den Immobilientypen auf. Ein Aufruf liefert bis zu 50 nach Relevanz sortierte Vergleichsobjekte, aggregierte Marktstatistiken und drei geschätzte Preise: Schnellverkauf, fairer Marktwert und Preis außerhalb des Marktes.

Produkte: Comparables & Valuation, Comparables with Transactions

Kurze Antwort

Ein Aufruf von comparables_get_comparables mit einem location_boundary (ein Kreis um Koordinaten oder eine Adresse, oder ein geschlossenes Polygon), einer operation und comparables_types gibt vergleichbare Immobilien sortiert nach Relevanz, aggregierte statistics und drei estimated_prices zurück. Die gleiche Antwort enthält einen casafari_link, der die Seite zur vergleichenden Marktanalyse öffnet, sowie eine valuation_id.

Schritte

Comparables MCP-Server verbinden und dessen Tool-Liste lesen

  1. Verbinden Sie den Comparables MCP-Server, https://platform.casafari.com/mcp/comparables (Anleitung zur Verbindung). Dessen Tool-Liste (tools/list) beschreibt comparables_get_comparables mit Anweisungen und Eingabeschema, während account_status zeigt, was Ihr Konto nutzen kann. Über Ihren eigenen Code erfolgt die gleiche Anfrage an POST /v1/comparables/search unter https://platform.casafari.com, wobei ein Plattform-API-Schlüssel als Authorization: Bearer $CASAFARI_API_KEY gesendet wird.

Ziel definieren: Koordinaten oder Adresse, Radius in km, Operation Kauf, eine Typengruppe

  1. Setzen Sie location_boundary.circle.target_point auf genau eines der folgenden Felder: coordinates (latitude, longitude), address oder cadastral_reference (nur Spanien).
  2. Legen Sie location_boundary.circle.distance in Kilometern fest, von 0,05 bis 50 (Standardwert 5).
  3. Setzen Sie operation auf sale (oder rent für eine Mietwertermittlung).
  4. Setzen Sie comparables_types auf einen oder mehrere Typen aus einer einzigen Gruppe, zum Beispiel ["apartment"].

Fügen Sie Filter hinzu: bedrooms oder rooms, bathrooms, total_area, condition, characteristics, energy_ratings

  1. Beschreiben Sie das Bewertungsobjekt. Nutzen Sie bedrooms oder rooms (niemals beides), bathrooms, total_area in Quadratmetern, condition (used, ruin, very-good, new, other), characteristics mit must_have-, nice_to_have- und exclude-Listen (wie terrace, elevator, parking) sowie energy_ratings (A+ bis H oder Unknown). Optionale Angaben umfassen construction_year, floors, floor_number, views, orientation, directions, min_price, max_price, days_on_market_from und days_on_market_to.

Rufen Sie comparables_get_comparables mit einem comparables_count von bis zu 50 auf.

  1. Verwenden Sie comparables_get_comparables mit den vier erforderlichen Eingabewerten: comparables_count (1 bis 50), location_boundary, operation und comparables_types sowie Ihren gewünschten Filtern. Über die REST-API senden Sie den entsprechenden JSON-Body an POST /v1/comparables/search.

Beispiel: eine Wohnung mit 3 Schlafzimmern in der Nähe der Avenida da Liberdade, Lissabon

Die Anfrage

Ein Nutzer fragt seinen KI-Assistenten: "Was ist eine Wohnung mit 3 Schlafzimmern in der Nähe der Avenida da Liberdade in Lissabon wert? Verwende Vergleichsobjekte im Umkreis von 1 km." Der Assistent ruft comparables_get_comparables wie folgt auf:

json
{
  "comparables_count": 20,
  "location_boundary": {
    "circle": {
      "target_point": { "address": "Avenida da Liberdade, Lisbon" },
      "distance": 1
    }
  },
  "operation": "sale",
  "comparables_types": ["apartment"],
  "bedrooms": 3
}

Die Antwort

Die Antwort hat folgende Struktur (Werte sind hier ausgelassen; sie hängen vom jeweiligen Markt ab):

json
{
  "results": [
    {
      "property_id": "...",
      "property_url": "...",
      "similarity_score": "...",
      "distance": "...",
      "sale_status": "...",
      "sale_price": "...",
      "sale_currency": "...",
      "sale_price_per_sqm": "...",
      "sale_price_last_change": { "change_date": "...", "old_value": "...", "new_value": "..." },
      "is_outlier": "..."
    }
  ],
  "statistics": { "average_price": "...", "average_price_per_sqm": "...", "average_time_on_the_market": "...", "sold_or_rented_in_last_six_months": "..." },
  "estimated_prices": { "fast_sell_price": "...", "fair_market_price": "...", "out_of_market_price": "...", "fair_market_price_per_sqm": "..." },
  "casafari_link": "...",
  "valuation_id": "..."
}

Der Assistent antwortet daraufhin mit einer Preisspanne und den zugrunde liegenden Vergleichsobjekten.

Ergebnisse lesen

estimated_prices: fair_market_price, fast_sell_price, out_of_market_price

fair_market_price ist die zentrale Schätzung, fast_sell_price der Preis für einen schnellen Verkauf und out_of_market_price das obere Ende des Premium-Segments. Jeder Wert ist auch pro Quadratmeter verfügbar (z. B. fair_market_price_per_sqm). Geben Sie die Spanne vom Schnellverkaufs- bis zum Premium-Preis an, wobei der faire Marktwert als Orientierungspunkt dient. Die Schätzungen werden basierend auf den gefundenen Vergleichsobjekten für die angefragte operation berechnet.

statistics: average_price_per_sqm, average_time_on_the_market, sold_or_rented_in_last_six_months

average_price_per_sqm ermöglicht den Vergleich des Schätzwerts mit dem Mikromarkt. average_time_on_the_market ist die durchschnittliche Vermarktungsdauer: Ein hoher Wert spricht für eine Preisgestaltung näher am Schätzwert für einen schnellen Verkauf. sold_or_rented_in_last_six_months zählt die Immobilien, die in den letzten 6 Monaten am gewählten Standort verkauft oder vermietet wurden; eine niedrige Zahl deutet auf eine dünne Datenbasis hin.

results: similarity_score, distance, is_outlier, sale_price_last_change

Jedes Ergebnis entspricht einer Immobilie im Immobiliengraphen, zusammengefóhrt aus allen Inseraten, sodass Sie Immobilien zählen, nicht Inserate. Der similarity_score (0 bis 1) gibt an, wie stark die Parameter mit Ihrer Anfrage übereinstimmen. distance bezeichnet die Entfernung in Kilometern zum Zielpunkt (wird bei Polygonen nicht berechnet). is_outlier markiert einen Preis, der außerhalb des Rahmens vergleichbarer Objekte liegt. sale_price_last_change nennt Datum sowie alten und neuen Wert der letzten Preisänderung, während sale_status und sold_at anzeigen, ob die Immobilie aktiv, reserviert oder verkauft ist.

Nur Angebotspreise: keine registrierten Abschlusskaufpreise

Jeder Preis in den results ist ein Angebotspreis: Eine als verkauft oder vermietet gekennzeichnete Immobilie behält ihren letzten Angebotspreis; sale_status und sold_at zeigen, was mit ihr geschehen ist. Das Tool liefert keine registrierten Verkaufspreise oder Abschlusskurse; zitieren Sie ein Ergebnis daher nicht als beurkundeten Verkaufspreis. Für registrierte Verkaufspreise neben den Vergleichswerten nutzen Sie Comparables with Transactions: POST /v1/comparables-transactions/search verwendet dieselbe Eingabe.

Abschließend öffnet casafari_link die Seite zur vergleichenden Marktanalyse für diese Bewertung. Mehr zum Produkt finden Sie unter Comparables & Valuation sowie unter Was leistet Comparables & Valuation?.

Einschränkungen

comparables_get_comparables ist im Selbstbedienungsmodus auf der Casafari API und MCP Platform verfügbar (nutzungsabhängige Abrechnung). Bestehende Casafari-Kunden können sich ebenfalls registrieren (Vertragskunden werden für den Custom-Plan eingerichtet). Comparables ist sowohl über REST als auch über MCP als Self-Service verfügbar: POST /v1/comparables/search akzeptiert dieselbe Eingabe wie comparables_get_comparables und liefert dasselbe Ergebnis, einschließlich estimated_prices (siehe Comparables & Valuation REST API). Bestehende Kunden der Legacy API rufen POST /api/v2/comparables/search oder POST /api/v1/valuation/comparables-prices auf. Informationen zu Plattform-Plänen, Tokens und Limits finden Sie unter Limits and usage windows; die Kontingente von Casafari-Kunden richten sich nach ihrem Vertrag, bitte wenden Sie sich dazu an Casafari. Wenn das Kontingent eines Produkts aufgebraucht ist, antworten dessen Tools mit Request limit reached for this product.

Radius 0,05 bis 50 km; 0,5 bis 1 km in städtischen, 2 bis 5 km in ländlichen Gebieten

distance akzeptiert Werte von 0,05 bis 50 km und ist standardmäÙig auf 5 voreingestellt. Die Empfehlung des Tools ist ein enger Radius von 0,5 bis 1 km in städtischen und 2 bis 5 km in ländlichen Gebieten, damit die Vergleichsobjekte denselben Mikromarkt widerspiegeln.

Typen aus einer Gruppe pro Anfrage

Die Gruppen sind apartment, house, room, building, investment, plot und other. Sie können mehrere Typen nur aus einer Gruppe auswählen.

sold_or_rented_after ist standardmäÙig auf vor 9 Monaten eingestellt; null bedeutet nur aktive Immobilien

Geben Sie ein früheres YYYY-MM-DD-Datum an, um ältere Verkäufe oder Vermietungen einzubeziehen, oder übergeben Sie null, um nur Immobilien zu berücksichtigen, die aktuell auf dem Markt sind.

exclude_outliers ist standardmäßig auf true gesetzt

Deutlich zu niedrig oder zu hoch bewertete Immobilien werden ausgeschlossen, es sei denn, Sie setzen exclude_outliers auf false. Die Schätzung basiert ausschließlich auf den gefundenen Vergleichsobjekten und Datensätzen; abgesehen von der Eingabe für die Katasterreferenz (nur für Spanien) nennt die Beschreibung des Tools keine spezifische Marktabdeckung.

In Claude oder ChatGPT abfragen

Property Sourcing verfügt über einen MCP-Server, https://platform.casafari.com/mcp/property-sourcing, sodass ein Assistent dies direkt aus einem Chat heraus ausführen kann. Fügen Sie in Claude oder ChatGPT einen benutzerdefinierten Connector mit dieser URL hinzu; in Claude Code verwenden Sie: claude mcp add --transport http casafari-property-sourcing https://platform.casafari.com/mcp/property-sourcing. Melden Sie sich im Browser mit Ihrem Casafari Platform-Konto an (ein neues Konto beginnt mit dem Plan Free). Fragen Sie dann zum Beispiel:

Wohnungen in Madrid unter 650.000 €, ab 2 Schlafzimmern: Zeige jede mit allen anbietenden Agenturen und ihrer Preishistorie.

Der Assistent findet den Standort mit locations_search (kostenlos), sucht mit property-sourcing_search (5 Tokens pro Seite für bis zu 10 Immobilien, property-sourcing_next_page für weitere), liest jede Immobilie mit property-sourcing_get_property (2 Tokens: alle Agenturen und Portale, die sie bewerben, sowie die Historie der Angebotspreise) und wandelt einen eingefügten Portal- oder Agentur-Link mit property-sourcing_resolve_listing (2 Tokens) in das entsprechende Inserat um. Die Preise sind Angebotspreise. Siehe Property Sourcing.

Fragen

Kann ich eine Vermietung anstelle eines Verkaufs bewerten?

Ja, setzen Sie operation in comparables_get_comparables auf rent, um ein Mietobjekt zu bewerten. Das Tool liefert daraufhin passende Mietobjekte, und statistics sowie estimated_prices beziehen sich auf die Vermietung. Prüfen Sie die rent_period des jeweiligen Vergleichsobjekts (Tag, Woche, zwei Wochen, Monat oder Jahr), bevor Sie die Zahlen vergleichen, und nutzen Sie area-insights_get_time_series_data von Area Insights mit business_type: rent, um die Mietpreisentwicklung einzusehen.

Was ist der Unterschied zwischen dem Marktpreis, dem Schnellverkaufspreis und dem Preis außerhalb des Marktes?

Dies sind drei aus den gefundenen Vergleichswerten berechnete Preispunkte. fair_market_price ist der faire Marktwert, fast_sell_price ist der Preis für einen zügigen Verkauf und out_of_market_price stellt den Premium-Bereich dar, den die Tool-Beschreibung als Premium-Preisgestaltung bezeichnet. Jeder Wert ist auch pro m² verfügbar. Casafari veröffentlicht die zugrunde liegenden Berechnungsformeln nicht.

Kann ich die Immobilien meiner eigenen Agentur aus den Vergleichswerten ausschließen?

Ja, geben Sie den Namen Ihrer Agentur in without_agencies an, um Immobilien von bestimmten Agenturen, Unternehmen oder Quellen auszuschließen; with_agencies bewirkt das Gegenteil. Namen sind Freitext; ein unbekannter Name führt zu keinem Ergebnis. Die Liste der Agenturnamen ist nur über die Legacy API unter api.casafari.com verfügbar (GET /api/v1/references/agencies, für Vertragskunden mit eigenem Anmeldezugang); die Plattform bietet hierfür derzeit noch keine Route. Wenn Sie Ihren eigenen Bestand ausschließen, bleibt die Bewertung unabhängig von den Angebotspreisen, die Sie selbst festlegen.

Warum liefert das Tool weniger Vergleichsobjekte als angefragt?

comparables_count ist ein Maximalwert, keine Garantie. Das Tool liefert nur Immobilien innerhalb Ihres Kreises oder Polygons, die zur Operation, den Objekttypen und den Filtern passen, und schließt Ausreißer standardmäßig aus. Um mehr Ergebnisse zu erhalten, vergrößern Sie die distance, lockern Sie Filter wie bedrooms oder characteristics, setzen Sie sold_or_rented_after auf ein früheres Datum oder setzen Sie exclude_outliers auf false.

Kann ich ein Polygon anstelle eines Kreises übergeben?

Ja, setzen Sie location_boundary.polygon auf eine geschlossene Liste von mindestens 4 Geopunkten (latitude, longitude), deren erster und letzter Punkt identisch sind. Geben Sie entweder ein Polygon oder einen Kreis an, nicht beides. Bei einem Polygon wird das Feld distance in den Ergebnissen nicht berechnet; gewichten Sie die Vergleichsobjekte stattdessen nach similarity_score.

Alle Anwendungsfälle

Tipp: Fügen Sie .md an eine URL an, um den Inhalt als Markdown zu lesen.