Badanie słów kluczowych SEO/GEO
Umiejętność agenta, która bada i dostarcza priorytetową listę słów kluczowych dla SEO i GEO — wykorzystując wyszukiwanie w sieci i analizę AI zamiast płatnych narzędzi, takich jak Ahrefs czy Semrush.
Nie wymaga Ahrefs ani Semrush.
Wykorzystuje wyszukiwanie internetowe, przeszukiwanie stron i analizę LLM, aby znaleźć, grupować i priorytetyzować słowa kluczowe — w tym wymiar GEO, którego tradycyjne narzędzia nie oferują. Opcjonalnie wzmocnij badanie za pomocą skryptów SERP API do pozyskiwania prawdziwych danych autouzupełniania, PAA i funkcji SERP.
Instalacja
Sklonuj repozytorium, a następnie utwórz dowiązanie symboliczne lub skopiuj research-keywords/ do katalogu ~/.codex/skills/ lub ~/.claude/skills/. Przykłady instalacji znajdziesz w głównym README.
Użycie
/research-keywords
Lub:
"Zbadaj słowa kluczowe dla mojego produktu" "Znajdź słowa kluczowe SEO i GEO dla [marka/URL]" "Przeprowadź badanie słów kluczowych dla mojej [kategoria produktu]"
Umiejętność jest interaktywna — zadaje pytania, bada i dostarcza ustrukturyzowany plik ze słowami kluczowymi.
Proces 4-fazowy
Faza 1: Analiza marki
Umiejętność pyta o Twój produkt, grupę docelową i konkurentów. Odwiedza Twoją stronę i strony konkurencji, aby wyodrębnić język, pozycjonowanie i luki w treści.
Faza 2: Odkrywanie słów kluczowych
Bada słowa kluczowe za pomocą 6 metod — bez płatnych narzędzi:
| Metoda | Co znajduje |
|---|---|
| Wydobywanie z autouzupełniania Google | Prawdziwe sugestie wyszukiwania i warianty długiego ogona |
| Ludzie też pytają (PAA) | Słowa kluczowe w formie pytań, na które silniki AI chętnie odpowiadają |
| Wydobywanie z Reddita i społeczności | Prawdziwy język użytkowników, bolączki i slang |
| Analiza treści konkurencji | Tematy, które poruszają konkurenci, a Ty nie |
| Słowa kluczowe pytań i problemów | Wyszukiwania świadome problemów, które prowadzą do Twojego produktu |
| Słowa kluczowe cytowań AI (GEO) | Zapytania, w których AI generuje odpowiedzi i cytuje źródła |
Faza 3: Analiza i grupowanie słów kluczowych
Grupuje słowa kluczowe w klastry tematyczne, ocenia każde w 3 wymiarach:
- Trafność dla Twojego produktu (1-5)
- Szansa GEO — czy AI odpowie na to i zacytuje źródła? (1-5)
- Wartość biznesowa — jak blisko konwersji? (1-5)
Oznacza szybkie wygrane: istniejące strony do optymalizacji, słabe treści konkurencji, luki w cytowaniach AI.
Faza 4: Rezultat
Tworzy ustrukturyzowany plik Markdown zawierający:
- Priorytetowe klastry tematyczne ze słowami kluczowymi głównymi i wspierającymi
- Tabelę słów kluczowych specyficznych dla GEO (największy potencjał cytowań AI)
- Szybkie wygrane i luki konkurencji
- Pełną surową listę słów kluczowych do referencji
- Rekomendacje treści dla każdego klastra
Co wyróżnia tę umiejętność
| Tradycyjne badanie słów kluczowych | Ta umiejętność |
|---|---|
| Wymaga Ahrefs/Semrush (99-449 USD/mies.) | Darmowa — wykorzystuje wyszukiwanie internetowe |
| Skupia się na wolumenie wyszukiwania + trudności | Dodaje ocenę szansy GEO |
| Zwraca arkusz kalkulacyjny słów kluczowych | Zwraca pogrupowany, gotowy do działania plan treści |
| Ignoruje potencjał cytowań AI | GEO jest wymiarem pierwszorzędnym |
| Język marketerów | Prawdziwy język użytkowników z Reddita/społeczności |
Współpraca z innymi umiejętnościami
Rezultat badania słów kluczowych bezpośrednio zasila:
- write-seo-geo-content — pisanie stron dla najlepszych słów kluczowych i klastrów promptów
- geo-content-research — tworzenie pełnych treści gotowych dla AI dla słów kluczowych o wysokim GEO
- create-geo-charts — tworzenie wizualizacji danych dla słów kluczowych opartych na danych
Skrypty SERP (Opcjonalne potężne narzędzia)
Katalog scripts/ zawiera narzędzia Node.js, które pobierają rzeczywiste dane Google, aby wzmocnić badanie słów kluczowych. Są one opcjonalne — umiejętność działa bez nich, korzystając z wyszukiwania internetowego Claude, ale dostarczają one większą ilość, bardziej precyzyjnych danych.
keyword-explorer.mjs — Odkrywanie słów kluczowych
Pobiera rzeczywiste sugestie autouzupełniania Google, pytania People Also Ask, powiązane wyszukiwania i wykrywa funkcje SERP (AI Overviews, Featured Snippets).
# Free mode — no API key, autocomplete only
node scripts/keyword-explorer.mjs --seeds "physical AI, DePAI" --free
# Full mode with SerpAPI (free tier: 100 searches/month at serpapi.com)
SERPAPI_KEY=xxx node scripts/keyword-explorer.mjs \
--seeds "physical AI, DePAI, decentralized robotics" \
--depth deep \
--out keywords.json
# Quick scan for a single seed
node scripts/keyword-explorer.mjs -s "machine economy" --free -d quick
Opcje:
| Flaga | Opis | Domyślnie |
|---|---|---|
--seeds, -s | Słowa kluczowe rozdzielone przecinkami (wymagane) | — |
--free | Tryb darmowy: sugestie Google, bez klucza API | automatycznie, jeśli brak klucza |
--depth, -d | quick / normal / deep | normal |
--out, -o | Ścieżka wyjściowego pliku JSON | automatycznie generowana |
--gl | Kod kraju | us |
--hl | Kod języka | en |
Co zwraca:
- Wszystkie odkryte słowa kluczowe z tagami źródła (autocomplete, PAA, related_search)
- Pytania People Also Ask z fragmentami i źródłami
- Wykrywanie funkcji SERP dla każdego zapytania (AI Overview, Featured Snippet itp.)
- Zapytania, w których pojawiają się AI Overviews (= wysoka szansa GEO)
serp-analyzer.mjs — Analiza konkurencji w SERP
Pobiera listę słów kluczowych i sprawdza, kto obecnie zajmuje pozycje, jakie funkcje SERP się pojawiają i gdzie istnieją luki w treści.
# Analyze keywords from explorer output
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--input keywords.json \
--top 20 \
--track "axisrobotics.ai,bittensor.com"
# Analyze specific keywords
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--keywords "what is DePAI, physical AI companies, best AI robotics crypto" \
--track "axisrobotics.ai"
Opcje:
| Flaga | Opis | Domyślnie |
|---|---|---|
--input, -i | Ścieżka do wyjściowego JSON z keyword-explorer | — |
--keywords, -k | Słowa kluczowe do analizy rozdzielone przecinkami | — |
--top, -t | Ile słów kluczowych z pliku wejściowego | 10 |
--track | Domeny do śledzenia rozdzielone przecinkami | — |
--out, -o | Ścieżka wyjściowego pliku JSON | automatycznie generowana |
Co zwraca:
- Szacunkową trudność dla każdego słowa kluczowego (łatwy / średni / trudny)
- Obecne funkcje SERP (AI Overview, Featured Snippet, PAA, Knowledge Graph itp.)
- Które źródła są obecnie cytowane przez AI Overviews
- Obecność/brak śledzonych domen (znajdź luki w treści)
- Najczęściej pozycjonujące się domeny (zidentyfikuj prawdziwych konkurentów)
- Wszystkie pytania PAA (pomysły na treści)
Zalecany przepływ pracy
1. Uruchom keyword-explorer z wybranymi słowami kluczowymi
→ Uzyskaj surową listę słów kluczowych + pytania PAA
2. Przekaż wyniki do serp-analyzer dla najważniejszych słów kluczowych
→ Uzyskaj dane o konkurencji + możliwości funkcji SERP
3. Uruchom umiejętność /research-keywords z obydwoma wynikami
→ Uzyskaj pogrupowany, oceniony, gotowy do działania plan słów kluczowych
Konfiguracja
# No dependencies needed — pure Node.js (v18+), zero npm install
# Just need a SerpAPI key for full features (free at serpapi.com)
export SERPAPI_KEY=your_key_here
Przykładowy wynik
## Priority Keyword Clusters
### Cluster 1: Best AI Writing Tools — Priority: 14/15
Pillar Keyword: best AI writing tools 2026
Intent: Commercial Investigation
GEO Opportunity: 5/5 — AI Overviews appear, comparison format
Business Value: 5/5 — direct purchase intent
Relevance: 4/5
| Keyword | Intent | GEO Opp | Notes |
|---|---|---|---|
| best AI writing tools 2026 | Commercial | High | Pillar |
| AI writing tool comparison | Commercial | High | Comparison table content |
| is jasper AI worth it | Trust | High | PAA — address in FAQ |
| AI content writer for blogs | Commercial | Medium | Use-case variant |