idealista-cli
Wyszukuj nieruchomości na Idealista bezpośrednio z wiersza poleceń
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Idealista CLI to narzędzie dla programistów i automatyzacji, które pozwala wyszukiwać ogłoszenia nieruchomości na portalu Idealista bez otwierania przeglądarki. Możesz szukać po mieście, dzielnicy lub ulicy, filtrować po cenie, metrażu i liczbie pokoi, a także pobierać szczegóły konkretnych ogłoszeń. Wyniki zwracane są w formacie tabelarycznym lub JSON, idealnym do integracji ze skryptami i automatyzacją.
Jak używać
Zainstaluj idealista-cli na swoim komputerze. Wymaga Node.js w wersji 18 lub wyższej oraz dostępu do sieci. Jeśli jeszcze go nie masz, pobierz z oficjalnej strony Node.js i zainstaluj.
Skonfiguruj zmienne środowiskowe. Narzędzie zawiera domyślne klucze API, ale możesz je nadpisać ustawiając zmienne: IDEALISTA_API_KEY, IDEALISTA_SIGNATURE_SECRET, IDEALISTA_OAUTH_CONSUMER_KEY, IDEALISTA_OAUTH_CONSUMER_SECRET i inne wymienione w dokumentacji. To opcjonalne, jeśli chcesz używać ustawień domyślnych.
Wyszukaj nieruchomości po lokalizacji. Użyj komendy search z nazwą miasta lub dzielnicy, typem operacji (sprzedaż, wynajem, przeniesienie) i typem nieruchomości (mieszkania, pokoje, biura, garaże, działki). Na przykład: idealista search "Warszawa" --operation sale --property-type homes. Możesz dodać filtry takie jak --min-price, --max-price, --min-size, --max-size lub --bedrooms.
Pobierz szczegóły konkretnego ogłoszenia. Gdy znasz numer ID ogłoszenia, użyj komendy listing z tym ID, aby uzyskać pełne informacje o nieruchomości.
Eksportuj wyniki w formacie JSON. Dodaj flagę --json do dowolnej komendy, aby otrzymać dane w formacie JSON zamiast tabeli. Jest to przydatne do automatyzacji i integracji z innymi systemami.
Paginuj wyniki, jeśli jest ich wiele. Użyj flag --page i --limit, aby kontrolować liczbę wyników na stronie i przechodzić między stronami wyników wyszukiwania.