matematicsolutions/awesome-matematic-skills-pl / orzecznictwo-zrodla/skills/legal-data-hunter-pl
legal-data-hunter-pl
VerifiedCatalog 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.
- Repo: https://github.com/worldwidelaw/legal-sources
- Dashboard + hostowane Search API (16 mln dokumentow): https://legaldatahunter.com
- Licencja repo: AGPL-3.0 (skrypty). Licencja DANYCH jest per-zrodlo - patrz
blok
license:wconfig.yamldanego zrodla (np. SAOS = public domain).
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-indexjest KONIECZNY na Windows - bez niegogit checkoutwywala 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 zrodloSupremeCourtdziala - ta pozycja to redundantny, zepsuty wariant)MF- interpretacje podatkowe sip.mf.gov.pl, API EUREKA geo-blokowane/WAF (czesciowo zastepuje je dzialajacyKIS-EUREKA)
To pokrywa wieksza czesc opublikowanego polskiego prawa - stad teza "~80%".
Czego TU NIE MA - luki do uzupelnienia przez MateMatic
| Luka | Dlaczego | Plan MateMatic |
|---|---|---|
| Biezace orzeczenia sadow powszechnych | LDH ma je tylko przez SAOS, a SAOS to archiwum konczace sie ~2018 | wlasny konektor do portali orzeczen orzeczenia.ms.gov.pl |
| Interpretacje podatkowe MF | zrodlo MF zablokowane (WAF/geo) | wlasny konektor lub oprzec sie na KIS-EUREKA |
| KRS - rejestr przedsiebiorcow | brak w sources/PL w ogole | skille gaius-lex (KRS) juz w MateMatic; ew. wlasny konektor MCP |
| Monitor Polski | jawnie nieindeksowany | do rozwazenia |
| Wyszukiwanie interaktywne (live query) | kolektory LDH to HARVESTERY (hurt), nie API zapytan | wlasne 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:
- Harvest / katalog (ta warstwa) - Legal Data Hunter. Hurtowy zaciag ~13 dzialajacych zrodel do lokalnego korpusu RODO-safe. Off-line, batch.
- Live query - wlasne konektory MateMatic. Skill
saos-orzecznictwo(interaktywne wyszukiwanie orzeczen), przyszle ISAP/KRS. To jest moat. - 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 danychstatus.yaml- historia uruchomien (jesli byl uruchamiany)sample/- 10+ rekordow do walidacjiretrieve.py- resolver referencji ("art. 415 kc" -> dokument), o ile istnieje
⚠️
common/pdf_extract.pymapreload_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
- Pytanie "czy mamy zrodlo X?" - sprawdz
references/coverage-pl.md. Jest -> uzyj kolektora. Nie ma / zablokowane -> luka, patrz tabela luk wyzej. - Hurtowy zaciag -
runner.py samplena probe, potem pelnyfetch_all(); zapis do lokalnego korpusu (SQLite + vector store, patrz wewnetrzne KGLF MateMatic). - Synchronizacja - kolektory legislacyjne robia upsert (akty sie zmieniaja),
case-law append-only z dedup. Cyklicznie
fetch_updates(). - Zapytanie na zywo - NIE przez LDH; uzyj
saos-orzecznictwolub innego konektora zapytan. - 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/istatus.yaml, nie tekstowi README. - Statusy w
references/coverage-pl.mdto 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).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |