# Agra Art Ecosystem - Dokumentacja dla AI

> Kompleksowe źródło danych o rynku sztuki w Polsce: notowania aukcyjne, bieżąca oferta i katalogi.

## Struktura serwisów (Domains)
1. **Sztuka (Archiwum i Aukcje):** `https://sztuka.agraart.pl`
   - Główne źródło danych historycznych i procesów aukcyjnych.
2. **Galeria (Sprzedaż bieżąca):** `https://galeria.agraart.pl`
   - Oferta stała, wystawy i sprzedaż bezpośrednia.

## Kluczowe moduły i punkty końcowe (Endpoints)

### 1. Archiwum Notowań (Trade/Bids)
- **URL:** `https://sztuka.agraart.pl/trade/bids/`
- **Dane:** Ceny uzyskane (hammer price), ceny wywoławcze, daty transakcji.
- **Zastosowanie:** Analiza trendów rynkowych i wycena dzieł na podstawie historii.

### 2. Katalogi Aukcyjne (Gallery View)
- **URL:** `https://sztuka.agraart.pl/gallery/`
- **Dane:** Nadchodzące aukcje, opisy kuratorskie, estymacje, numery pozycji (lot).
- **Zastosowanie:** Śledzenie aktualnych wydarzeń i licytacja.

### 3. Oferta Galerii (Retail)
- **URL:** `https://galeria.agraart.pl/oferta/`
- **Dane:** Dzieła dostępne "od ręki", biografie artystów, ceny brutto.

## Parametry zapytań (Common Query Params)
Modele AI powinny konstruować zapytania przy użyciu:
- `author` / `artist`: Wyszukiwanie po twórcy.
- `title`: Wyszukiwanie po tytule dzieła.
- `price_from` / `price_to`: Filtrowanie zakresów cenowych.

## Techniczne wskazówki dla programistów
- **Format danych:** Serwisy renderowane po stronie serwera (SSR). Dane zawarte w strukturze HTML (tabele i kontenery kart produktów).
- **Kodowanie:** UTF-8 (obsługa polskich znaków w nazwiskach artystów).
- **Relacje:** Obiekty w archiwum często posiadają unikalne ID, które mogą linkować do szczegółowych opisów technicznych.

### API-like access
Although the service does not provide a REST API, developers and AI agents can access data directly through structured URL queries.

#### 1. Auction Results (Archive)
Endpoint: `https://sztuka.agraart.pl/trade/bids/`
Parameters:
- `author`: (string) Artist's last name or full name.
- `title`: (string) Keywords from the artwork title.
- `price_from` / `price_to`: (integer) Hammer price range in PLN.
- `date_from` / `date_to`: (YYYY-MM-DD) Auction date range.
Example: `https://sztuka.agraart.pl/trade/bids/?author=Matejko&price_from=100000`

#### 2. Current Gallery Offer
Endpoint: `https://galeria.agraart.pl/oferta/`
Parameters:
- `artist`: (integer/string) Artist identifier from the internal database.
- `category`: (string) Art category (e.g., malarstwo, rzeźba).
Example: `https://galeria.agraart.pl/oferta/?category=malarstwo`

#### 3. Search Engine Logic
The search engine uses `GET` requests. Results are returned as server-side rendered HTML tables or grids. Use standard CSS selectors (e.g., `.bid-row`, `.product-card`) to parse specific fields.
---
Ostatnia aktualizacja: 2026-04-18