Instrukcja obsługi krok po kroku

MKL Analyzer to lokalne narzędzie (dane nie opuszczają przeglądarki), które zastępuje ręczny arkusz Google przy budowie Master Keyword List. Odtwarza „macierz pokrycia organicznego" (metoda Xray + Cerebro) i rozszerza ją o ważenie ruchem, przejrzysty klasyfikator niszy oraz generator metadanych KDP.

0.Zanim zaczniesz — przygotowanie danych w Cerebro

Aplikacja niczego nie pobiera z Amazona ani Helium 10 — operuje na pliku, który sam eksportujesz. Jakość analizy zależy od doboru konkurentów.

1. W Xray (rozszerzenie Helium 10) wybierz maksymalnie 10 realnie konkurencyjnych produktów: ten sam format, odbiorca, język, temat i poziom cenowy co Twoja planowana książka.
2. Pomijaj wyniki sponsorowane — ASIN-y mają reprezentować rynek organiczny, a nie przypadkowe reklamy.
3. Wygeneruj raport Multi-ASIN w Cerebro i wyeksportuj do XLSX (lub CSV UTF-8).
4. Zostaw oryginalną nazwę pliku — zawiera ona ASIN bazowy (np. US_AMAZON_cerebro_B0FLWR8H2K_2026-07-27.xlsx), który aplikacja odczyta automatycznie.

1.Wczytanie pliku (ekran Import)

1. Wejdź w Apps → MKL Analyzer w Book Publisher Studio (albo otwórz analysis/index.html).
2. Kliknij „Importuj raport" (prawy górny róg lub zakładka Import i mapowanie). Możesz też przeciągnąć plik w dowolne miejsce okna.
3. Dopuszczalne formaty: .xlsx, .xlsm (bez uruchamiania makr), .csv. Dodatkowo .json — kopia zapasowa wcześniejszego projektu.
4. Nie masz pliku pod ręką? Kliknij „Wczytaj przykładowy raport" — załaduje dołączony raport testowy (kolorowanki, 1 264 fraz).

Po wczytaniu aplikacja liczy skrót SHA-256 pliku (do audytu), wykrywa arkusz i przechodzi do mapowania. Jeśli plik ma kilka arkuszy — poprosi o wybór.

2.Mapowanie kolumn i ASIN bazowy

Aplikacja próbuje wszystko rozpoznać automatycznie. Ten ekran służy do weryfikacji i ewentualnej korekty.

Sekcja górna

• Nazwa projektu — domyślnie z nazwy pliku, edytowalna.
• Rynek (preset filtrów) — USA (Organic = 1, SV ≥ 250) lub Europa (SV ≥ 50). To tylko punkt startowy — progi zmienisz później.
• Wiersz nagłówka — wykrywany automatycznie (szukane jednocześnie „Keyword Phrase" i „Search Volume"). Popraw tylko, gdy pojawi się ostrzeżenie.
• ASIN bazowy — odczytany z nazwy pliku. Jeśli pusty, wpisz go ręcznie (wzór B0XXXXXXXX) albo zostaw puste, by pominąć kolumnę Position (Rank).

Mapowanie pól kanonicznych

Pola oznaczone * są wymagane, reszta rozszerza analizę:

Kolumny ASIN konkurentów

Wykrywane wzorcem B0XXXXXXXX i wypisane jako pigułki (np. B0H3F5BZQ8 · kol. 31). Każdy z tych ASIN-ów później włączysz/wyłączysz z obliczeń.

Podgląd 20 wierszy u dołu pozwala potwierdzić, że nagłówki i dane trafiły na właściwe kolumny.

