| name | kw-lookup |
| description | Wyszukuje dane nieruchomości po polskim numerze księgi wieczystej (KW) — adres, działki/lokal, właścicieli, prawa, roszczenia, ograniczenia i hipoteki. Używaj gdy użytkownik poda numer w formacie XX1X/XXXXXXXX/X (np. WA1M/00123456/7) lub prosi o "sprawdź księgę wieczystą", "dane z KW", "znajdź adres/właściciela/hipoteki po KW". Łączy browser automation na portalu EKW (ekw.ms.gov.pl, wymaga ręcznego rozwiązania CAPTCHA) z REST API ULDK GUGiK do wzbogacenia o geometrię działki i współrzędne.
|
| allowed-tools | Read, Write, Bash, Bash(playwright-cli:*) |
KW Lookup — odczyt księgi wieczystej
Skill mapuje numer polskiej księgi wieczystej na pełne dane ze wszystkich działów:
I-O (oznaczenie), I-Sp (spis praw), II (własność), III (prawa/roszczenia/ograniczenia),
IV (hipoteki). Opcjonalnie wzbogaca dane o geometrię działki przez ULDK GUGiK.
Ograniczenia: portal EKW używa reCAPTCHA — człowiek musi ją rozwiązać raz na sesję
(jeśli zostanie wywołana). Publiczny REST API dla KW → adres nie istnieje. Rate-limit:
max 1 zapytanie / 10 s (szanujemy ToS serwisu, brak masowych zapytań).
Wejście
Numer KW w formacie: ^[A-Z]{2}\d[A-Z]/\d{8}/\d$
- Przykład:
WA1M/00123456/7
WA1M — kod wydziału sądu rejonowego (4 znaki)00123456 — numer KW (8 cyfr)7 — cyfra kontrolna
Flagi opcjonalne:
--geo — wzbogacenie o współrzędne i link do Geoportalu (Etap 3).--dzialy=IO,ISp,II,III,IV — lista działów do pobrania (domyślnie wszystkie). Podaj
np. --dzialy=IO aby pobrać tylko adres i działki (szybciej, mniej kliknięć).
Walidacja przed wywołaniem dowolnego narzędzia:
- Usuń spacje, wymuś upper-case.
- Dopasuj regex. Jeśli nie pasuje → zwróć błąd z przykładem poprawnego formatu.
- Pierwsze 4 znaki (kod wydziału) → tabela sądów (patrz
references/sady.md).
Flow główny (preferowany)
Etap 1 — EKW przez Playwright MCP
mcp__plugin_playwright_playwright__browser_navigate →
https://przegladarka-ekw.ms.gov.pl/eukw_prz/KsiegiWieczyste/wyszukiwanieKWbrowser_fill_form — wypełnij 3 pola: kod wydziału, numer (8 cyfr), cyfra kontrolna.- Klik "Wyszukaj Księgę". Portal może pokazać CAPTCHA — jeśli tak, poproś użytkownika
o jej rozwiązanie i
browser_wait_for na zmianę URL. Strona wyników zawiera typ KW
(grunt / lokal / budynek / SUW) i sąd — zapisz do JSON.
- Klik "Przeglądanie aktualnej treści KW" → strona
/pokazWydruk z zakładkami
działów (przyciski: Dział I-O, Dział I-Sp, Dział II, Dział III, Dział IV).
- Domyślnie widoczny jest Dział I-O —
browser_snapshot i parsuj. Następnie dla
każdego kolejnego działu z listy --dzialy: klik odpowiedniego przycisku →
browser_snapshot → parsuj. Między klikami nie potrzeba sleep, to ta sama
sesja.
Etap 2 — parsowanie działów
Wszystkie tabele EKW mają wspólny schemat: kolumna „Nr pola”, „Nazwa pola”, „Treść pola”
(plus numery wpisu). Czytaj etykiety wierszy (cell[0]) i wartości (cell[1..n]).
Pomijaj wiersze-nagłówki i wiersze typu „DOKUMENTY BĘDĄCE PODSTAWĄ WPISU”.
Dział I-O — Oznaczenie nieruchomości
Pola w zależności od typu KW:
- Grunt / budynek:
Położenie (woj., powiat, gmina, miejscowość, dzielnica, ulica,
numer), lista działek z polami:
identyfikator działki (TERYT: WWPPGG_R.OOOO.NR_DZ, np. 146513_8.0123.45/6)numer działki, obręb (numer + nazwa)sposób korzystania (np. „R — grunty orne”, „B — tereny mieszkaniowe”)powierzchnia (ha lub m²) jeśli podano.
- Lokal stanowiący odrębną nieruchomość:
Położenie + Ulica, Numer budynku,
Numer lokalu, Identyfikator lokalu, Przeznaczenie lokalu, Opis lokalu,
Pomieszczenia przynależne, Kondygnacja, Powierzchnia użytkowa,
Przyłączenie — numer KW gruntowej (to KW nadrzędna, z której wyodrębniono lokal).
Jeśli wiele wierszy (kilka działek / adresów) — zwróć wszystkie.
Dział I-Sp — Spis praw związanych z własnością
Typowo dla lokali: udział w nieruchomości wspólnej, prawa do korzystania z części
nieruchomości (np. miejsce postojowe). Zwróć listę obiektów:
{
"lp": "1",
"rodzaj_prawa": "UDZIAŁ ZWIĄZANY Z WŁASNOŚCIĄ LOKALU",
"tresc": "UDZIAŁ W NIERUCHOMOŚCI WSPÓLNEJ",
"wielkosc_udzialu": "6187/1234567"
}
Dział II — Własność
Lista właścicieli / użytkowników wieczystych / uprawnionych. Dla każdego zwróć:
lp, rodzaj_wpisu (WŁAŚCICIEL / UŻYTKOWNIK WIECZYSTY / UPRAWNIONY),udzial (np. „1/1”, „1/2”),typ_podmiotu (OSOBA FIZYCZNA / PRAWNA / JEDNOSTKA ORGANIZACYJNA),- dane podmiotu:
imiona_nazwisko, imiona_rodzicow, pesel, lub nazwa, regon,
krs dla podmiotów instytucjonalnych.
Prywatność: dane z Dział II są publicznie dostępne na portalu MS, ale nie
zapisuj pełnych PESEL-i / imion rodziców do artefaktów trwałych (pliki, logi, memory)
— tylko do odpowiedzi w bieżącej konwersacji. Jeśli zapisujesz do pliku, zamaskuj
PESEL do ostatnich 4 cyfr (***-**-****).
Dział III — Prawa, roszczenia i ograniczenia
Lista wpisów. Dla każdego:
lp, rodzaj_wpisu (SŁUŻEBNOŚĆ / ROSZCZENIE / OSTRZEŻENIE / PRAWO DOŻYWOCIA / …),tresc (pełny tekst wpisu, łącznie z opisem ograniczenia),osoba_uprawniona (jeśli dotyczy),podstawa_wpisu (dokument, data, organ).
Jeśli dział pusty → zwróć [].
Dział IV — Hipoteka
Lista hipotek. Dla każdej:
lp, rodzaj_hipoteki (UMOWNA / PRZYMUSOWA / ŁĄCZNA),suma (kwota + waluta, np. "400000.00 PLN"),wierzyciel (nazwa banku / podmiotu),zabezpieczona_wierzytelnosc (opis — np. „kredyt mieszkaniowy nr X z dnia Y”),oprocentowanie jeśli podano,termin_zaplaty jeśli podano,podstawa_wpisu.
Jeśli dział pusty → zwróć [].
Etap 3 (opcjonalny, flaga --geo) — wzbogacenie przez ULDK GUGiK
Dla każdego identyfikatora działki (także wyciągniętego z identyfikator lokalu —
pierwsze segmenty przed .1_BUD to ID działki):
curl -s "https://uldk.gugik.gov.pl/?request=GetParcelById&id=<ID>&result=geom_wkt,teryt,voivodeship,county,commune,region,parcel"
- Z
geom_wkt policz centroid (średnia współrzędnych) — lat/lon.
- Deep-link:
https://mapy.geoportal.gov.pl/imap/?identifyParcel=<ID>
Format wyjścia
Zawsze zwróć oba: strukturę JSON (w code block) + krótkie podsumowanie markdown.
Klucze pomijanych działów (np. gdy użytkownik ograniczył --dzialy) zwróć jako null,
pustych działów — jako []. Odróżnia „nie pobrałem” od „brak wpisów”.
{
"kw": "WA1M/00123456/7",
"sad": "Sąd Rejonowy dla Warszawy-Mokotowa, IX Wydział KW",
"typ": "NIERUCHOMOŚĆ GRUNTOWA",
"stan_z_dnia": "2026-04-21 18:18",
"dzial_io": {
"adres": {
"wojewodztwo": "mazowieckie",
"powiat": "Warszawa",
"gmina": "Warszawa",
"miejscowosc": "Warszawa",
"dzielnica": "Mokotów",
"ulica": "Puławska",
"numer_budynku": "12",
"numer_lokalu": null
},
"dzialki": [
{
"id": "146513_8.0123.45/6",
"obreb": "0123 Mokotów",
"numer": "45/6",
"sposob_korzystania": "B — tereny mieszkaniowe",
"powierzchnia": "0.0450 ha"
}
],
"lokal": null,
"kw_gruntowa": null
},
"dzial_isp": [
{ "lp": "1", "rodzaj_prawa": "...", "tresc": "...", "wielkosc_udzialu": "..." }
],
"dzial_ii": [
{
"lp": "1",
"rodzaj_wpisu": "WŁAŚCICIEL",
"udzial": "1/1",
"typ_podmiotu": "OSOBA FIZYCZNA",
"imiona_nazwisko": "JAN KOWALSKI",
"imiona_rodzicow": "ADAM, EWA",
"pesel": "12345678901"
}
],
"dzial_iii": [
{
"lp": "1",
"rodzaj_wpisu": "SŁUŻEBNOŚĆ PRZESYŁU",
"tresc": "...",
"osoba_uprawniona": "...",
"podstawa_wpisu": "..."
}
],
"dzial_iv": [
{
"lp": "1",
"rodzaj_hipoteki": "UMOWNA",
"suma": "400000.00 PLN",
"wierzyciel": "BANK X S.A.",
"zabezpieczona_wierzytelnosc": "kredyt mieszkaniowy nr ... z dnia ...",
"oprocentowanie": "WIBOR 3M + 1.9%",
"termin_zaplaty": null,
"podstawa_wpisu": "..."
}
],
"geo": {
"lat": 52.1942,
"lon": 21.0254,
"geoportalUrl": "https://mapy.geoportal.gov.pl/imap/?identifyParcel=146513_8.0123.45/6"
}
}
Pole geo pomijaj (null) gdy użytkownik nie poda --geo.
Fallback — tryb manualny
Jeśli Playwright MCP nie jest dostępny lub użytkownik odmówi rozwiązania CAPTCHA:
- Zbuduj instrukcję z gotowym URL-em EKW i rozbitym numerem KW (kod/numer/cyfra).
- Poproś użytkownika o wklejenie tekstu kolejnych działów z przeglądarki (po jednej
zakładce naraz — oddzielnie I-O, I-Sp, II, III, IV).
- Sparsuj wklejony tekst lokalnie i wykonaj Etap 3 (jeśli
--geo).
Checklist przed zwrotem wyniku
Co ten skill nie robi
- Nie obchodzi CAPTCHA automatycznie.
- Nie integruje się z płatnymi API (ksiegiwieczyste.pl, ekw.plus).
- Nie pobiera treści zupełnej (historycznej) — tylko aktualna treść KW.
- Nie wysyła więcej niż 1 zapytania / 10 s do EKW.
- Nie redystrybuuje danych osobowych z Dział II poza odpowiedzią do użytkownika.
