Skip to content

matematicsolutions/awesome-matematic-skills-pl / orzecznictwo-zrodla/skills/legal-data-hunter-pl

legal-data-hunter-pl

Verified

Catalog and bulk-harvest layer for Polish legal data, built on the Legal Data Hunter project (worldwidelaw/legal-sources). Use this skill whenever the user wants to know which Polish legal sources are already available, bulk-download Polish legislation, case law or regulator decisions (UODO, UOKiK, KNF, UKE, URE, KIO, NSA, Trybunal Konstytucyjny, Sad Najwyzszy, Dziennik Urzedowy, Sejm ELI), build a local RODO-safe corpus of Polish law, or decide whether MateMatic needs to build its own connector for a gap. Trigger on "Legal Data Hunter", "pokrycie polskiego prawa", "zaciagnij ustawy", "harvest orzecznictwa", "ktore zrodla mamy", "luka w zrodlach". Companion to saos-orzecznictwo (live query) and eu-sparql-search (EU law).

Legal Data Hunter - warstwa katalogu zrodel polskiego prawa

Warstwa "katalog + harvest" projektu legal AI MateMatic. Mapuje, co z polskiego prawa jest juz dostepne gotowymi kolektorami, i wskazuje luki do uzupelnienia wlasnymi konektorami.

Czym to jest

worldwidelaw/legal-sources (Legal Data Hunter) - otwarte repo skryptow zbierania otwartych danych prawnych z 110+ krajow (960+ kolektorow). Kazdy kolektor pobiera i normalizuje dane z oficjalnego portalu/API rzadowego do wspolnego schematu.

Lokalna kopia

Sparse-clone polskiej czesci jest w ~/legal-data-hunter/ (17 MB; sources/PL/ + framework common/ + runner.py). Aktualizacja:

cd ~/legal-data-hunter && git pull

Pelne repo to 388 MB - NIE klonuj calosci, sparse-checkout wystarcza:

git clone --filter=blob:none --no-checkout --depth 1 \
  https://github.com/worldwidelaw/legal-sources.git legal-data-hunter
cd legal-data-hunter
git config index.sparse true
git sparse-checkout init --cone --sparse-index
git sparse-checkout set sources/PL common docs
git checkout

⚠️ --sparse-index jest KONIECZNY na Windows - bez niego git checkout wywala sie na sciezkach z : w nazwie (US/Louisiana) mimo cone-mode.

Pokrycie polskiego prawa (16 zrodel, stan 2026-05-19)

Pelna tabela ze statusem, API i licencja: references/coverage-pl.md.

Dziala (13 zrodel) - legislacja, orzecznictwo, regulatorzy, podatki:

  • Legislacja: DziennikUrzedowy, Sejm (ELI API, 96K aktow - oznaczony untested)
  • Orzecznictwo: ConstitutionalCourt (TK), SupremeCourt (SN), NSA, KIO, SAOS (hurtowe archiwum wszystkich sadow)
  • Regulatorzy: KNF, UODO, UOKIK, UKE, URE
  • Podatki: KIS-EUREKA, NSA-Tax

Zablokowane / luki (3 zrodla):

  • SN - sn.pl w konserwacji, alternatywa SAOS zawiesila sie (osobne zrodlo SupremeCourt dziala - ta pozycja to redundantny, zepsuty wariant)
  • MF - interpretacje podatkowe sip.mf.gov.pl, API EUREKA geo-blokowane/WAF (czesciowo zastepuje je dzialajacy KIS-EUREKA)

To pokrywa wieksza czesc opublikowanego polskiego prawa - stad teza "~80%".

Czego TU NIE MA - luki do uzupelnienia przez MateMatic

