saos-orzecznictwolisted
Install: claude install-skill matematicsolutions/awesome-matematic-skills-pl
# 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](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