matematicsolutions/awesome-matematic-skills-pl / orzecznictwo-zrodla/skills/saos-orzecznictwo
saos-orzecznictwo
VerifiedSearch and retrieve Polish court judgments via the SAOS REST API (System Analizy Orzeczen Sadowych, Fundacja ePanstwo). Use this skill whenever the user wants to find Polish case law - orzeczenia, wyroki, postanowienia - from sady powszechne, Sad Najwyzszy, Trybunal Konstytucyjny or Krajowa Izba Odwolawcza; search by case number (sygnatura), date range, court, judge, keyword, legal basis or referenced regulation; fetch full judgment text; or bulk-download the judgment corpus. Also trigger on "orzecznictwo PL", "SAOS", "szukaj wyroku", "sygnatura akt", "baza orzeczen". Companion to eu-sparql-search (which covers EU law / CJEU).
SAOS - Polish Case Law Search
Polski konektor orzecznictwa dla projektu legal AI MateMatic. Komplementarny do
eu-sparql-search (CJEU / prawo UE): SAOS pokrywa sady krajowe RP.
Endpoint
https://www.saos.org.pl/api
Publiczne, otwarte REST API. Bez klucza, bez autoryzacji. Zwraca JSON.
API ma trzy czesci:
| Czesc | Sciezka | Do czego |
|---|---|---|
| Search API | /api/search/judgments | przeszukiwanie wg kryteriow, zwraca skroty + textContent |
| Browse API | /api/judgments/{id} | pelny obiekt pojedynczego orzeczenia |
| Dump API | /api/dump/judgments | hurtowe pobranie calej bazy + synchronizacja |
Pelna referencja parametrow, pol odpowiedzi i enumeracji → references/api.md
Zakres bazy (co SAOS faktycznie indeksuje)
| courtType | Sad | Status |
|---|---|---|
COMMON | sady powszechne (rejonowe, okregowe, apelacyjne) | pelny |
SUPREME | Sad Najwyzszy | pelny |
CONSTITUTIONAL_TRIBUNAL | Trybunal Konstytucyjny | pelny |
NATIONAL_APPEAL_CHAMBER | Krajowa Izba Odwolawcza (zamowienia publiczne) | pelny |
ADMINISTRATIVE | sady administracyjne (WSA/NSA) | PUSTY - uzyj orzeczenia.nsa.gov.pl |
⚠️ Zakres SAOS (zweryfikowane na zywym API 2026-05-19). SAOS zawiera orzecznictwo biezace (~17 tys. z 2024, ~14 tys. z 2025+). Pokrycie nierowne wg typu sadu. Realne ograniczenia: brak WSA/NSA i artefakty OCR w datach.
Jak wykonywac zapytania
Metoda preferowana: helper Python
Skrypt scripts/saos.py w tym skillu owija API. Z bash_tool:
python ~/.claude/skills/saos-orzecznictwo/scripts/saos.py search \
--all "RODO" --court SUPREME --from 2023-01-01 --size 10
python ~/.claude/skills/saos-orzecznictwo/scripts/saos.py get 352475
python ~/.claude/skills/saos-orzecznictwo/scripts/saos.py case "I ACa 772/13"
Przyklad inline Python bez zaleznosci → references/api.md
WAZNE: Uzywaj
urllibw bash_tool, NIEweb_fetch- URL-e SAOS z zapytan programowych beda odrzucone przez ograniczenia narzedziaweb_fetch.
Workflow
- Ustal intencje - czego szuka uzytkownik: sygnatura, temat, sad, sedzia, data?
- Zmapuj na parametry Search API - patrz references/api.md.
Sygnatura →
caseNumber; temat →alllubkeywords; akt →referencedRegulation. - Wykonaj przez
scripts/saos.pylub inline Python. ZacznijpageSize=10. - Pokaz wyniki jako czytelna tabela: sygnatura, sad, data, typ, fragment.
- Pobierz pelna tresc przez Browse API, gdy uzytkownik chce konkretne orzeczenie.
- ZAWSZE cytuj zrodlo - klikalny link (sekcja nizej).
- Zaproponuj dalej - kolejna strona, szerszy zakres dat, inny sad, dump lokalny.
Cytowania - zawsze weryfikowalny link
Kazda odpowiedz oparta na tresci orzeczenia MUSI konczyc sie zrodlem. Bez tego uzytkownik nie odroznia realnego cytatu od halucynacji.
Format bloku zrodla na koncu odpowiedzi:
**Zrodlo:** Sad Apelacyjny w Lodzi, wyrok z 4.12.2013, sygn. I ACa 772/13
- SAOS: https://www.saos.org.pl/judgments/31345
- Oryginal sadu: http://api.orzeczenia.wroclaw.sa.gov.pl/...
Reguly i pulapki
- API jest publiczne, bez auth. Nie wymyslaj kluczy.
pageSizema twardy dolny limit 10 (400 WRONG REQUEST PARAMETERdla < 10). Nie da sie pobrac 1 wyniku - bierz 10 i tnij.courtType=ADMINISTRATIVEzwraca pustke. Dla WSA/NSA odeslij doorzeczenia.nsa.gov.pl.- Artefakty OCR w datach (
judgmentDate:"3013-12-04","2101-04-14"). Sortowanie DESC wypycha te rekordy na gore. Filtruj jawniejudgmentDateTo=<dzis>. textContentzawiera znaczniki HTML (<p>,<em>wokol trafien). Zdejmij znaczniki przed cytowaniem (html.parser/ regex).- API nie ma operatorow boolowskich w
all- proste wyszukiwanie pelnotekstowe. Zlozone zapytania rozbijaj na kilka wywolan. - Brak listowania sadow (
/api/commonCourtsbez id →404). Id sadu bierz z poladivisionw wynikach orzeczen. - Wartosci tekstowe parametrow URL-encoduj (
urllib.parse.urlencoderobi to sam).
Miejsce w architekturze
Ten skill to warstwa live query dla SAOS. Komplementarny do:
legal-data-hunter-pl- warstwa harvestu/katalogu. Uzywa tylko Dump API (hurtowe archiwum do lokalnego korpusu RODO-safe).eu-sparql-search- prawo UE / orzecznictwo CJEU.
Realna luka: orzecznictwo sadow administracyjnych (WSA/NSA) - SAOS nie indeksuje.
Potrzebny osobny konektor do orzeczenia.nsa.gov.pl.
Historia zmian
- 2026-05-19 - korekta zakresu. Stare ustalenie "SAOS to archiwum historyczne
zatrzymane ~2018" BLEDNE. Weryfikacja na zywym API: 17k orzeczen z 2024, 14k z 2025+.
Realne ograniczenia to brak WSA/NSA i artefakty OCR w datach. Ten sam blad
poprawiony rownolegle w serwerze MCP
mcp-saos(6 disclaimerow + filtr judgmentDateTo).
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 |