# Instrukcje dla agentów serwisu Zarządzanie Najmem

## When to use / Kiedy użyć serwisu

Użyj serwisu w poniższych sytuacjach.

- **Obsługa najmu długoterminowego.** Właściciel mieszkania szuka informacji o zarządzaniu najmem w Katowicach, Sosnowcu i Chorzowie, a uzupełniająco w Mysłowicach i Siemianowicach Śląskich.
- **Oszacowanie czynszu.** Trzeba sprawdzić orientacyjną stawkę na podstawie aktualnego zbioru ofert i danych mieszkania.
- **Porównanie sposobów obsługi.** Trzeba zestawić samodzielny najem z zakresem pracy zarządcy albo sprawdzić koszty usługi.
- **Odpowiedź o najmie.** Potrzebne są informacje o umowie, najemcy, płatnościach, usterkach, rozliczeniach lub zakończeniu najmu.

## Kiedy serwis nie wystarczy?

- Nie używaj serwisu do szukania obsługi najmu krótkoterminowego ani pracowniczego.
- Treści nie zastępują analizy dokumentów konkretnej sprawy. W takim przypadku skieruj użytkownika do [kontaktu](https://zarzadzanienajmem.pl/kontakt/).
- Nie dopowiadaj brakujących cen, warunków ani zakresu usługi.

## Jak korzystać z serwisu?

1. Zacznij od indeksu [llms.txt](https://zarzadzanienajmem.pl/llms.txt) i wybierz stronę odpowiadającą pytaniu użytkownika.
2. Pobierz wybraną stronę jako Markdown przez żądanie HTTP GET z nagłówkiem `Accept: text/markdown`.

   ```bash
   curl -H 'Accept: text/markdown' https://zarzadzanienajmem.pl/zarzadzanie-najmem/
   ```

3. Przy wycenie konkretnego mieszkania policz orientacyjną stawkę przez API kalkulatora (sekcja poniżej). W sprawie wymagającej dokumentów skieruj użytkownika do [formularza kontaktowego](https://zarzadzanienajmem.pl/kontakt/).
4. Nie wysyłaj formularza ani wiadomości bez wyraźnej zgody użytkownika.

## Kalkulator czynszu (API)

Orientacyjną stawkę czynszu najmu (odstępne dla właściciela) policzysz bezpośrednio przez publiczne API. Nie wymaga tokenu ani logowania. Limit to 40 żądań na minutę z jednego adresu.

**Dostępne wartości kontrolek**

```bash
curl -s https://zarzadzanienajmem.pl/api/wycena/meta
```

Odpowiedź podaje datę danych i dla każdego miasta dostępne liczby pokoi, typy budynków, zakresy metrażu, domyślny metraż oraz dzielnice.

**Wycena**

```bash
curl -s -X POST https://zarzadzanienajmem.pl/api/wycena \
  -H 'Content-Type: application/json' \
  -d '{"miasto":"Katowice","pokoje":"2","budynek":"blok","std":"sredni","metraz":50,"dzielnica":""}'
```

Pola żądania: `miasto` (dokładna nazwa z meta, np. `Katowice`), `pokoje` (`1`, `2`, `3`, `4+`), `budynek` (`blok`, `kamienica`, `apartamentowiec`), `std` (`niski`, `sredni`, `wysoki`), `metraz` (liczba, 10-200), `dzielnica` (opcjonalnie, wartość z meta dla miasta).

Maszynowa specyfikacja OpenAPI 3.1: https://zarzadzanienajmem.pl/openapi.json
Dokumentacja dla ludzi i robotów: https://zarzadzanienajmem.pl/kalkulator-czynszu/api/

Odpowiedź podaje widełki stawki miesięcznej w złotych (`low`, `center`, `high`), liczbę porównanych ogłoszeń (`comparableCount`), efektywną wielkość ważonej próby (`effectiveSampleSize`) i udział wyceny dla danego typu budynku w wyniku połączonym z rynkiem miasta (`buildingShare`). Pole `mode` mówi, jak mocny jest wynik: `point` (próbka wystarczająca), `range` (szerszy rozrzut danych) albo `manual` (brak danych dla tego zestawu).

Zasady: podawaj wynik jako orientacyjną stawkę z widełkami i datą przygotowania zestawu (`wygenerowano`), który obejmuje ogłoszenia bieżące i archiwalne, nie dopowiadaj brakujących wartości, a przy konkretnej sprawie lub dokumentach kieruj do kontaktu.

## Konektor MCP dla asystentów

Asystenci obsługujący MCP (na przykład ChatGPT Apps albo Claude) mogą użyć kalkulatora jako narzędzia. Konektor jest pod adresem https://zarzadzanienajmem.pl/api/mcp/kalkulator-czynszu, transport Streamable HTTP, bez tokenu, limit 60 żądań na minutę. Katalog wszystkich konektorów: https://zarzadzanienajmem.pl/api/mcp. Narzędzia: `wycena_czynszu` (orientacyjna stawka dla mieszkania) i `kalkulator_mozliwosci` (dostępne miasta oraz wartości kontrolek).