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
- Verbinden Sie den Comparables MCP-Server,
https://platform.casafari.com/mcp/comparables(Anleitung zur Verbindung). Dessen Tool-Liste (tools/list) beschreibtcomparables_get_comparablesmit Anweisungen und Eingabeschema, währendaccount_statuszeigt, was Ihr Konto nutzen kann. Über Ihren eigenen Code erfolgt die gleiche Anfrage anPOST /v1/comparables/searchunterhttps://platform.casafari.com, wobei ein Plattform-API-Schlüssel alsAuthorization: Bearer $CASAFARI_API_KEYgesendet wird.
Ziel definieren: Koordinaten oder Adresse, Radius in km, Operation Kauf, eine Typengruppe
- Setzen Sie
location_boundary.circle.target_pointauf genau eines der folgenden Felder:coordinates(latitude,longitude),addressodercadastral_reference(nur Spanien). - Legen Sie
location_boundary.circle.distancein Kilometern fest, von 0,05 bis 50 (Standardwert 5). - Setzen Sie
operationaufsale(oderrentfür eine Mietwertermittlung). - Setzen Sie
comparables_typesauf 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
- Beschreiben Sie das Bewertungsobjekt. Nutzen Sie
bedroomsoderrooms(niemals beides),bathrooms,total_areain Quadratmetern,condition(used,ruin,very-good,new,other),characteristicsmitmust_have-,nice_to_have- undexclude-Listen (wieterrace,elevator,parking) sowieenergy_ratings(A+bisHoderUnknown). Optionale Angaben umfassenconstruction_year,floors,floor_number,views,orientation,directions,min_price,max_price,days_on_market_fromunddays_on_market_to.
Rufen Sie comparables_get_comparables mit einem comparables_count von bis zu 50 auf.
- Verwenden Sie
comparables_get_comparablesmit den vier erforderlichen Eingabewerten:comparables_count(1 bis 50),location_boundary,operationundcomparables_typessowie Ihren gewünschten Filtern. Über die REST-API senden Sie den entsprechenden JSON-Body anPOST /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:
{
"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):
{
"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.