| name | keyword-research |
| description | Use when the user asks to "find keywords", "挖词", or "搜什么词"; prioritizes search volume, keyword difficulty, intent, and topic clusters from provided or connected data. Not for competitor-relative coverage gaps — use content-gap-analysis. 关键词研究/内容选题 |
| version | 9.9.10 |
| license | Apache-2.0 |
| compatibility | Claude Code and compatible agent-skill hosts |
| homepage | https://github.com/dotusmanali/antigravity-seo |
| 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, what to write about, 关键词研究, 挖词, 内容选题, or 搜什么词. |
| argument-hint | <topic or seed keyword> [market/language] |
| metadata | {"author":"dotusmanali","version":"9.9.10","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","search volume analysis","what should I write about","give me keyword ideas","how competitive is this keyword","Ahrefs keyword explorer alternative","Google Keyword Planner alternative","关键词分析","长尾关键词","帮我挖词"]} |
| id | keyword-research |
| domain | research |
| invoked_by | ["seo-supervisor"] |
| depends_on | [] |
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: topic or seed keyword, target market/language, business goal, site DR, and any user-provided or tool metrics.
- Writes: a user-facing research deliverable and reusable summary.
- Promotes: durable keyword priorities, competitor facts, and pending strategy decisions to
memory/hot-cache.md, memory/open-loops.md, and memory/research/.
- Done when: every shortlisted keyword carries volume + difficulty + intent (or a labeled N/A); keywords are grouped into pillar + cluster hubs; and the deliverable names at least 3 prioritized Quick Win / Growth / GEO opportunities.
- 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
Enriched by the following MCP servers:
google-ads: High-volume keyword suggestions and trending terms from Google Suggest.google-keyword-planner: Professional-grade search volume, competition, and CPC data.google-trends: Market interest analysis and seasonal forecasting (see seo-trends).dataforseo: Live SERP and keyword metric overrides.
Zero-dependency local helper (no tool needed): python3 scripts/connectors/suggest.py "<seed>" --expand harvests free keyword ideas from Google Autocomplete (⚠️ unofficial endpoint). Search volume / difficulty still needs ~~SEO tool or own Search Console data. See scripts/connectors/README.md.
