💡 Keyword Studio · Book Publisher Studio
Instrukcja obsługi krok po kroku
Od wczytania raportu Helium 10 Cerebro, przez ocenę fraz pod kątem sprzedaży organicznej,
aż do short-listy keywordów i kandydatów na nisze.
Wersja aplikacji 1.0.0 · wersja algorytmu 1.0.0 · dokument roboczy zespołu Amazon KDP.
Keyword Studio to lokalne narzędzie (dane nie opuszczają przeglądarki), które z pojedynczego
eksportu Helium 10 Cerebro wyławia frazy o realnym potencjale sprzedaży organicznej,
grupuje je w kandydatów na nisze i pomaga zbudować roboczą short-listę do metadanych KDP i kampanii PPC.
Uzupełnia aplikację MKL Analyzer: tam analizujesz pokrycie konkurentów (Multi-ASIN),
tu — jakość samych fraz.
Zasada nadrzędna
Liczby mówią o popycie i konkurencji, ale nie znają Twojej książki. Każdą frazę z short-listy
potwierdź ręcznie: czy jest na temat, czy nie zawiera znaku towarowego, czy pasuje do formatu.
Aplikacja niczego nie publikuje automatycznie.
0.Zanim zaczniesz — przygotowanie danych w Cerebro
Aplikacja niczego nie pobiera z Amazona ani Helium 10 — operuje na pliku, który sam eksportujesz.
- W Cerebro uruchom analizę dla wybranego ASIN-u (bestseller wzorcowy z Twojej niszy)
albo dla kilku ASIN-ów (Multi-ASIN). Do tej aplikacji wystarczy raport jednego produktu —
kolumny rankingów konkurentów nie są tu używane.
- Nie zawężaj zbyt mocno filtrów w Cerebro — lepiej wyeksportować szeroko i filtrować w aplikacji
(filtry zakresów działają identycznie, a masz je zapisane w projekcie).
- Wyeksportuj do XLSX (lub CSV UTF-8).
- Ważne kolumny:
Keyword Phrase, Search Volume, Keyword Sales,
Competing Products, CPR, Title Density, Search Volume Trend,
Organic i sugerowane bidy PPC. Im więcej z nich w pliku, tym pełniejsza analiza.
Kiedy Keyword Studio, a kiedy MKL Analyzer?
Keyword Studio odpowiada na pytanie „które frazy z tego raportu dadzą sprzedaż organiczną
i gdzie są nisze?”. MKL Analyzer odpowiada na pytanie „jak mocno konkurenci pokrywają
te frazy i czy nisza jest otwarta (GO/NO-GO)?” — wymaga raportu Multi-ASIN z kolumnami rankingów.
W praktyce: najpierw Keyword Studio (selekcja fraz i nisz), potem MKL Analyzer (weryfikacja konkurencji).
1.Wczytanie pliku (ekran Import)
- Wejdź w Apps → Keyword Studio w Book Publisher Studio (albo otwórz keywords/index.html).
- Kliknij „Importuj raport” (prawy górny róg lub zakładka Import i mapowanie). Możesz też przeciągnąć plik w dowolne miejsce okna.
- Dopuszczalne formaty:
.xlsx, .xlsm (bez uruchamiania makr), .csv. Dodatkowo .json — kopia zapasowa wcześniejszego projektu.
- 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
Aplikacja rozpoznaje kolumny automatycznie po nagłówkach Cerebro. Ten ekran służy do weryfikacji i ewentualnej korekty.
| Pole | Nagłówek Cerebro | Rola w analizie |
|---|
| keyword * | Keyword Phrase | fraza — jednostka analizy |
| searchVolume * | Search Volume | popyt (składnik score, filtr bazowy) |
| keywordSales | Keyword Sales | dowód sprzedaży (składnik score, odznaka 💲) |
| competingProducts | Competing Products | konkurencja (składnik score, odznaka 🎯, werdykty nisz) |
| cpr | CPR | koszt rank testu (składnik score, odznaka 🚀) |
| titleDensity | Title Density | luka w tytułach (składnik score, odznaka 🔓) |
| organicFlag | Organic | filtr / odznaka ✓ |
| svTrend | Search Volume Trend | zakładka Trendy, odznaka 📈 |
| suggBid, sponsoredAsins… | odpowiednie kolumny | zakładka PPC |
Braki krytyczne blokują analizę Przycisk „Utwórz projekt i analizuj”
jest aktywny dopiero, gdy zmapowano Keyword Phrase i Search Volume. Pozostałe pola są opcjonalne —
brak metryki daje w score neutralne 0,5 (a brak Keyword Sales liczy się jako brak dowodu sprzedaży = 0).
3.Utworzenie projektu (co dzieje się „pod maską”)
- Normalizacja — trim fraz i nagłówków; liczby z kropką/przecinkiem; usunięcie separatorów tysięcy i walut; wartości
„-”, N/A i puste zamieniane na null (brak danych, nie zero).
- Deduplikacja — frazy identyczne po normalizacji łączone: zostaje rekord o najwyższym Search Volume, brakujące metryki uzupełniane z duplikatu. Operacja trafia do logu transformacji.
- Zapis w IndexedDB — cały raport, mapowanie, parametry, wybory i notatki są trwałe. Po odświeżeniu strony projekt otworzysz bez ponownego importu.
- Analiza — obliczenie Organic Sales Score, klas A–D, odznak i klastrów niszowych. Aplikacja przenosi Cię na Przegląd.
4.Konfiguracja analizy
Wszystkie progi to jawne heurystyki — są edytowalne, a zmiana natychmiast przelicza wyniki. Nic nie dzieje się w ukrytym „AI score”.
Filtr bazowy
- Minimalny Search Volume — odcina frazy o śladowym popycie (US: 100, EU: 50). Celowo luźny — dokładną selekcję robisz filtrami zakresów.
- Wymagaj Organic = 1 — zostawia tylko frazy, na które badany ASIN rankuje organicznie. Domyślnie wyłączone (przy badaniu niszy chcesz widzieć całe pole).
Wagi Organic Sales Score
Domyślnie: popyt 0,30 · dowód sprzedaży 0,25 · niska konkurencja 0,25 · rankowalność 0,20 (suma = 1,00).
Punkty odniesienia (caps)
CP cap 100 000 · CPR cap 60 · TD cap 10 — metryka równa capowi daje 0 punktów w swoim składniku, 0 daje pełny wynik.
Progi klas A/B/C, odznak i nisz
Klasy: A ≥ 65, B ≥ 50, C ≥ 35. Odznaki: 💲 Keyword Sales ≥ 5 · 🎯 CP ≤ 2 000 · 🚀 CPR ≤ 10 · 🔓 TD ≤ 1 · 📈 trend ≥ +20%.
Nisze: min. 3 frazy i Σ SV ≥ 1 000; „obiecująca” przy medianie CP ≤ 5 000; „nasycona” przy medianie CP ≥ 30 000 lub śr. TD ≥ 5.
Profile parametrów
Zapisz komplet parametrów pod nazwą (np. „US kolorowanki”) i zastosuj w innych projektach jednym kliknięciem.
5.Przegląd — pierwsze spojrzenie
Kafle KPI
- Kwalifikowane frazy, suma Search Volume, suma Keyword Sales — rozmiar i „monetyzowalność” pola.
- Frazy klasy A — ile fraz od razu nadaje się do metadanych.
- Mediana Competing Products i mediana CPR — jak trudny i drogi jest ten rynek w ujęciu typowej frazy.
Wykresy
Rozkład klas (A/B/C/D), rozkład długości fraz (fioletowe słupki = long-tail),
rozkład Search Volume i odznaki w zbiorze — pięć szybkich odpowiedzi na pytanie
„czy w tym raporcie w ogóle jest co zbierać?”.
Top 10 rekomendacji
Najlepsze frazy wg score, z widocznymi od razu Competing Products, CPR i TD. Pełna lista — zakładka Rekomendacje.
6.Rekomendacje — serce procesu
- Przejrzyj tabelę wszystkich kwalifikowanych fraz (wirtualizowana — działa płynnie przy tysiącach wierszy).
Kolumny: klasa, score, SV, trend, Keyword Sales, Competing Products, CPR, TD, liczba słów i odznaki.
- Zawęź pole filtrami zakresów (jak w Cerebro): min–max dla Search Volume, Keyword Sales,
Competing Products, CPR, Title Density i liczby słów. Puste pole = brak ograniczenia.
- Dodatkowe filtry: szukajka, klasa, odznaka, „Organic = 1”, „Przypięte”, „Wybrane”.
- Zaznacz checkboxem frazy, które chcesz zabrać dalej — trafiają do „Listy wybranych”.
Gwiazdka przypina frazę na górze listy.
- Klik nagłówka kolumny sortuje; drugi klik odwraca kierunek; trzeci wraca do sortowania domyślnego (score ↓).
Przepisy filtrów, które działają (punkt startowy)
Złote frazy: SV 250–5 000 · Competing Products max 2 000 · TD max 3 · Keyword Sales min 5.
Tani rank test: CPR max 10 · SV min 250.
Long-tail pod 7 pól: liczba słów min 4 · SV min 100 · Competing Products max 5 000.
To heurystyki kursowe — dostosuj do swojej niszy i formatu.
Fraza bez wartości metryki odpada z filtra
Jeśli ustawisz zakres np. Keyword Sales min 5, to frazy bez danych o sprzedaży zostaną odfiltrowane
(tak samo działa filtr w Cerebro). Chcesz je zobaczyć? Wyczyść dany zakres.
7.Kandydaci na nisze
Aplikacja grupuje frazy po wspólnych rdzeniach 2–3-słowowych (n-gramach). Każdy klaster dostaje
Niche Score i werdykt:
| Werdykt | Warunek domyślny | Co robić |
|---|
| Obiecująca | mediana Competing Products ≤ 5 000 i Σ SV ≥ 1 000 | mocny kandydat — otwórz klaster, przejrzyj frazy, dodaj do wybranych; zweryfikuj konkurencję w MKL Analyzer |
| Do weryfikacji | pomiędzy progami | przejrzyj frazy klastra ręcznie — bywa tu dużo wartościowego long-taila |
| Nasycona | mediana CP ≥ 30 000 lub śr. TD ≥ 5 | trudny rynek — wchodź tylko z wyraźnym kątem/odróżnieniem |
Klik wiersza otwiera frazy klastra z pełnymi metrykami; przycisk „Dodaj frazy klastra do wybranych”
przenosi cały klaster na short-listę jednym kliknięciem. Przełącznik Bigramy/Trigramy zawęża widok do rdzeni 2- lub 3-słowowych.
8.Long-tail
Frazy o ≥ 3/4/5 słowach (przełącznik), posortowane po score. Mniejszy popyt, ale precyzyjna intencja zakupowa
i zwykle znacznie łatwiejsza konkurencja — idealny materiał do 7 pól keywords i kampanii PPC exact.
Checkboxy działają jak w Rekomendacjach.
9.Trendy
Dwie listy: rosnące (trend ≥ +20%) i spadające (trend ≤ −20%), z edytowalnymi progami.
Frazy rosnące o niskiej konkurencji to okno wejścia; mocno spadające mogą oznaczać wygasający sezon —
ostrożnie z budowaniem na nich całej książki. Pamiętaj o sezonowości (np. „halloween coloring book” jesienią).
10.PPC i popyt
Zestawienie wyłącznie na danych z raportu: sugerowane bidy H10 (min/śr/max), Keyword Sales,
CPR, 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.
11.Lista wybranych
- Wszystkie frazy zaznaczone checkboxem, z pełnymi metrykami i polem notatki (np. „do tytułu”, „pole 3”, „PPC exact”).
- Kopiuj frazy — krzyżyk kopiuje listę do schowka (jedna fraza na linię) — wygodne do wklejenia w KDP Builder aplikacji MKL Analyzer albo w panel kampanii.
- Licznik znaków łącznych pomaga oszacować, ile z 7×50 znaków pól KDP wykorzystasz.
- Eksport CSV/XLSX — zakładka Eksport.
Przed użyciem w metadanych Sprawdź każdą frazę: zgodność z treścią książki,
znaki towarowe, poprawność językową. Aplikacja ocenia liczby — nie zna Twojej okładki ani treści.
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 i wyborów 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
| Format | Zawartość |
|---|
| XLSX | arkusze: Summary (parametry, KPI) · Recommendations (wszystkie frazy ze score) · Selected · Niches · Long-tail · PPC · Excluded · Audit |
| CSV | rekomendacje albo tylko frazy wybrane (do dalszej obróbki) |
| JSON | pełna kopia projektu — po ponownym imporcie odtwarza identyczny projekt, parametry, wybory i notatki |
14.Słowniczek wskaźników i wzory
Metryki źródłowe (Helium 10)
| Metryka | Co znaczy | Dobre wartości (heurystyka) |
|---|
| Search Volume (SV) | miesięczna liczba wyszukiwań frazy | ≥ 250 (frazy główne), ≥ 100 (long-tail) |
| Keyword Sales | szacowana miesięczna sprzedaż przez frazę | ≥ 5 |
| Competing Products | liczba produktów w wynikach dla frazy | ≤ 2 000 świetnie · ≤ 20 000 OK · ≥ 30 000 trudno |
| CPR | egzemplarze do sprzedania w ~8 dni, by wejść na 1. stronę | ≤ 10 tanio · ≥ 30 drogo |
| Title Density (TD) | ilu z pierwszej strony ma frazę wprost w tytule | 0–1 luka · ≥ 5 nasycone |
| Search Volume Trend | zmiana popytu w % | ≥ +20% rośnie · ≤ −20% wygasa |
| Organic | czy badany ASIN rankuje organicznie na frazę | 1 = tak |
Organic Sales Score (0–100)
demandNorm = log(1+SV) / log(1+maxSV)
salesNorm = log(1+KeywordSales) / log(1+maxKS) (0 gdy brak danych)
compGap = 1 − log(1+CompetingProducts) / log(1+cpCap) (0,5 gdy brak)
cprGap = 1 − min(CPR / cprCap, 1) (0,5 gdy brak)
tdGap = 1 − min(TitleDensity / tdCap, 1) (0,5 gdy brak)
rankGap = 0,6·cprGap + 0,4·tdGap
Score = 100 · (0,30·demandNorm + 0,25·salesNorm + 0,25·compGap + 0,20·rankGap)
Klasy: A ≥ 65 · B ≥ 50 · C ≥ 35 · D < 35. Wagi, capy i progi edytowalne w Konfiguracji; score jest modelem tej aplikacji (wersjonowanym), nie metryką Helium 10.
Niche Score (0–100)
NicheScore = 100 · ( 0,35·norm(Σ SV) + 0,25·norm(Σ KeywordSales)
+ 0,25·(1 − norm(mediana CP)) + 0,15·(1 − śr.TD/tdCap) )
Odznaki
💲 Keyword Sales ≥ 5 · 🎯 Competing Products ≤ 2 000 · 🚀 CPR ≤ 10 · 🔓 TD ≤ 1 · 📈 trend ≥ +20% · ✓ Organic = 1.
15.Rozwiązywanie problemów i przypadki brzegowe
| Sytuacja | Zachowanie / co zrobić |
|---|
| Brak kolumny Keyword Sales / CPR / CP | score liczy się z neutralnym 0,5 dla brakującego składnika (sprzedaż = 0); zmapuj kolumnę, jeśli jest w pliku |
| Filtr zakresu „zjada” frazy | frazy bez wartości metryki odpadają przy ustawionym zakresie — wyczyść zakres, by je zobaczyć |
| Zero kwalifikowanych fraz | obniż minimalny Search Volume albo wyłącz „Wymagaj Organic = 1” — komunikaty w lejku wskażą przyczynę |
| Brak kolumny Organic przy włączonym filtrze | ostrzeżenie w Konfiguracji; wyłącz filtr albo popraw mapowanie |
| Za mało klastrów w Niszach | zmniejsz „min. fraz w klastrze” albo „min. Σ SV” w Konfiguracji |
| Odświeżenie strony | ostatni zapisany projekt pozostaje spójny (IndexedDB) |
| Przeniesienie na inny komputer | eksportuj JSON i zaimportuj go tam (IndexedDB jest lokalne dla przeglądarki) |
16.Rekomendowany workflow — skrót jednej strony
- Cerebro → eksport XLSX (szeroko, bez agresywnych filtrów).
- Import → potwierdź mapowanie → Utwórz projekt.
- Przegląd → oceń rozmiar pola: suma SV, suma sprzedaży, liczba fraz klasy A, mediany CP i CPR.
- Rekomendacje → ustaw filtry zakresów (np. „złote frazy”), zaznacz najlepsze checkboxem.
- Kandydaci na nisze → przejrzyj „obiecujące” klastry, dodaj dobre frazy hurtowo.
- Long-tail + Trendy → uzupełnij short-listę frazami 4+ słów i rosnącymi.
- Lista wybranych → notatki (tytuł / pole / PPC), kopiuj lub eksportuj.
- Weryfikacja konkurencji → raport Multi-ASIN w MKL Analyzer (pokrycie, GO/NO-GO, KDP Builder).
- Eksport → XLSX (raport) + JSON (kopia/archiwum decyzji).
Keyword Studio działa w całości lokalnie — brak telemetrii, brak wysyłania pliku.
Progi, wagi i klasyfikacje są jawne i edytowalne; Organic Sales Score i Niche Score są modelami tej aplikacji
(wersjonowanymi), a nie metrykami Helium 10. Ten dokument możesz wydrukować lub zapisać do PDF
(Cmd/Ctrl + P → „Zapisz jako PDF”).