3.Utworzenie projektu (co dzieje się „pod maską")

Klik „Utwórz projekt i analizuj" uruchamia deterministyczny łańcuch:

1. Normalizacja — trim fraz i nagłówków; liczby z kropką/przecinkiem; usunięcie separatorów tysięcy i walut; wartości „-", N/A, puste i ≤0 w kolumnach rankingu zamieniane na null (brak rankingu — nigdy 0).
2. Deduplikacja — frazy identyczne po normalizacji łączone: zostaje rekord o najwyższym Search Volume, a rankingi ASIN-ów scalane przez minimalną dodatnią pozycję. Operacja trafia do logu transformacji.
3. Zapis w IndexedDB — cały raport, mapowanie, parametry i oceny są trwałe. Po odświeżeniu strony projekt otworzysz bez ponownego importu.
4. Analiza — obliczenie macierzy Top N, pokrycia, nasycenia, Opportunity Score i klasyfikacja niszy. Aplikacja przenosi Cię na Dashboard niszy.

4.Konfiguracja analizy

Wszystkie progi to heurystyki, nie prawa rynku — są jawne i edytowalne, a zmiana natychmiast przelicza wyniki.

Filtr bazowy

• Minimalny Search Volume — odcina frazy o zbyt małym popycie (US: 250, EU: 50).
• Top N — próg „pierwszej strony". Domyślnie 30, ale pierwsza strona nie zawsze ma 30 wyników — dostosuj (np. 24, 32, 50).
• Wymagaj Organic = 1 — gdy kolumna Organic nie jest zmapowana, wyłącz filtr (inaczej odrzuci wszystko — pojawi się ostrzeżenie).

Progi kolorów pokrycia

„Silny konkurent" = pasmo pomarańczowe lub czerwone (pokrycie ≥ próg pomarańczowy, domyślnie 60%). Ta liczba napędza klasyfikator.

Klasyfikator GO / NO-GO

Edytowalne progi liczby silnych konkurentów i nasycenia fraz oraz minimalne wymagania danych (min. ASIN-y, min. frazy). Reguły — patrz sekcja 14.

Wagi Opportunity Score

Domyślnie: wolumen 0,35 · luka konkurencji 0,35 · luka Title Density 0,15 · trafność 0,15 (suma = 1,00). Do tego cap Title Density. Score to model tej aplikacji (wersjonowany), nie metryka Helium 10.

Aktywne ASIN-y

Odznacz ASIN, który nie jest realnym konkurentem — bez modyfikowania danych źródłowych. Nadaj czytelne etykiety (np. tytuł książki). Poniżej 3 aktywnych ASIN-ów decyzja zostanie oznaczona jako „niewystarczające dane".

Profile filtrów

Zapisz komplet parametrów pod nazwą (np. „US kolorowanki") i zastosuj w innych projektach jednym kliknięciem.

5.Dashboard niszy — pierwsze spojrzenie

Górny baner pokazuje decyzję (GO / GO warunkowe / NO-GO / niewystarczające dane) wraz z listą „Dlaczego" — dokładnie który warunek ją wywołał.

Kafle KPI

• Kwalifikowane frazy i suma Search Volume — rozmiar analizowanego pola.
• Silni konkurenci, mediana pokrycia, koncentracja ruchu, nasycenie fraz — cztery miary trudności (definicje w słowniczku).

Wykres „Pokrycie konkurentów"

Paski w kolorach progowych, sortowane malejąco. Przełącznik Zwykłe / Ważone SV: pokrycie zwykłe traktuje frazę o SV 50 tak samo jak SV 5 000; pokrycie ważone pokazuje realny udział w ruchu. Rozbieżność tych dwóch liczb to ważny sygnał.

„Rozkład nasycenia fraz"

Ile fraz ma 0, 1, 2… konkurentów w Top N. Duży słupek przy „0" = dużo potencjalnych luk (patrz sekcja 8).

„Top 10 szans"

Frazy o najwyższym Opportunity Score. Etykieta „wstępny" oznacza brak ręcznej oceny trafności — patrz następny krok.

6.Master Keyword List — serce procesu

1. Przejrzyj wirtualizowaną tabelę wszystkich kwalifikowanych fraz (nie tylko Top 10). Kolumny: SV, ile ASIN-ów w Top N, Title Density, Competing Products (liczba produktów w wynikach — im mniej, tym łatwiej), CPR (egzemplarze do 8-dniowego rank testu — im mniej, tym taniej), Keyword Sales, Opportunity Score.
2. Zawęź pole filtrami zakresów (jak w Cerebro): min–max dla Search Volume, Title Density, Competing Products, CPR, liczby słów i Keyword Sales. Puste pole = brak ograniczenia; fraza bez wartości metryki przy ustawionym zakresie jest odrzucana (tak samo działa filtr w Cerebro). Przycisk „Wyczyść” zeruje wszystkie zakresy.
3. W polu Trafność (0–100) oceń, czy fraza faktycznie pasuje do Twojej książki. Score przelicza się od razu, a etykieta „wst." znika.
4. Nadaj kategorię: Primary · Secondary · Long-tail · Semantic · Negative / Excluded. Negative/Excluded usuwają frazę z analizy (i z liczników).
5. Przypnij (gwiazdka) kandydatów kluczowych — wędrują na górę.
6. Ikona „podobne frazy" pokazuje warianty tokenowo bliskie (Jaccard > 30%) — pomaga wychwycić kanibalizację i synonimy.

Filtry: szukajka, kategoria, „Bez oceny", „Przypięte". Sortowanie domyślne: trafność ↓, Opportunity Score ↓, SV ↓.

7.Macierz Top N (heatmapa)

Pełna siatka fraza × ASIN z surowymi pozycjami. Kolory: 1–10 (mocno), zieleń jaśniejsza 11–Top N, żółty tuż za progiem, szare „brak". Kolumna Σ TopN = ilu aktywnych ASIN-ów rankuje na daną frazę. Przełącznik „Tylko z Top N" i paginacja po 100 fraz. Służy do ręcznej weryfikacji, skąd biorą się wskaźniki pokrycia.

8.Luki keywordowe — gdzie jest okazja

9.Tokeny i n-gramy — budulec metadanych

Rozkład pojedynczych słów i bigramów, ważony Search Volume, z kolumną „Śr. nasycenie" (średni udział ASIN-ów w Top N dla fraz z danym tokenem).

10.PPC i popyt

Zestawienie wyłącznie na danych z raportu: sugerowane bidy H10 (min/śr/max), Keyword Sales, CPR (egz. do 8-dniowego rank testu), liczba sponsorowanych ASIN-ów (presja reklamowa) oraz wskaźnik „Sprzedaż / $ bidu" (Keyword Sales ÷ sug. bid) — pomaga wskazać frazy o najlepszym stosunku popytu do kosztu kliknięcia. Sortowanie do wyboru.

11.KDP Builder — tytuł i 7 pól

1. Kandydaci do tytułu — frazy Primary/Secondary lub o trafności ≥ 70. Ikoną „+" dodajesz je do pola tytułu.
2. Metadane robocze — pola Tytuł/Podtytuł (licznik do 200) i 7 pól keywords (licznik do 50 znaków; przekroczenie na czerwono).
3. Propozycja 7 pól — algorytm greedy pakuje frazy do pól ≤ 50 znaków, bez powtarzania tokenów (Amazon indeksuje token raz) i pomijając słowa użyte w top 3 kandydatach do tytułu. „Wstaw wszystkie do pól" kopiuje je do notatnika.
4. Ostrzeżenie o duplikatach — jeśli w Twoich polach powtórzysz token, aplikacja go wskaże (zmarnowany limit znaków).

12.Walidacja i log — transparentność

• Lejek kwalifikacji — licznik fraz na każdym etapie: wszystkie → po walidacji → po Organic → po Search Volume → po wykluczeniach ręcznych.
• Log transformacji — co scalono/odrzucono przy imporcie.
• Log audytu — każda zmiana parametrów, ocen i kategorii ze znacznikiem czasu; „Pobierz pełny log" zapisuje JSON.
• Odrzucone rekordy — fraza, SV, Organic i powód odrzucenia (pełna lista trafia do eksportu XLSX, arkusz Excluded).

13.Eksport wyników

14.Decyzja końcowa — jak ją czytać i co robić

Klasyfikator jest jawny. Domyślne reguły (edytowalne w Konfiguracji):

Sekwencja decyzyjna:

1. Odczytaj status i listę „Dlaczego" na Dashboardzie.
2. Sprawdź, czy to nie „niewystarczające dane" — jeśli tak, popraw dobór ASIN-ów/filtry i wróć.
3. Porównaj pokrycie zwykłe i ważone lidera — czy dominacja dotyczy ruchu, czy tylko liczby fraz?
4. Nawet przy NO-GO przejrzyj „Luki" i „Nieobsadzone" — tam bywają wartościowe frazy long-tail.
5. Podejmij dwie osobne decyzje: (a) wchodzę w niszę czy nie, (b) które keywordy trafią do metadanych (po ocenie trafności).
6. Wyeksportuj XLSX/JSON jako zapis decyzji z parametrami i wersją algorytmu.

15.Słowniczek wskaźników i wzory

Pokrycie i nasycenie

Opportunity Score (0–100)

Kluczowa zasada: brak rankingu ≠ pozycja 0. Pozycja 0 oznaczałaby najlepszy wynik i zafałszowała analizę — dlatego puste/„-"/≤0 to null.

16.Rozwiązywanie problemów i przypadki brzegowe

17.Rekomendowany workflow — skrót jednej strony

1. Cerebro Multi-ASIN → eksport XLSX (do 10 realnych konkurentów, bez sponsorowanych).
2. Import → potwierdź mapowanie i ASIN bazowy → Utwórz projekt.
3. Konfiguracja → ustaw rynek, Top N, ewentualnie wyłącz nietrafionych konkurentów.
4. Dashboard → odczytaj decyzję i przyczyny; porównaj pokrycie zwykłe vs ważone.
5. Master Keyword List → oceń trafność kluczowych fraz, nadaj kategorie, przypnij najlepsze.
6. Luki + Tokeny → wyłów frazy do zdobycia i mocne tokeny.
7. KDP Builder → zbuduj tytuł i 7 pól (bez duplikacji tokenów, w limitach znaków).
8. Eksport → XLSX (raport) + JSON (kopia/archiwum decyzji).

MKL Analyzer działa w całości lokalnie — brak telemetrii, brak wysyłania pliku. Progi, wagi i klasyfikator są jawne i edytowalne; Opportunity Score jest modelem tej aplikacji (wersjonowanym), a nie metryką Helium 10. Ten dokument możesz wydrukować lub zapisać do PDF (Cmd/Ctrl + P → „Zapisz jako PDF").