kw-lookup

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:

1. Usuń spacje, wymuś upper-case.
2. Dopasuj regex. Jeśli nie pasuje → zwróć błąd z przykładem poprawnego formatu.
3. Pierwsze 4 znaki (kod wydziału) → tabela sądów (patrz references/sady.md).

Flow główny (preferowany)

Etap 1 — EKW przez Playwright MCP

1. mcp__plugin_playwright_playwright__browser_navigate → https://przegladarka-ekw.ms.gov.pl/eukw_prz/KsiegiWieczyste/wyszukiwanieKW
2. browser_fill_form — wypełnij 3 pola: kod wydziału, numer (8 cyfr), cyfra kontrolna.
3. 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.
4. 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).
5. 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:

1. Zbuduj instrukcję z gotowym URL-em EKW i rozbitym numerem KW (kod/numer/cyfra).
2. 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).
3. Sparsuj wklejony tekst lokalnie i wykonaj Etap 3 (jeśli --geo).

Checklist przed zwrotem wyniku

• Format KW zwalidowany regexem.
• Wszystkie pola adresu są non-null lub jawnie null (nie pomijaj kluczy).
• Każda działka ma id w formacie TERYT.
• Dla lokalu: identyfikator lokalu obecny + kw_gruntowa wypełniona.
• Pobrano wszystkie działy z listy --dzialy (domyślnie I-O, I-Sp, II, III, IV).
• Pusty dział → []; pominięty dział → null.
• PESEL-e zamaskowane jeśli dane trafiają do pliku/artefaktu trwałego.
• Przy --geo: lat/lon w granicach PL (49–55°N, 14–24°E) — sanity check.
• Jedno zapytanie / 10 s na EKW — przy wielu KW wstaw sleep.

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.