CASAFARI API i MCP Platform: dane o nieruchomościach dla agentów AI
Podłącz agentów AI do uporządkowanego grafu nieruchomości w 16 krajach (USA: właśnie wchodzimy, wybrane stany, wyłącznie nieruchomości komercyjne, w Claro AI). Jeden profil, logowanie OAuth 2.1 i serwery MCP dla Claude, ChatGPT oraz własnych systemów.
Platforma platform.casafari.com to samosługowy punkt dostępu do danych o nieruchomościach i analityki lokalizacyjnej CASAFARI przeznaczony dla agentów AI oraz tworzących je zespołów. Jedno konto i wspólny stan tokenów dają dostęp do pięciu serwerów MCP oraz dwóch produktów REST opartych na usuniętym z dubli grafie nieruchomości obejmującym 16 krajów (źródło: developers.casafari.com, październik 2026 r.). Rejestracja w konsoli nie wymaga karty płatniczej.
Większość polskich zespołów dedykowanych innowacjom, analityce i wycenie w nieruchomościach korzysta w codziennej pracy z modeli Claude lub ChatGPT. Dotychczas pozyskiwanie aktualnych danych wiązało się jednak z koniecznością ręcznego pobierania zestawień lub pisania dedykowanych skryptów pobierających dane z portali ogłoszeniowych. CASAFARI API i MCP Platform zmienia ten model, umożliwiając bezpośrednie połączenie agentów sztucznej inteligencji ze zweryfikowanymi danymi rynkowymi.
Czym jest CASAFARI API i MCP Platform?
CASAFARI API i MCP Platform to infrastruktura danych stworzona bezpośrednio z myślą o agentach AI (agent-native). Pozwala ona na bezkonfiguracyjne łączenie asystentów językowych z bazą danych o nieruchomościach, w której każdy obiekt stanowi jeden unikalny rekord z pełną historią zmian cen, statusów i wycofań z rynku.
Standard Model Context Protocol (MCP) umożliwia modelom językowym bezpośrednie wywoływanie predefiniowanych narzędzi i pobranie struktur JSON zamiast przetwarzania nieustrukturyzowanego tekstu. Zamiast wklejać do czatu pliki PDF lub eksporty z arkuszy kalkulacyjnych, agent sam kieruje zapytanie do odpowiedniego serwera MCP. Solution ten powstał z myślą o polskich zespołach proptech, działach analiz sieci franczyzowych, inwestorach indywidualnych i instytucjonalnych oraz rzeczoznawcach majątkowych szukających wiarygodnych danych porównawczych z rynków zagranicznych.
Dlaczego CASAFARI jest platformą natywną dla agentów AI?
Platforma CASAFARI została zaprojektowana od podstaw z uwzględnieniem specyfiki działania agentów sztucznej inteligencji. Architektura rozwiązania opiera się na pięciu kluczowych filarach:
- Jedno konto dla człowieka i agenta: Ten sam profil użytkownika w konsoli obsługuje interakcje w interfejsie graficznym oraz zapytania przesyłane przez autonomiczne skrypty.
- Bezpieczne logowanie OAuth w przeglądarce: Autoryzacja odbywa się bez konieczności kopiowania i wklejania stałych kluczy API do konfiguracyjnych plików tekstowych.
- Narzędzia ze zdefiniowanym trybem do odczytu: 19 z 21 udokumentowanych narzędzi MCP posiada znacznik
readOnlyHint, co zapobiega niekontrolowanym modyfikacjom danych przez model. - Dokumentacja czytelna dla maszyn: Platforma udostępnia punkt wejścia wejścia dla agentów: llms.txt, OpenAPI, auth.md (po angielsku) na obu domenach, pełną specyfikację OpenAPI oraz dokumentację w formacie Markdown.
- Przejrzysty koszt wywołań: Każde narzędzie posiada stały koszt wyrażony w tokenach, widoczny w jego opisie technologicznym.
W przeciwieństwie do tradycyjnego pobierania danych z serwisów ogłoszeniowych, agent otrzymuje ustrukturyzowane i oczyszczone dane w czasie rzeczywistym. Szczegółowe wytyczne techniczne dla programistów zawiera instrukcja podłączenia agenta (po angielsku).
Serwery MCP: jeden na produkt
Każdy produkt w ramach platformy CASAFARI udostępniany jest jako osobny serwer MCP działający w oparciu o protokół Streamable HTTP i autoryzację OAuth 2.1. Wszystkie serwery są dostępne w ramach jednego konta użytkownika.
Location Lookup
Serwer https://platform.casafari.com/mcp/locations służy do zamiany potocznych nazw miejscowości lub dzielnic na jednoznaczne identyfikatory lokalizacyjne (location id). Usługa jest całkowicie bezpłatna i pozostaje darmowa również po zakończeniu okresu próbnego.
Area Insights
Serwer https://platform.casafari.com/mcp/area-insights dostarcza 7 narzędzi analitycznych, w tym szeregi czasowe cen, rozkłady według liczby pokoi i czasu ekspozycji oferty na rynku, wskaźniki zmienności oraz mapy cieplne (district heatmaps). Pozwala to na przykład przeanalizować dla klienta zmianę średnich cen ofertowych w dzielnicach Lizbony lub Madrytu bezpośrednio z poziomu okna rozmowy z agentem.
Comparables
Serwer https://platform.casafari.com/mcp/comparables wyszukuje nieruchomości porównywalne i generuje szacunkową wycenę rynkową wskazanego lokalu. Jest to podstawowe narzędzie wykorzystywane przez analityków kredytowych oraz rzeczoznawców majątkowych. Podłączenie serwera w środowisku Claude Code wymaga wykonania jednego polecenia:
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables
AgentGraph AI
Serwer https://platform.casafari.com/mcp/agentgraph udostępnia 13 narzędzi przeznaczonych do analizy rynku agencji i agentów nieruchomości w Niemczech. System umożliwia weryfikację podmiotów, generowanie map rejonów działania oraz zarządzanie listami obserwowanych firm. Dwa narzędzia zapisujące na tym serwerze wymagają każdorazowo potwierdzenia przez człowieka.
Claro AI
Serwer https://platform.casafari.com/mcp/claro obsługuje wyszukiwanie lokali użytkowych na wynajem i sprzedaż w Hiszpanii oraz działek komercyjnych w Niemczech w oparciu o zapytania w języku naturalnym. Wyniki łączą dane o obiektach z analityką Location Intelligence, uwzględniającą m.in. natężenie ruchu pieszego i strukturę socjodemograficzną.
W praktyce, podczas analizy lokalu pod kawiarnię specialty w Walencji (powierzchnia 40–120 m², budżet do 3 500 € miesięcznie), Claro AI wyselekcjonowało 546 dopasowanych obiektów, z których Claude wyłonił 6 najbardziej perspektywicznych lokalizacji (zapis z 16 października 2026 r.). Podobne analizy przeprowadzono dla sieci klubów fitness w aglomeracjach Madrytu i Barcelony (zawężenie z 483 lokali do 7) oraz dla stacji kontroli pojazdów w Niemczech (zawężenie z 1 279 działek do 6). Więcej szczegółów na temat obsługi zagranicznych lokalizacji można znaleźć w sekcji Business Expansion dla sieci planujących ekspansję w Europie.
Produkty dostępne tylko przez REST na tym samym koncie
Obok serwerów MCP platforma oferuje tradycyjne interfejsy REST API pod adresem https://platform.casafari.com/v1/<produkt>, autoryzowane stałym kluczem API (format cf_sk_...) przesyłanym w nagłówku Authorization: Bearer:
- Property Sourcing: Przeszukiwanie pełnego grafu nieruchomości, pozwalające na wywołanie pełnej historii zmian cen i powiązanych ogłoszeń dla konkretnego obiektu na podstawie linku z portalu.
- High Potential Seller Leads: Identyfikacja nieruchomości z wielokrotnymi obniżkami cen w krótkim czasie. Usługa zwraca wyłącznie zagregowane wskaźniki rynkowe bez danych osobowych klientów.
Pełną dokumentację struktur danych udostępnia specyfikacja OpenAPI platformy.
Rejestracja, plany i tokeny: kto płaci i za co
Rozliczenia na platformie opierają się na jednym spójnym koncie i wspólnej puli tokenów dla wszystkich produktów:
Założenie konta w konsoli pod adresem załóż konto w konsoli platform.casafari.com (bez karty) nie wymaga podawania danych karty płatniczej. Darmowy plan Free przyznaje 1 000 tokenów na pierwsze 30 dni, a zapytania o identyfikatory lokalizacji w Location Lookup pozostają bezpłatne na zawsze. Po wyczerpaniu darmowego limitu przechodzi się na płatny abonament Agent plan, umowę Custom plan lub dokupuje przedpłacone tokeny, które przeliczają się na tokeny.
Każde zapytanie pobiera stałą liczbę tokenów wskazaną w opisie danego narzędzia. Płatności dokonuje zawsze człowiek w konsoli — w przypadku wyczerpania salda agent AI wstrzymuje działanie i nie może samodzielnie dokupić tokenów. Aktualne warunki i pakiety zawiera strona aktualne plany i ceny (po angielsku).
Jak podłączyć agenta: Claude, ChatGPT, Claude Code, Gemini CLI, Cursor i VS Code
Podłączenie interfejsu MCP do popularnych aplikacji zajmuje kilkadziesiąt sekund i nie wymaga kopiowania kluczy dostępowych:
- Claude.ai / Claude Desktop / aplikacja mobilna: W menu wybieramy Customize → Connectors → Add custom connector, wklejamy URL wybranego serwera MCP i zatwierdzamy logowanie OAuth w przeglądarce.
- ChatGPT: W trybie deweloperskim tworzymy nowy konektor, podając URL serwera MCP i konfigurację OAuth.
- Gemini CLI: Rejestracja serwera i autoryzacja wymagają wykonania dwóch poleceń w terminalu:
gemini mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables
/mcp auth
Platforma obsługuje również środowiska Cursor, VS Code, Codex CLI, Zed, Cline, JetBrains Junie, Kiro, Warp oraz goose. Kod źródłowy connectorów udostępnia publiczne repozytorium casafari-mcp na GitHubie.
Bezpieczeństwo: OAuth 2.1, tokeny dostępu i narzędzia tylko do odczytu
Bezpieczeństwo połączeń opiera się na nowoczesnych standardach rynkowych:
- OAuth 2.1 z PKCE: Klient MCP nie wchodzi w posiadanie hasła użytkownika. Krótkożyciowe tokeny dostępu OAuth są przypisane do konkretnego serwera (zgodnie z RFC 8707) i zachowują ważność przez 15 minut, a tokeny odświeżające rotują przy każdym użyciu.
- Uprawnienia i kontrola: Serwer weryfikuje uprawnienia oraz stan tokenów rozliczeniowych przy każdym pojedynczym wywołaniu narzędzia.
- Ochrona przed wstrzykiwaniem poleceń (prompt injection): Odpowiedzi zwracane przez serwery MCP są traktowane wyłącznie jako dane wejściowe dla modelu, a nie instrukcje wykonawcze.
- Narzędzia bezpieczne z natury: 19 z 21 udokumentowanych narzędzi MCP działa wyłącznie w trybie do odczytu.
Szczegółowe procedury i specyfikację techniczną opisuje dokumentacja bezpieczeństwa platformy (po angielsku). Zachęcamy również do zapoznania się z dokumentem, jakim jest nasza polityka prywatności CASAFARI.
Ile to kosztuje?
Rozpoczęcie pracy na platformie jest bezpłatne dzięki pakietowi 1 000 tokenów na pierwsze 30 dni w planie Free. Dalsza eksploatacja odbywa się w oparciu o miesięczną subskrypcję w planie Agent, indywidualne warunki w planie Custom lub doładowania konta poprzez przedpłacone tokeny. Pełne zestawienie opłat znajduje się w sekcji aktualne plany i ceny (po angielsku).
Co dalej: dokumentacja, przykłady i konsola
Aby wypróbować możliwości platformy w praktyce, wystarczy przejść do konsoli pod adresem zaloguj się do platformy lub otworzyć załóż konto w konsoli platform.casafari.com (bez karty).
Dodatkowe materiały techniczne, schematy integracji i przykłady użycia dostępne są na stronie przykłady zastosowań na developers.casafari.com (po angielsku) oraz w przewodniku sześć przykładów pracy Claude z Claro AI (po angielsku). Ogólne informacje o rozwiązaniach dla branży znajdują się na stronie głównej CASAFARI.
W razie pytań dotyczących niestandardowych integracji, nasz zespół służy profesjonalną pomocą i wsparciem technicznym.
Najczęściej zadawane pytania
Czym jest serwer MCP i po co agentowi AI dane CASAFARI?
Model Context Protocol (MCP) to otwarty standard umożliwiający asystentom AI, takim jak Claude czy ChatGPT, bezpieczne wywoływanie narzędzi i odczytywanie ustrukturyzowanych danych. CASAFARI udostępnia na platform.casafari.com pięć serwerów MCP dla poszczególnych produktów: Location Lookup, Area Insights, Comparables, AgentGraph AI oraz Claro AI. Dzięki temu agent AI może bezpośrednio analizować graf nieruchomości zamiast korzystać z ręcznie wklejanych plików PDF czy zestawień w arkuszu (źródło: developers.casafari.com/docs/connect, październik 2026 r.).
Jak podłączyć Claude lub ChatGPT do CASAFARI?
W aplikacji Claude wystarczy przejść do sekcji Customize, wybrać Connectors, dodać własny konektor i wkleić URL wybranego serwera, na przykład https://platform.casafari.com/mcp/comparables, a następnie zalogować się w przeglądarce. W ChatGPT konektor konfiguruje się w trybie deweloperskim, wskazując adres MCP oraz autoryzację OAuth. Cały proces nie wymaga ręcznego kopiowania kluczy API. Zespoły programistyczne mogą również użyć dedykowanych poleceń CLI dla Claude Code lub Gemini CLI, które opisuje instrukcja podłączenia agenta na developers.casafari.com.
Czy korzystanie z platformy jest darmowe na start?
Tak, rejestracja w konsoli na platform.casafari.com nie wymaga podawania karty płatniczej. Plan Free przyznaje 1 000 tokenów na pierwsze 30 dni, a wyszukiwanie lokalizacji w usłudze Location Lookup pozostaje bezpłatne także po tym okresie. Dalsze korzystanie odbywa się w ramach miesięcznej subskrypcji Agent plan, indywidualnej umowy Custom plan lub poprzez przedpłacone tokeny przeliczane na tokeny. Wykaz aktualnych opcji zawiera sekcja cenowa na stronie developers.casafari.com.
Czy agent AI może sam dokupić tokeny?
Nie, agent AI nie ma możliwości samodzielnego zakupu tokenów. Jedno konto i wspólny stan tokenów obsługują wszystkie produkty, przy czym każde wywołanie narzędzia pobiera stałą liczbę tokenów wskazaną w jego opisie. Jeśli saldo tokenów się wyczerpie, działanie agenta zostaje wstrzymane, a doładowania konta w konsoli może dokonać wyłącznie człowiek (źródło: developers.casafari.com/docs/security, październik 2026 r.).
Czy CASAFARI obejmuje polski rynek nieruchomości?
Indeks nieruchomości CASAFARI obejmuje 16 krajów (USA: właśnie wchodzimy, wybrane stany, wyłącznie nieruchomości komercyjne, w Claro AI) (źródło: developers.casafari.com, październik 2026 r.). Poszczególne produkty MCP posiadają określony zasięg geograficzny: AgentGraph AI analizuje rynek niemiecki, a Claro AI obsługuje lokale komercyjne w Hiszpanii oraz działki w Niemczech. Pełną listę aktualnie obsługiwanych rynków można sprawdzić bezpośrednio w dokumentacji platformy.
Czy dane z CASAFARI są bezpieczne i zgodne z RODO?
Dostęp do danych w CASAFARI opiera się na bezpiecznym protokole OAuth 2.1, a aż 19 z 21 udokumentowanych narzędzi MCP działa wyłącznie w trybie do odczytu. Produkt High Potential Seller Leads dostarcza zagregowane sygnały rynkowe bez podawania imion, nazwisk, numerów telefonów czy adresów e-mail klientów indywidualnych, dzięki czemu bezpośredni kontakt zawsze pozostaje po stronie człowieka. Ocena prawna oraz dopasowanie procedur przetwarzania danych pozostają po stronie podmiotu wdrażającego rozwiązanie.