Platform

Η Casafari είναι η πλατφόρμα ευφυΐας δεδομένων ακινήτων για AI πράκτορες. Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων για οικιστικά και εμπορικά ακίνητα, προς πώληση και προς ενοικίαση, σε 16 χώρες.Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων.

Πώς δομείται ο γράφος

Casafari API και Πλατφόρμα MCP

Η Casafari είναι η πλατφόρμα ευφυΐας δεδομένων ακινήτων για AI πράκτορες. Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων για οικιστικά και εμπορικά ακίνητα, προς πώληση και προς ενοικίαση, σε 16 χώρες.

Κάθε ακίνητο στον γράφο ακινήτων αποτελεί μία εγγραφή, η οποία έχει συγχωνευθεί από κάθε πηγή που το διαφημίζει και έχει υποστεί καθαρισμό, μαζί με το πλήρες ιστορικό του: κάθε αλλαγή τιμής, κάθε αλλαγή κατάστασης, πότε εμφανίστηκε στην αγορά και πότε αποσύρθηκε. Τόσο οικιστικά όσο και επαγγελματικά ακίνητα, προς πώληση και προς ενοικίαση. Πώς δομείται ο γράφος ακινήτων.

Οι MCP servers της Casafari συνδέουν βοηθούς AI και πράκτορες σε αυτόν ως εργαλεία Model Context Protocol: αναζήτηση τοποθεσίας, comparables και εκτιμήσεις, area insights, καθώς και ανάλυση κτηματομεσιτικών γραφείων και πρακτόρων. Αποτελούν μέρος του Casafari API και MCP Platform: ένας MCP server για κάθε προϊόν, https://platform.casafari.com/mcp, μία σύνδεση και μία είσοδος OAuth (κάθε προϊόν αποτελεί επίσης δικό του server).

