# Lookly - Skill Description

## Co potrafi Lookly

Lookly umożliwia rezerwację wizyt beauty online w Polsce. Agent może:

- Znaleźć artystkę beauty według miasta i kategorii usługi
- Wyświetlić profil artystki z usługami, cenami i godzinami dostępności
- Przekierować użytkownika do formularza rezerwacji online
- Odpowiedzieć na pytania o dostępne usługi i ich ceny

## Wymagane dane do rezerwacji

Aby umówić wizytę, potrzebne są:
- Imię i nazwisko klientki
- Numer telefonu
- Wybrana artystka (slug profilu lub URL profilu)
- Wybrana usługa
- Preferowany termin (data i godzina)

Rezerwacja nie wymaga rejestracji ani logowania.

## Jak znaleźć artystkę

**Według miasta i kategorii:**
```
GET https://lookly.pl/{miasto}/{kategoria}
```
Przykład: `https://lookly.pl/rybnik/makijaz`

**Dane listy w Markdown (artystki, najbliższe wolne terminy, cennik, FAQ):** dopisz `/md` do adresu listy, np. `https://lookly.pl/rybnik/makijaz/md`. Przy każdej artystce z rezerwacją online lista podaje najbliższe wolne godziny z linkami do rezerwacji na tę godzinę (odświeżane co godzinę).

**Według typu usługi:**
```
GET https://lookly.pl/{miasto}/{kategoria}/{typ-uslugi}
```
Przykład: `https://lookly.pl/rybnik/makijaz/makijaz-slubny`

**Dane profilu artystki (Markdown):**
```
GET https://lookly.pl/p/{slug}.md
```
Zwraca w formacie Markdown te same fakty co strona profilu: usługi z cenami i czasem trwania, opinie (średnia, rozkład, 5 najnowszych), adres i dojazd, godziny przyjęć, zasady wizyt, FAQ, podobne artystki i kontakt. To samo pod `/p/{slug}/md` albo z nagłówkiem `Accept: text/markdown`.

## Jak przeprowadzić rezerwację

1. Pobierz dane artystki: `GET https://lookly.pl/p/{slug}.md`
2. Wyświetl użytkownikowi dostępne usługi i godziny
3. Przekieruj do rezerwacji: `https://lookly.pl/p/{slug}/umow`
4. Formularz na stronie zbiera dane klientki i potwierdza termin

Jeśli sekcja „Rezerwacja i kontakt” w danych Markdown profilu mówi, że profil nie przyjmuje jeszcze rezerwacji przez Lookly, strona `/umow` nie istnieje - podaj użytkownikowi numer telefonu z tej sekcji.

## Serwer MCP (dla asystentów AI)

Zamiast czytać strony możesz użyć serwera MCP Lookly:

```
POST https://lookly.pl/api/mcp
```

Streamable HTTP, bez logowania, tylko odczyt. Narzędzia: `search_artists` (artystki w mieście), `get_artist_services` (usługi, ceny, zasady), `get_free_slots` (wolne godziny), `prepare_booking` (sprawdza godzinę i zwraca link rezerwacji z wybraną usługą i terminem). Lista narzędzi z opisami: `https://lookly.pl/llms.txt`. Konfiguracja klientów (Claude, ChatGPT, Claude Code, Cursor, VS Code, Gemini CLI), parametry narzędzi i przykładowe pytania: `https://lookly.pl/agents/md`.

Link rezerwacji z wybraną usługą i terminem: `https://lookly.pl/p/{slug}/umow?services={id}&start=2026-11-10T13:00` (czas Europe/Warsaw).

## Dostępne kategorie

| Kategoria | Slug |
|-----------|------|
| Makijaż | `makijaz` |
| Paznokcie | `paznokcie` |
| Fryzjer | `fryzjer` |
| Brwi i Rzęsy | `brwi-i-rzesy` |
| Makijaż permanentny | `makijaz-permanentny` |
| Depilacja | `depilacja` |
| Pielęgnacja twarzy | `pielegnacja-twarzy` |
| Stylizacja | `stylizacja` |

## Ograniczenia

- Platforma działa wyłącznie w Polsce
- Rezerwacja odbywa się na stronie Lookly: serwer MCP przygotowuje link, ale nie tworzy rezerwacji
- Dostępność artystki zmienia się dynamicznie - zawsze sprawdzaj aktualny stan na stronie

## Pełna dokumentacja

- Pełny opis platformy: `https://lookly.pl/llms.txt`
- Mapa strony: `https://lookly.pl/sitemap.xml`
