keyword-research

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.