| name | keyword-research |
| description | Find high-value SEO keywords: search volume, difficulty, intent classification, topic clusters. 关键词研究/内容选题 |
| version | 9.5.0 |
| license | Apache-2.0 |
| compatibility | Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy |
| homepage | https://github.com/aaron-he-zhu/seo-geo-claude-skills |
| when_to_use | Use when starting keyword research for a new page, topic, or campaign. Also when the user asks about search volume, keyword difficulty, topic clusters, long-tail keywords, or what to write about. |
| argument-hint | <topic or seed keyword> [market/language] |
| metadata | {"author":"aaron-he-zhu","version":"9.5.0","geo-relevance":"medium","tags":["seo","geo","keyword-research","search-volume","keyword-difficulty","topic-clusters","search-intent","long-tail-keywords","关键词研究","SEO关键词","キーワード調査","키워드분석","palabras-clave"],"triggers":["keyword research","find keywords","search volume analysis","keyword difficulty","what should I write about","give me keyword ideas","how do I find good keywords","how competitive is this keyword","Ahrefs alternative","Ahrefs keyword explorer alternative","Semrush keyword magic tool","Google Keyword Planner alternative","Ubersuggest alternative","关键词研究","关键词分析","长尾关键词","写什么内容好","帮我挖词","キーワード調査","検索ボリューム","키워드 리서치","검색량 분석","investigación de palabras clave","volumen de búsqueda","pesquisa de palavras-chave","volume de busca"]} |
Keyword Research
Discovers, scores, and clusters keywords for SEO and GEO planning.
Quick Start
Research keywords for [topic/product/service]
What keywords is [competitor URL] ranking for that I should target?
Skill Contract
Expected output: a prioritized keyword brief plus the standard handoff summary for memory/research/.
- Reads: goals, market inputs, tool data, and prior strategy from CLAUDE.md and the shared State Model when available.
- Writes: a user-facing research deliverable and reusable summary.
- Promotes: durable keyword priorities, competitor facts, and strategy decisions to
memory/hot-cache.md, memory/decisions.md, and memory/research/.
- Primary next skill: competitor-analysis when the keyword set is ready for market comparison.
Handoff Summary
Emit the standard shape from skill-contract.md §Handoff Summary Format.
Data Sources
Optional integrations: ~~SEO tool, ~~search console. Without tools, ask for seed keywords, audience, goals, and any known metrics. See CONNECTORS.md.
Instructions
When a user requests keyword research, run eight phases and announce each as [Phase X/8: Name]:
- Scope — clarify product, audience, business goal, DR, geography, and language.
- Discover — seed from core, problem, solution, audience, and industry terms.
- Variations — expand with modifiers and long-tail patterns.
- Classify — tag by intent (informational, navigational, commercial, transactional).
- Score — assign difficulty (1-100) and compute
Opportunity = (Volume × Intent Value) / Difficulty, with Intent Value 1 / 1 / 2 / 3.
- GEO-Check — flag AI-answer-friendly queries such as questions, definitions, comparisons, lists, and how-tos.
- Cluster — group keywords into pillar + cluster topic hubs.
- Deliver — output an Executive Summary, Quick Wins / Growth / GEO opportunities, Topic Clusters, Content Calendar, and Next Steps.
Quality bar: every recommendation includes at least one specific number. Rewrite generic advice into a concrete keyword + volume + difficulty + reason.
Reference: See references/instructions-detail.md for the full 8-phase templates, expansion patterns, intent table, difficulty tiers, opportunity matrix, GEO indicators, cluster template, actionable-vs-generic examples, and advanced usage.
Example
Example outcome: 150+ keywords analyzed, 23 high-priority opportunities, ~45K/month traffic potential across 3 focus areas. See the full sample in references/example-report.md.
Advanced Usage
Intent mapping, seasonal analysis, competitor gaps, and local keyword workflows live in references/instructions-detail.md.
Tips for Success
Start with seeds, respect intent, cluster tightly, prioritize quick wins, and review quarterly. Full notes live in references/instructions-detail.md.
Save Results
After delivering, offer to save memory/research/keyword-research/YYYY-MM-DD-<topic>.md and promote durable conclusions to memory/hot-cache.md.
Reference Materials
Next Best Skill
Primary: competitor-analysis. Also: content-gap-analysis and serp-analysis.
