Ręczniki Haftowane MCP Server

Listuje kategorie wzorów haftu, w których są aktywne wzory: id, nazwa, slug i liczba wzorów. Nazwę lub slug przekaż jako category do list_designs, aby zobaczyć wzory z danej kategorii. Narzędzie nie przyjmuje parametrów.

Słownik tagów wzorów haftu (grupy motyw, okazja, odbiorca; definicje, liczby wzorów, wartości persons) oraz instrukcja doboru. Wywołaj raz na rozmowę przed pierwszym filtrem tagów w list_designs; nie twórz własnych tagów. Narzędzie nie przyjmuje parametrów.

Zamknięta lista kolorów typu przedmiotu: option_id (kreatora), color_name, color_family, color_hex, availability, as_of. Wywołaj dopiero, gdy klient wybiera kolor; asset_type_id weź z contents w get_product_options. Nazwę koloru klienta przekaż dosłownie w query: dopasowanie robi sklep i zwraca match (status, option_ids, message); nie dopasowuj nazw sam ani przybliżeniami i wybieraj tylko option_id z odpowiedzi. Dla status candidates lub needs_clarification dopytaj klienta; no_match oznacza brak takiego koloru. Brak pola stanu magazynowego: available znaczy tylko aktywna opcja. include_unavailable pokazuje też wyłączone opcje.

Link do kreatora z wyborami klienta w slots[]. Pozycja n z contents get_product_options odpowiada slots[n-1]. option_id z list_colors (colors[].option_id) dla typu przedmiotu, walidowany przez sklep przy każdym wywołaniu (błąd invalid_input z details[]: reason, allowed_option_ids, message; wybierz jedno z allowed_option_ids); drawing_id z list_designs, thread_id i font_id z list_fonts_threads. Przekaż wszystkie wybory klienta: kolor, wzór, nić, czcionkę i texts (mapa kluczy pól tekstowych). Bez slots[], tab i slot link nie ma ustawień (configuration_notice). tab wybiera zakładkę, slot (1-based) aktywny slot.

Wyszukuje aktywne wzory haftu (filtr liczy sklep). Filtry opcjonalne: tags (identyfikatory wyłącznie z list_design_tags, do 10; w grupie OR, między grupami AND), motif_match any|all (all = wszystkie motywy na jednym wzorze), persons 1|2|initials (liczba imion/inicjały), category (nazwa lub slug), query (nazwa wzoru, do 100 znaków), ids (do 20), sort default|popular, limit (domyślnie 10, maks. 20) i offset. Wynik: total, has_more, applied_filters, empty_reason i relaxations (przy total=0 tylko propozycje poluzowania: powiedz klientowi, który warunek poluzowano; nie przedstawiaj ich jako spełnienia konkretnego motywu). Każdy wzór ma tags, personalization, texts (slot_key, label, max_chars) i match. Pole id to drawing_id używane przez kreator. WAŻNE: pokaż klientowi podgląd wzoru jako obraz - wstaw preview_markdown () do odpowiedzi, nie podawaj samego linku; gdy preview_markdown jest null, wzór nie ma podglądu.

Pobiera pełną treść publicznego produktu po id zwróconym przez search, wraz z tytułem i URL-em do cytowania.

Listuje publiczne czcionki i nici dostępne w kreatorze. Zwraca id jako odpowiednio font_id i thread_id, nazwę, podgląd jako pełny URL oraz gotowy markdown obrazu; nici zawierają także color_hex w formacie #RRGGBB. Narzędzie nie przyjmuje parametrów.

Skład produktu (contents): przedmioty, ilości, positions (1-based), customizable i liczba kolorów. Wzory dla pozycji z design_category_id wybieraj z list_designs, których categories zawiera tę kategorię. Kolory pobierz przez list_colors dopiero przy wyborze koloru, podając asset_type_id. Dostawa, terminy i materiał: get_shop_policies. Ceny: *_minor (grosze), *_formatted (PLN); regular_price_* tylko w promocji. Po link z wyborami użyj get_creator_link.

Produkty sklepu: id, name, cena, for (dla kogo), contains (skład), product_url, image_url. Pusty query listuje cały katalog (kilkanaście pozycji): nie zgaduj słów kluczowych, nie wpisuj zdania klienta. Kwoty: *_minor (grosze), *_formatted; regular_price_* tylko w promocji. Dobierz opcjonalne min_price_minor i max_price_minor do prośby klienta: liczby całkowite >= 0 w groszach, min_price_minor <= max_price_minor, granice włącznie, cena jednego produktu/zestawu. „od 100 do 200” lub „100-200” oznacza min_price_minor=10000 i max_price_minor=20000; „do 150” oznacza tylko max_price_minor=15000. Jeśli wynik jest pusty (total=0, truncated=false), a podano granice ceny, ponów search_products bez min_price_minor i max_price_minor, zachowując pozostałe argumenty. Wyjaśnij klientowi, że propozycje są spoza podanego budżetu.

Wyszukuje publiczne produkty sklepu. Zwraca identyfikatory, tytuły i kanoniczne URL-e zgodne z formatem ChatGPT search/fetch.

Zasady sklepu: waluta PLN, metody i ceny dostawy, próg darmowej dostawy, termin realizacji z dostawą i opis materiału. Kwoty: *_minor (grosze), *_formatted (PLN); null gdy brak danych. Narzędzie nie przyjmuje parametrów. Pusty katalog daje not_found, niedostępność sklepu shop_unavailable.

Analityka ruchu sklepu z Matomo (tylko agregaty). Wizyty, akcje, unikalni AI, platformy i zamówienia. Bez argumentów raportuje wczoraj w Europe/Warsaw. period last_1/last_7/last_30 zamiast dat; compare=previous_period porównuje z poprzednim oknem. data_status rozróżnia zero od braku danych; unikalnych z wielu dni nie sumuj. Nazwę platformy podawaj tylko z by_provider; unknown = nieznana. Podaj źródło i niepewności z metadata.attribution_caveats. AI referrals to natywny kanał Matomo; kampanie AI są osobno, boty i cytowania nie są mierzone.