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 urllib w bash_tool, NIE web_fetch - URL-e SAOS z zapytan programowych beda odrzucone przez ograniczenia narzedzia web_fetch.

Workflow

1. Ustal intencje - czego szuka uzytkownik: sygnatura, temat, sad, sedzia, data?
2. Zmapuj na parametry Search API - patrz references/api.md. Sygnatura → caseNumber; temat → all lub keywords; akt → referencedRegulation.
3. Wykonaj przez scripts/saos.py lub inline Python. Zacznij pageSize=10.
4. Pokaz wyniki jako czytelna tabela: sygnatura, sad, data, typ, fragment.
5. Pobierz pelna tresc przez Browse API, gdy uzytkownik chce konkretne orzeczenie.
6. ZAWSZE cytuj zrodlo - klikalny link (sekcja nizej).
7. 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.
• pageSize ma twardy dolny limit 10 (400 WRONG REQUEST PARAMETER dla < 10). Nie da sie pobrac 1 wyniku - bierz 10 i tnij.
• courtType=ADMINISTRATIVE zwraca pustke. Dla WSA/NSA odeslij do orzeczenia.nsa.gov.pl.
• Artefakty OCR w datach (judgmentDate:"3013-12-04", "2101-04-14"). Sortowanie DESC wypycha te rekordy na gore. Filtruj jawnie judgmentDateTo=<dzis>.
• textContent zawiera 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/commonCourts bez id → 404). Id sadu bierz z pola division w wynikach orzeczen.
• Wartosci tekstowe parametrow URL-encoduj (urllib.parse.urlencode robi 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, EUR-Lex). Działają read-only na publicznych danych. Wymagają node/npx w środowisku. 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.

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).