Τα ίδια δεδομένα είναι επίσης διαθέσιμα μέσω του REST API της πλατφόρμας (https://platform.casafari.com/v1/<product>, 37 λειτουργίες, τα ίδια API keys πλατφόρμας και tokens με τους διακομιστές MCP. Οι πελάτες της Casafari με συμβόλαιο διατηρούν επίσης τις παλιές διαδρομές στο https://api.casafari.com, στη σελίδα Legacy API). Τα έγγραφα είναι οργανωμένα ανά προϊόν και κάθε προϊόν παραθέτει τα εργαλεία MCP και τις λειτουργίες REST του. Το Σύγκριση MCP και REST δείχνει πού αλληλεπικαλύπτονται και πού όχι.

Είστε ήδη πελάτης του Casafari API; Το token σας εξακολουθεί να λειτουργεί και η αναφορά του υπάρχοντος API βρίσκεται πλέον σε αυτόν τον ιστότοπο. Συνδεθείτε στον λογαριασμό API σας για να δείτε το token σας.

Endpoints

Ένας MCP server για κάθε προϊόν (Streamable HTTP, είσοδος OAuth 2.1 μέσω browser, δεν απαιτείται αντιγραφή κλειδιού):

text
https://platform.casafari.com/mcp

Στο Claude ή στο ChatGPT, προσθέστε έναν custom connector με όνομα Casafari με αυτό το URL· στο Claude Code: claude mcp add --transport http casafari https://platform.casafari.com/mcp. Εναλλακτικά, ένα προϊόν τη φορά, όπου κάθε προϊόν βρίσκεται στον δικό του server. Βήματα για Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, Zed και άλλους clients: Σύνδεση και Σύνδεση στο Casafari Platform.

Είστε ήδη πελάτης της Casafari; Χρησιμοποιήστε τον ίδιο server: εγγραφείτε στη διεύθυνση https://platform.casafari.com/console/ και, εάν έχετε συμβόλαιο, η Casafari θα ρυθμίσει τον λογαριασμό σας στο πρόγραμμα Custom. Το mcp.casafari.com είναι η πύλη παλαιού τύπου, η οποία εξακολουθεί να ανταποκρίνεται, μεταβαίνοντας στο https://platform.casafari.com/mcp/<product>.

Κάθε server δημοσιεύει τη δική του κάρτα στη διεύθυνση <server URL>/.well-known/mcp/server-card.json· η κάρτα του ενός server βρίσκεται στη διεύθυνση https://platform.casafari.com/mcp/.well-known/mcp/server-card.json. Είσοδος: Authentication.

Το Claro AI είναι επίσης ένα προϊόν της πλατφόρμας· με API key της πλατφόρμας αντί για OAuth, ανατρέξτε στο Σύνδεση Claro.

Προϊόντα

ΠροϊόνΕργαλεία MCPΛειτουργίες RESTΤι απαντά
Property Sourcing55Βρείτε ακίνητα στον γράφο ακινήτων, όπου κάθε ακίνητο αποτελεί μία εγγραφή ανεξάρτητα από το πόσα μεσιτικά γραφεία και πύλες το διαφημίζουν: αναζητήστε με δομημένα φίλτρα ή σε φυσική γλώσσα, πλοηγηθείτε στα αποτελέσματα, δείτε ένα ακίνητο με όλα τα σημεία όπου διαφημίζεται και το ιστορικό τιμών του, και αντιστοιχίστε έναν σύνδεσμο πύλης ή γραφείου ή μια αναφορά στο ακίνητο στο οποίο ανήκει. REST και MCP.
High Potential Seller Leads—2Ακίνητα με πιθανότητα πώλησης: ακίνητα γύρω από ένα σημείο των οποίων η τιμή ζήτησης μειώθηκε επανειλημμένα, τον αριθμό των μειώσεων και το συνολικό ποσό, καθ' όλη τη διάρκεια της παρουσίας τους στην αγορά ή από μια συγκεκριμένη ημερομηνία. Κάθε lead παραπέμπει στο ακίνητο και το ιστορικό τιμών του. Μόνο μέσω REST. Διαθέσιμο σε Ισπανία, Γαλλία, Ιταλία, Γερμανία, Ελλάδα και Ανδόρα.
Private Seller Leads33Κατοικίες που διατίθενται απευθείας από τους ιδιοκτήτες τους, από πρόσφατα δημοσιευμένες αγγελίες: πρώτη εμφάνιση στην τοποθεσία από μια συγκεκριμένη ημερομηνία και μετά (το πολύ έως 90 ημέρες πριν), ταξινομημένες από τις νεότερες, με σύνδεσμο προς την πύλη, τιμή, επιφάνεια, στρογγυλοποιημένες συντεταγμένες καθώς και το δημοσιευμένο όνομα και τηλέφωνο του πωλητή.
Comparables & Valuation11Συγκρίσιμα ακίνητα και εκτιμώμενες τιμές για ένα ακίνητο: ακίνητα που βρίσκονται στην αγορά ή έχουν αποσυρθεί ως πωληθέντα ή ενοικιασμένα, μόνο με τις τιμές ζήτησής τους, ταξινομημένα γύρω από ένα σημείο, μια διεύθυνση ή έναν κτηματολογικό αριθμό.
Comparables with Transactions11Ό,τι επιστρέφει το Comparables, συν καταγεγραμμένες τιμές κλεισίματος: συμβολαιογραφικές πράξεις στην Ισπανία, καταγεγραμμένες πωλήσεις από την Agenzia delle Entrate στην Ιταλία, το επίσημο μητρώο RCN στην Πολωνία (transactional_data) και το δημόσιο μητρώο DVF στη Γαλλία (dvf_results). Η ίδια είσοδος δεδομένων με το Comparables.
Area Insights1010Πληροφορίες για μια περιοχή: τιμές, προσφορά και δραστηριότητα με την πάροδο του χρόνου, κατανομές ανά τιμή, υπνοδωμάτια και χρόνο παραμονής στην αγορά, καθώς και ανάλυση αγοράς. Μέσω MCP διατίθενται επίσης δείκτες ανάπτυξης και μεταβλητότητας, καθώς και χάρτες θερμότητας ανά περιοχή.
New Market Leads——Ροές ειδοποιήσεων που παρακολουθούν τον γράφο ακινήτων βάσει επιλεγμένων φίλτρων: νέα ακίνητα, αυξήσεις και μειώσεις τιμών, κρατήσεις, αποσύρσεις από την αγορά και πωλήσεις. Δημιουργήστε μια ροή, διαβάστε τις ειδοποιήσεις της ή λάβετε τις στο webhook σας. Υπό συντήρηση.
References——Τα αιτήματα δεδομένων αναφοράς βασίζονται σε: τύπους ακινήτων, χαρακτηριστικά και καταστάσεις, μεσιτικά γραφεία, μεσίτες και τις πηγές από τις οποίες έχει οικοδομηθεί ο γράφος, τοποθεσίες με αυτόματη συμπλήρωση (typeahead) και όρια ταχυδρομικών κωδίκων.
Cadastre5—Ισπανικά κτηματολογικά αρχεία και τιμές αναφοράς ζωνών: αναζήτηση ακινήτου με βάση τον κτηματολογικό αριθμό, τη διεύθυνση ή τις συντεταγμένες, ανάγνωση του αρχείου στο κτηματολόγιο και της τιμής αναφοράς της ζώνης ή κάθε ζώνης ενός δήμου. Ισπανία, εκτός Ναβάρας και Χώρας των Βάσκων.
Parcel Zoning26Πολεοδομικά στοιχεία και δόμηση ενός αγροτεμαχίου, βάσει κτηματολογικού αριθμού ή συντεταγμένων. Διαθέσιμα για Ισπανία (Bizkaia, Καταλονία και ακίνητα με καταγεγραμμένους εμπορικούς χώρους στην περιοχή της Μαδρίτης και στην Κοινότητα της Βαλένθια) και Γερμανία (Αμβούργο, Βόρεια Ρηνανία-Βεστφαλία).

Claro AI

Claro AI είναι ο πράκτορας αναζήτησης για την επιχειρηματική επέκταση της Casafari για επαγγελματικούς χώρους στην Ισπανία και τη Γερμανία. Είναι ένα προϊόν της πλατφόρμας: διαθέτει τον δικό του MCP server και REST API στην πλατφόρμα, με κλειδί πλατφόρμας ή μέσω OAuth της πλατφόρμας. Σύνδεση Claro.

Πώς ονομάζονται τα εργαλεία

Κάθε server ονομάζει τα εργαλεία του ως <server>_<tool>: το πρόθεμα είναι το τελευταίο τμήμα του URL του server, ενώ το υπόλοιπο είναι το όνομα του ίδιου του εργαλείου, για παράδειγμα comparables_get_comparables, area-insights_get_heatmap ή property-sourcing_search. Τα εργαλεία του Location Lookup είναι τα locations_search και locations_get, ενώ κάθε server διαθέτει επίσης το account_status. Καλείτε πάντα ένα εργαλείο με το πλήρες όνομά του, όπως εμφανίζεται στη λίστα του server.

Ένα API για πράκτορες AI

Η Casafari είναι ένα API για πράκτορες AI σε δύο μορφές, βασισμένο στον ίδιο γράφο ακινήτων:

  • Ο MCP server (https://platform.casafari.com/mcp, για κάθε προϊόν ή ένας ανά προϊόν στη διεύθυνση https://platform.casafari.com/mcp/), για πράκτορες που ανακαλύπτουν τα εργαλεία και αποφασίζουν ποιο θα καλέσουν: στο Claude, το ChatGPT και άλλους MCP clients, ή από τον δικό σας κώδικα μέσω του OpenAI API ή του Claude API.
  • Το REST API (αναφορά), για πράκτορες και εφαρμογές των οποίων ο κώδικας πραγματοποιεί συγκεκριμένα αιτήματα.

Αυτά τα έγγραφα έχουν γραφτεί και για πράκτορες: κάθε σελίδα είναι σε μορφή Markdown και το /llms.txt τις ευρετηριάζει όλες.

Tokens, πληρωμές και επαλήθευση

Κάθε κλήση κοστίζει έναν σταθερό αριθμό tokens στον λογαριασμό σας στην πλατφόρμα. Ορισμένα εργαλεία κοστίζουν λιγότερο μέσω MCP από την ίδια κλήση μέσω REST: κόστος κλήσης. Το account_status, σε κάθε διακομιστή, εμφανίζει το πλάνο και το υπόλοιπό σας. Όταν τα tokens εξαντληθούν, το εργαλείο απαντά με ένα σφάλμα πληρωμής που περιέχει έναν σύνδεσμο για ανανέωση, χωρίς να απαιτείται συνδρομή (ο κάτοχος του λογαριασμού ή ένα μέλος με δικαίωμα χρέωσης τον ανοίγει και πληρώνει). Όρια ανά πλάνο: Όρια.

Ξεκινήστε με μια τοποθεσία

Τα περισσότερα εργαλεία δεδομένων απαιτούν μια τοποθεσία ως ids, έναν κύκλο ή ένα πολύγωνο αντί για ένα όνομα: επιλύστε πρώτα ένα όνομα τοποθεσίας σε ids με το locations_search του Location Lookup (https://platform.casafari.com/mcp/locations, δωρεάν).

Διαβάστε αυτά τα έγγραφα ως Markdown

Κάθε σελίδα διαθέτει μια έκδοση Markdown: προσθέστε .md στο URL της ή στείλτε Accept: text/markdown. Το /llms.txt παραθέτει κάθε σελίδα και εργαλείο. Το /llms-full.txt είναι ολόκληρη η αναφορά σε ένα αρχείο. Περισσότερα στο Για πράκτορες AI.

Ερωτήσεις και απαντήσεις

Ποια διεύθυνση να χρησιμοποιήσω: api.casafari.com ή platform.casafari.com (το mcp.casafari.com είναι η παλαιότερη πύλη);

Οι νέοι χρήστες και όλοι οι χρήστες MCP ξεκινούν από το platform.casafari.com, την πλατφόρμα αυτοεξυπηρέτησης της Casafari. Οι υφιστάμενοι πελάτες της Casafari διατηρούν το api.casafari.com για REST, ενώ το mcp.casafari.com αποτελεί την παλαιότερη πύλη, η οποία εξακολουθεί να ανταποκρίνεται, αν και μεταφέρεται σταδιακά στην πλατφόρμα.

Αν είστε νέος στην Casafari: χρησιμοποιήστε το https://platform.casafari.com.

  • Οι ψηφιακοί βοηθοί συνδέονται μέσω MCP στη διεύθυνση https://platform.casafari.com/mcp, μια ενιαία διεύθυνση για κάθε προϊόν. Κάθε προϊόν διαθέτει επίσης τον δικό του διακομιστή στη διεύθυνση https://platform.casafari.com/mcp/<product>, για παράδειγμα https://platform.casafari.com/mcp/comparables.
  • Ο κώδικας καλεί το REST στο https://platform.casafari.com/v1/<product> για account, locations, area-insights, property-sourcing, seller-leads, private-sellers, comparables, comparables-transactions, parcel-zoning και claro. Το High Potential Seller Leads είναι μόνο REST, ενώ κάθε άλλο προϊόν διαθέτει διακομιστή MCP.

Εγγραφείτε, δοκιμάστε την υπηρεσία χωρίς κάρτα και πληρώστε ανάλογα με τη χρήση: πώς να εγγραφείτε.

Αν είστε πελάτης της Casafari: η υπάρχουσα ενοποίηση REST διατηρεί το https://api.casafari.com, το Legacy API, με τη σύνδεση και το συμβόλαιο που ήδη έχετε. Εκεί δεν αλλάζει τίποτα: δεν απαιτείται μετεγκατάσταση ούτε σύνδεση λογαριασμών. Για νέες εργασίες, συμπεριλαμβανομένου του Property Sourcing, μπορείτε να χρησιμοποιήσετε τις διαδρομές της πλατφόρμας. Για το MCP, χρησιμοποιήστε την πλατφόρμα αυτοεξυπηρέτησης όπως όλοι οι άλλοι: εγγραφείτε στο https://platform.casafari.com/console/ και, αν έχετε συμβόλαιο, η Casafari θα ορίσει τον λογαριασμό σας στο Custom. Λεπτομέρειες: Υπάρχοντες πελάτες API και τι αλλάζει για εσάς.

Πλήρεις διευθύνσεις URL: URL διακομιστή MCP και URL βάσης REST.

Μόνιμος σύνδεσμος: /docs/faq/which-address-do-i-use

Πώς μπορώ να αποκτήσω ένα API key και να πραγματοποιήσω την πρώτη μου κλήση;

Δημιουργήστε έναν λογαριασμό στο https://platform.casafari.com (το πλάνο Free δεν απαιτεί κάρτα), δημιουργήστε στη συνέχεια ένα API key στην κονσόλα και αποστείλετε το με την πρώτη σας κλήση.

  1. Δημιουργήστε ένα κλειδί (cf_sk_…) στην κονσόλα. Εμφανίζεται μόνο μία φορά, επομένως αποθηκεύστε το αμέσως και μην το εισάγετε ποτέ σε URL.
  2. Πραγματοποιήστε την κλήση GET https://platform.casafari.com/v1/locations/search?query=Lisbon με το κλειδί στην κεφαλίδα X-API-Key ή ως Authorization: Bearer <api_key>. Οι αναζητήσεις τοποθεσιών κοστίζουν 0 tokens, επομένως αυτή η πρώτη κλήση είναι δωρεάν.

Οι βοηθοί AI δεν χρειάζονται key: προσθέστε τον διακομιστή MCP ενός προϊόντος και συνδεθείτε με OAuth (σύνδεση πελάτη). Ένας λογαριασμός Free διαθέτει 1 μέλος και 2 API keys, ο Agent διαθέτει 1 μέλος και 3 keys, ο Agency διαθέτει 5 μέλη και 10 keys (τιμολόγηση). Το τι περιλαμβάνει η δοκιμαστική έκδοση αναφέρεται στη δωρεάν δοκιμή. Η αναφορά REST βρίσκεται στο REST API και στα API keys πλατφόρμας.

Οι υφιστάμενοι πελάτες της Casafari διατηρούν τα στοιχεία σύνδεσής τους στο Casafari REST API (Υφιστάμενοι πελάτες API).

Μόνιμος σύνδεσμος: /docs/faq/how-to-sign-up

Τι είναι τα tokens στην πλατφόρμα της Casafari;

Τα tokens είναι ο τρόπος με τον οποίο η πλατφόρμα της Casafari μετρά τη χρήση: κάθε κλήση κοστίζει έναν συγκεκριμένο αριθμό tokens, ενώ ορισμένες κλήσεις κοστίζουν λιγότερο μέσω βοηθού τεχνητής νοημοσύνης (AI assistant) ή MCP, απ' ό,τι μέσω του API.

  • Οι αναζητήσεις τοποθεσίας (Location Lookup) και ο έλεγχος κατάστασης λογαριασμού παρέχονται δωρεάν.
  • Το κόστος κάθε λειτουργίας REST αναγράφεται στη σχετική σελίδα στην αναφορά REST, ενώ οι κεφαλίδες απόκρισης Casafari-Units-Charged και Casafari-Units-Remaining σάς ενημερώνουν για το κόστος της κλήσης και το υπόλοιπο των tokens σας.
  • Στη σελίδα Τιμολόγηση θα βρείτε μια συγκριτική παρουσίαση του κόστους των συνήθων κλήσεων μέσω API και βοηθών τεχνητής νοημοσύνης, καθώς και πληροφορίες για τα προγράμματα και το κόστος των tokens.
  • Πληροφορίες σχετικά με το πόσα tokens επιτρέπει το κάθε πρόγραμμα να χρησιμοποιήσετε εντός 3 ωρών ή 7 ημερών, καθώς και τι συμβαίνει όταν αυτά εξαντληθούν, θα βρείτε στη σελίδα Όρια και παράθυρα χρήσης.

Για να δείτε την κατάσταση του λογαριασμού σας, ζητήστε από τον βοηθό να καλέσει το account_status ή πραγματοποιήστε την κλήση GET /v1/account.

Μόνιμος σύνδεσμος: /docs/faq/what-are-tokens

Ο AI agent μου αναφέρει ότι απαιτείται πληρωμή ή ότι ξέμεινα από tokens. Τι πρέπει να κάνω;

Στην πλατφόρμα αυτοεξυπηρέτησης, ένα σφάλμα πληρωμής συνοδεύεται από έναν σύνδεσμο πληρωμής: ο χρήστης τον ανοίγει και πληρώνει, ή περιμένει την ανανέωση του παραθύρου χρήσης για να επαναλάβει την κλήση ο πράκτορας.

  1. Τα tokens εξαντλήθηκαν: το REST επιστρέφει 402 payment_required μαζί με ένα upgrade_url και μια κεφαλίδα Link με rel="payment"· ένας MCP server της πλατφόρμας επιστρέφει σφάλμα πληρωμής με τον ίδιο σύνδεσμο (σελίδα σφάλματος).
  2. Ένα παράθυρο χρήσης 3 ωρών εξαντλήθηκε και δεν απομένουν διαθέσιμα credits: Το REST επιστρέφει 429 usage_limit_reached με τον χρόνο αναπλήρωσης, μια κεφαλίδα Retry-After και ένα upgrade_url για την αγορά credits· το MCP επιστρέφει ένα σφάλμα πληρωμής με τα ίδια στοιχεία.
  3. Το όριο δαπανών επιτεύχθηκε: 402 payment_required με αιτιολογία spending_cap_reached, μέχρι τη λήξη της περιόδου ή την αύξηση του ορίου.

Μόλις ο χρήστης ολοκληρώσει την πληρωμή, ο agent ελέγχει περιοδικά με GET /v1/account/payment-links/{id} κάθε 5 δευτερόλεπτα περίπου μέχρι η κατάσταση να γίνει completed και στη συνέχεια επαναλαμβάνει το αίτημα.

Ο agent δεν μπορεί να πραγματοποιήσει πληρωμή μόνος του (μπορεί ένας agent να πληρώσει;)· τα credits ανανεώνονται αυτόματα μόνο εάν ο χρήστης έχει ενεργοποιήσει την αυτόματη ανανέωση. Δεν υπάρχει επίσημη οδηγία για το αν ένας βοηθός χρειάζεται επανασύνδεση μετά την πληρωμή. Δείτε σχετικά με τη διαχείριση του σφάλματος 402 και τα credits.

Το όριο χρήσης (quota) σε ένα συμβόλαιο Casafari REST API λειτουργεί διαφορετικά: δείτε quota έναντι tokens.

Μόνιμος σύνδεσμος: /docs/faq/agent-ran-out-of-tokens

Μπορώ να διαβάσω αυτήν την τεκμηρίωση σε μορφή Markdown και υπάρχει αρχείο llms.txt;

Ναι: προσθέστε .md στο URL οποιασδήποτε σελίδας ή στείλτε Accept: text/markdown· το /llms.txt ευρετηριάζει κάθε σελίδα και εργαλείο. Δεν απαιτείται κλειδί για καμία από αυτές τις ενέργειες.

  • Το /llms.txt αποτελεί το ευρετήριο και το /llms-full.txt περιέχει ολόκληρη την τεκμηρίωση σε ένα αρχείο.
  • Το /tools.json παρέχει το όνομα, τον τίτλο, το σχήμα εισόδου και το σχήμα εξόδου για κάθε εργαλείο.
  • Θα βρείτε επίσης τον κατάλογο API, την κάρτα διακομιστή MCP, τις δεξιότητες agent, το μανιφέστο πόρων AI και τον χάρτη ιστότοπου στη διεύθυνση /sitemap.xml.
  • Οι αποκρίσεις σε μορφή Markdown παρέχονται ως text/markdown, με επικεφαλίδα x-markdown-tokens που εκτιμά το μέγεθός τους.
  • Σε προγράμματα περιήγησης που υποστηρίζουν το navigator.modelContext, οι σελίδες καταχωρούν αυτά τα εργαλεία WebMCP: search_casafari_mcp_docs, get_casafari_tool_reference, get_casafari_rest_operation, get_casafari_connection_config και open_casafari_docs_page.
  • Η πλατφόρμα self-serve δημοσιεύει τα δικά της https://platform.casafari.com/llms.txt και https://platform.casafari.com/llms-full.txt, καθώς και ένα OpenAPI για κάθε προϊόν.

Δείτε: Για AI agents.

Μόνιμος σύνδεσμος: /docs/faq/machine-readable-docs

Όλες οι ερωτήσεις

Συμβουλή: προσθέστε .md σε οποιοδήποτε URL για να το διαβάσετε ως Markdown.