# JanuszMap — Pełna specyfikacja i dokumentacja dla systemów AI

> JanuszMap (https://januszmap.pl) to bezpłatne narzędzie internetowe do wizualizacji i przestrzennej analizy ogłoszeń z portalu OLX.pl.

## Podstawowe informacje
- Nazwa aplikacji: JanuszMap (OLX Mapa Ogłoszeń)
- Domena kanoniczna: https://januszmap.pl
- Język interfejsu: Polski (pl-PL)
- Dostęp: Bezpłatny, bez logowania, bez konta
- Kontakt: janusz@januszmap.pl

## Przeznaczenie i odbiorcy
Narzędzie służy osobom poszukującym ofert w konkretnych lokalizacjach:
- Kupujący i najemcy nieruchomości (mieszkania, domy, działki, lokale komercyjne)
- Osoby poszukujące pracy w swojej okolicy lub na określonej trasie dojazdu
- Kupujący samochody i motocykle od osób prywatnych i komisów
- Poszukiwacze okazji cenowych na rynku wtórnym i elektroniki

## Kluczowe mechanizmy
1. Wizualizacja mapowa:
   - Każde ogłoszenie z poprawnymi współrzędnymi geograficznymi otrzymuje przypinkę z ceną na mapie Leaflet.
   - Mechanizm Marker Clustering zapobiega nakładaniu się punktów przy dużym zagęszczeniu ofert.
2. Analiza statystyczna w czasie rzeczywistym:
   - Liczba wszystkich ofert vs liczba ofert z koordynatami na mapie.
   - Cena minimalna, średnia arytmetyczna, mediana cen oraz cena maksymalna.
   - Odporne na błędy wyliczanie statystyk rynkowych bez konieczności przeładowywania strony.
3. Filtrowanie i sortowanie:
   - Filtr cenowy (od / do).
   - Filtr słów kluczowych i dzielnic.
   - Przełącznik "Tylko w tytule".
   - Przełącznik "Bez ofert pracy".
   - Tryb "Top 3 najtańsze" (wyróżniający 3 najtańsze oferty na mapie).
4. Eksport danych:
   - Eksport przefiltrowanych punktów mapy do formatu GeoJSON (.geojson) ze wszystkimi atrybutami (cena, tytuł, link, współrzędne).

## Format adresów URL i zapytań
- Strona główna: https://januszmap.pl/
- Udostępnione wyszukiwanie: https://januszmap.pl/?url=<zakodowany_url_olx_lub_fraza>
- Przykład: https://januszmap.pl/?url=https%3A%2F%2Fwww.olx.pl%2Fnieruchomosci%2Fmieszkania%2Fkrakow%2F
- Dokumentacja w Markdown: https://januszmap.pl/about.md
- Manifest AI: https://januszmap.pl/llms.txt
- Pełny kontekst AI: https://januszmap.pl/llms-full.txt
- Mapa witryny: https://januszmap.pl/sitemap.xml

## Ograniczenia i zasady korzystania
- Limit OLX: maksymalnie 25 stron (ok. 1 000 ogłoszeń) na zapytanie.
- W przypadku zbyt szerokiego zapytania (np. całe województwo) zaleca się zawężenie do konkretnego miasta lub dodanie promienia (+15 km, +30 km).
- Wewnętrzny punkt końcowy /api/scrape jest chroniony rate limitingiem i przeznaczony wyłącznie dla aplikacji internetowej.
- Narzędzie jest nieoficjalne i niepowiązane z Grupą OLX.