LukaDlaczegoPlan MateMatic
Biezace orzeczenia sadow powszechnychLDH ma je tylko przez SAOS, a SAOS to archiwum konczace sie ~2018wlasny konektor do portali orzeczen orzeczenia.ms.gov.pl
Interpretacje podatkowe MFzrodlo MF zablokowane (WAF/geo)wlasny konektor lub oprzec sie na KIS-EUREKA
KRS - rejestr przedsiebiorcowbrak w sources/PL w ogoleskille gaius-lex (KRS) juz w MateMatic; ew. wlasny konektor MCP
Monitor Polskijawnie nieindeksowanydo rozwazenia
Wyszukiwanie interaktywne (live query)kolektory LDH to HARVESTERY (hurt), nie API zapytanwlasne konektory zapytan: skill saos-orzecznictwo, przyszle ISAP/KRS

Jak to sie laczy z reszta architektury

Trzy warstwy dostepu do polskiego prawa - nie konkuruja, uzupelniaja sie:

  1. Harvest / katalog (ta warstwa) - Legal Data Hunter. Hurtowy zaciag ~13 dzialajacych zrodel do lokalnego korpusu RODO-safe. Off-line, batch.
  2. Live query - wlasne konektory MateMatic. Skill saos-orzecznictwo (interaktywne wyszukiwanie orzeczen), przyszle ISAP/KRS. To jest moat.
  3. Prawo UE - skill eu-sparql-search (EUR-Lex/CJEU).

Kolektor SAOS w LDH (sources/PL/SAOS) uzywa tylko Dump API (hurtowe archiwum, append-only). Skill saos-orzecznictwo uzywa Search/Browse API (zapytania na zywo). To NIE jest dublowanie - jedno zasila lokalny indeks, drugie odpowiada na pytanie tu i teraz.

⚠️ Hostowane Search API legaldatahunter.com to zaleznosc chmurowa - sprzeczna z teza zero-cloud MateMatic (RODO-safe self-hosted stack). Do produktu dla kancelarii uruchamiaj kolektory lokalnie i trzymaj korpus u siebie. Hostowane API jest OK tylko do szybkiego rozpoznania/dev.

Uruchamianie kolektorow

Framework: Python. Zaleznosci w requirements.txt (core: requests, pyyaml, beautifulsoup4, lxml; ciezsze opcjonalne: playwright, psycopg2-binary, opendataloader-pdf). Core jest juz zainstalowany na tej maszynie.

cd ~/legal-data-hunter
python runner.py status              # przeglad stanu projektu
python runner.py sample PL/SAOS      # tryb probny - 10+ rekordow do walidacji
python runner.py test PL/UODO        # test kolektora
python runner.py fast PL/KIO         # bootstrap_fast

Struktura kazdego zrodla sources/PL/<Nazwa>/:

  • bootstrap.py - kolektor: fetch_all(), fetch_updates(), normalize()
  • config.yaml - metadane, API, rate-limit, schema, licencja danych
  • status.yaml - historia uruchomien (jesli byl uruchamiany)
  • sample/ - 10+ rekordow do walidacji
  • retrieve.py - resolver referencji ("art. 415 kc" -> dokument), o ile istnieje

