idealista

Umiejętność do zapytań API Idealista za pośrednictwem lokalnego narzędzia idealista-cli. Zaloguj się przy użyciu OAuth2 (client credentials), a następnie wyszukuj nieruchomości, filtruj po lokalizacji, typie operacji i cenie. Otrzymuj wyniki w formacie podsumowania lub obliczaj statystyki cenowe dla wybranych obszarów. Idealne dla agentów AI, które muszą odpowiadać na pytania o rynek nieruchomości w Polsce i Hiszpanii.

1. Zainstaluj idealista-cli, klonując repozytorium: git clone https://github.com/quifago/idealista-cli do katalogu domowego. Upewnij się, że masz zainstalowany Python 3.

2. Skonfiguruj poświadczenia OAuth2. Ustaw zmienne środowiskowe IDEALISTA_API_KEY (client_id) i IDEALISTA_API_SECRET (client_secret) w terminalu, lub zapisz je trwale za pomocą polecenia: python3 -m idealista_cli config set --api-key "TWOJ_CLIENT_ID" --api-secret "TWOJ_CLIENT_SECRET". Konfiguracja zostanie zapisana w ~/.config/idealista-cli/config.json.

3. Uzyskaj token dostępu, uruchamiając: python3 -m idealista_cli token. Token zostanie automatycznie buforowany. Jeśli token wygaśnie, odśwież go poleceniem python3 -m idealista_cli token --refresh.

4. Wyszukuj nieruchomości, podając współrzędne geograficzne i parametry. Przykład: python3 -m idealista_cli search --center "39.594,-0.458" --distance 5000 --operation sale --property-type homes --all-pages --format summary. Zmień współrzędne, zasięg, typ operacji (sale/rent) i typ nieruchomości (homes/offices/garages) zgodnie z zapytaniem.

5. Aby uzyskać statystyki cenowe, użyj polecenia avg zamiast search: python3 -m idealista_cli avg --center "39.594,-0.458" --distance 5000 --operation sale --property-type homes --group-by propertyType. Wynik pokaże średnie ceny pogrupowane wybranym kryterium.

6. Integruj te polecenia z agentem AI, przekazując naturalne pytania użytkownika (np. "Znajdź mieszkanie w A Coruña poniżej 200 000 euro") do odpowiednich parametrów CLI.