Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Query Idealista API via idealista-cli (OAuth2 client credentials).
How to use
Zainstaluj idealista-cli, klonując repozytorium: git clone https://github.com/quifago/idealista-cli do katalogu domowego. Upewnij się, że masz zainstalowany Python 3.
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.
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.
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.
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.
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.