| name | saos-orzecznictwo |
| description | Search 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).
|
| license | Apache-2.0 |
| allowed-tools | ["WebFetch","Bash","Read","Write"] |
| data-residency | local |
| requires-human-approval | false |
| pii-egress | none |
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 --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