⚠️ common/pdf_extract.py ma preload_existing_ids() odpytujace hostowana baze Neon Postgres (idempotencja pipeline'u LDH). Przy harveScie dla MateMatic uruchamiaj w trybie bez tego checku - nie wystawiaj danych kancelarii do Neon.

Workflow

  1. Pytanie "czy mamy zrodlo X?" - sprawdz references/coverage-pl.md. Jest -> uzyj kolektora. Nie ma / zablokowane -> luka, patrz tabela luk wyzej.
  2. Hurtowy zaciag - runner.py sample na probe, potem pelny fetch_all(); zapis do lokalnego korpusu (SQLite + vector store, patrz wewnetrzne KGLF MateMatic).
  3. Synchronizacja - kolektory legislacyjne robia upsert (akty sie zmieniaja), case-law append-only z dedup. Cyklicznie fetch_updates().
  4. Zapytanie na zywo - NIE przez LDH; uzyj saos-orzecznictwo lub innego konektora zapytan.
  5. Luka - jesli zrodla brak albo jest zablokowane, to kandydat na wlasny konektor MateMatic. Najpierw skill (wzorem saos-orzecznictwo), potem MCP.

Reguly

  • Repo AGPL-3.0 - skrypty kolektorow sa copyleft. Dane wyjsciowe maja wlasne licencje (per config.yaml). Uruchamianie kolektorow jako osobnych procesow i uzywanie zebranych danych nie czyni powloki MCP MateMatic dzielem zaleznym - spojne z insightem licencyjnym o MCP w otwartym ekosystemie MateMatic.
  • Do produktu dla kancelarii: kolektory lokalnie, korpus lokalnie. Bez Neon, bez hostowanego Search API.
  • README polskiej sekcji w repo bywa nieaktualny (widziano date 2026-02-21 i spis 4 zrodel przy realnych 16) - ufaj drzewu sources/PL/ i status.yaml, nie tekstowi README.
  • Statusy w references/coverage-pl.md to migawka 2026-05-19 - przy waznych decyzjach odswiez (git pull + runner.py status).

Wspólne reguły wtyczki orzecznictwo-zrodla (Orzecznictwo i źródła)

Te reguły obowiązują w każdym skillu tej wtyczki, także gdy sam skill milczy. Są skopiowane do każdego skilla, więc działają zarówno po instalacji całej wtyczki, jak i pojedynczego skilla. Pełniejszy standard: https://github.com/matematicsolutions/awesome-matematic-skills-pl/tree/main/references

Źródła, nie pamięć

Ten plugin pobiera przepisy i orzecznictwo z baz przez konektory MCP (read-only, publiczne API). Każda teza prawna należy do jednej z klas:

  • Zweryfikowane - potwierdzone w bazie, z sygnaturą i źródłem: (wyrok NSA II FSK NNNN/RR, SAOS).
  • Do sprawdzenia - prawdopodobne, jeszcze niepotwierdzone: [zweryfikuj w EUR-Lex].
  • Nie używać - sygnatura lub przepis bez pokrycia w bazie. Pomiń, nie zmyślaj numeru.

Samo istnienie sygnatury nie wystarcza - sprawdź treść orzeczenia, czy rozstrzyga to, co mu przypisujesz. Linia orzecznicza bywa zmienna; aktualność ocenia człowiek.

Konektory w tym pluginie

Plik .mcp.json deklaruje konektory polskich i unijnych źródeł. SAOS, KRS i EUR-Lex działają lokalnie przez node/npx, read-only na publicznych danych. Repertorium to konektor zdalny (https://repertorium.matematicsolutions.com/connector): przy pierwszym użyciu poprosi o adres e-mail i kod z wiadomości. Konto jest bezpłatne, z limitem wywołań opisanym w regulaminie Repertorium. Dane sprawy objęte tajemnicą lub wrażliwe - oceń osobno, czy w ogóle wnosić je do narzędzia; przy wątpliwości nie przekazuj. Do Repertorium wysyłaj pytania o prawo, bez nazwisk i danych klienta.

Bramka człowieka

Wynik to projekt do weryfikacji. Nic nie zostaje wysłane ani złożone, zanim sprawdzi to uprawniony człowiek, który bierze odpowiedzialność zawodową.

Pobieranie spoza MCP

Oprócz konektorów plugin zawiera skill webwright-legal-pl - pobiera orzeczenia z serwisów niedostępnych przez MCP (orzeczenia.ms.gov.pl, sn.pl, trybunal.gov.pl, EUR-Lex PL) przez przeglądarkę (Playwright). Te same reguły: dane wrażliwe oceniaj osobno, wynik to projekt do weryfikacji.

Zakres pluginu

Plugin dostarcza wyszukiwanie i pobieranie źródeł prawa PL/UE. Nie zastępuje analizy prawnej ani weryfikacji cytatu - tę warstwę daje plugin "fundament weryfikacyjny" (zalecany razem).

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall