keyword-research
Skill0 starsChanged 32 days agoMITView on GitHub
Turns a handful of seed topics into a clustered keyword map - expanded terms, a demand tier, search intent, one target page per cluster, and where the gaps are - on a free stack with no paid SEO tool required. Uses Google Search Console, Keyword Planner, Google Trends and live search results when available, and any connected SEO tool if there is one. Use when someone asks "what should we write about", "keyword research", "build a keyword map", "what keywords should we target", "find content gaps", "which topics have demand", "two of our pages compete for the same keyword", "should we write another post for this term", or wants to plan a blog or landing pages around search or fix keyword cannibalisation.
59 other projects use a version of this.
Adopted by
Most recently taken up by
- gaznil/seo-skills-by-gazniltheir own version, first seen Nov 16, 2026
- gaznilmuzammil12-prog/seo-skills-by-gazniltheir own version, first seen Nov 16, 2026
- teemukarjaluoto/seo-sauna-mcptheir own version, first seen Nov 16, 2026
- harborrank/harborrank-skillstheir own version, first seen Nov 16, 2026
- winsley-jeune/harborrank-skillstheir own version, first seen Nov 15, 2026
- asospy/asospy-agent-skillstheir own version, first seen Nov 15, 2026
Used with
Projects with it also use link-prospecting, seo-project-setup and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
JwuthriSkilllink-prospecting
Find link prospects, discover contact paths, and draft outreach from SERPs and backlink signals.
Also in 13 projects that use this
JwuthriSkillseo-project-setup
Set up a durable local SEO workspace with project context, notes, goals, positioning, preferences, MCP checks, and Search Console data intake.
Also in 13 projects that use this
Ethan-paseyaSkillreview-analysis
Amazon review and VOC analysis using SellerSprite MCP. Use when the user runs `/review-analysis {ASIN} {SITE}` to analyze positive and negative reviews, identify product pain points, listing mismatch, service risks, and product improvement actions.
Also in 6 projects that use this
akii-technologies-ltdSkillkeyword-clustering
Cluster and organize keywords into topical groups for SEO. Use when the user asks to "cluster keywords", "group keywords", "organize keywords", "keyword mapping", "topic clusters", "keyword grouping", "build a content plan", "pillar pages", "topical authority", "semantic clustering", or pastes a list of keywords.
Also in 14 projects that use this
Kungfookenny123Skillapp-marketing-context
When the user wants to create or update their app marketing context document. Also use when the user mentions "app context", "marketing brief", "app positioning", or when starting any ASO or app marketing project. This is the foundation skill — all other skills check for this context first.
Also in 4 projects that use this
Kungfookenny123Skillmetadata-optimization
When the user wants to optimize App Store metadata — title, subtitle, keyword field, or description. Also use when the user mentions "optimize my title", "ASO metadata", "keyword field", "character limits", "app description", or "write my subtitle". For keyword discovery, see keyword-research. For full ASO audits, see aso-audit.
Also in 4 projects that use this
- +4 more from Jwuthri
Other versions59 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 59
- every-app/open-seo★ 28ksame name
- Ryze-AI-Adgent/open-seo-mcp-skills★ 8.4ksame name
- nowork-studio/toprank★ 4.2ksame name
- nowork-studio/notfair-plugin★ 4.2ksame name
- Jwuthri/Tracely-ai★ 1.3ksame name
- liangdabiao/amazon-sorftime-research-MCP-skill★ 1.1ksame name
- VladSez/easy-invoice-pdf★ 1.1ksame name
- kostja94/marketing-skills★ 1.1ksame name
- jwuthri-cloud/Tracely-ai★ 979same name
- indranilbanerjee/digital-marketing-pro★ 934same name
49 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- ai-search-visibilitySkill
- content-atomisationSkill
- linkedin-postSkill
- seo-schema-gateSkill
The file
We split this skill into the rules it gives an agent
10 rules. 0 are common, 8 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 54 edited versions we read keep these.
8
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
Ask in one message, then start:
- Very specific: line 31
Before any research, list the sources and mark each available or not.
- Distinctive: line 45
Report every gap at the top of the output: No Search Console means you cannot tell what the site already ranks for.
- Distinctive: line 86
Search Console beats estimates for terms it covers.
- Distinctive: line 100
Run the bundled classifier for a first pass:
- Distinctive: line 121
If you have the top results per term (from a search tool, a connected SEO tool, or pasted), the bundled script does the second pass:
- Very specific: line 177
No invented numbers: If no source gave a figure, the tier is unknown.
- Distinctive: line 178
Market matters: Do not apply US volumes to a UK business.
- Distinctive: line 179
One cluster, one page: If a new page would overlap an existing one, recommend improving the existing page instead.
- Distinctive: line 206
Which data sources they have: Search Console access, a Google Ads account for Keyword Planner, and any connected SEO tool.
“Common” is measured: kept by at least 6 in 10 of the 54 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Keyword research
The output is a keyword map: every candidate term with its cluster, intent, a demand tier, where that number came from, and whether the site already covers it. One cluster maps to one page. That map is what content planning runs on.
The free stack gets you a reliable high / medium / low read on demand and the direction it is heading. It does not get you exact monthly volumes. Say so in the output rather than dressing ranges up as precision.
Step 0: what you need from the person
Ask in one message, then start:
- Seeds. Three to ten topics or phrases. "What do you sell and who buys it?" is enough to draft seeds yourself; confirm them.
- Site URL, so you can check what already exists.
- Market. Country and language. Demand and results differ by market.
- Brand terms. Their own brand and product names, so branded searches are separated.
Optional: a Search Console export (Performance report, last 3 to 12 months, by query and by page). It is the best free data there is.
Step 1: check what data you can actually get
Before any research, list the sources and mark each available or not. Read
references/data-sources.md for what each gives and its limits.
| Source | Gives | How you get it |
| Google Search Console | Real impressions, clicks, position for terms the site already shows for | A connected Search Console tool, or an export the person pastes |
| Google Keyword Planner | Volume ranges and related terms | The person runs it in a free Google Ads account and pastes the export |
| Google Trends | Relative interest over time, rising related queries | trends.google.com by hand, or a connected tool |
| Live search results | Autocomplete, "People also ask", related searches, the top-ranking pages | A web search or scraping tool, or the person pastes what they see |
| A connected SEO tool (optional) | Exact volumes, difficulty, competitor keywords | Any MCP server or API the person has connected, for example Ahrefs, Semrush or similar |
Rules:
- A missing source is not an error. Continue with what you have.
- Report every gap at the top of the output. No Search Console means you cannot tell what the site already ranks for; say that plainly.
- Zero sources is the only stop. Even then, offer to work from the person's own knowledge of customer questions and mark everything as unverified.
- A paid tool improves confidence, it does not change the method. If one is connected, use it to fill the same fields.
Step 2: expand the seeds
For each seed, collect candidate terms from:
- Autocomplete suggestions (try the seed plus a to z, and with "how", "best", "vs", "for").
- "People also ask" questions and the related searches at the bottom of the results.
- Keyword Planner related terms, if available.
- Rising related queries in Google Trends.
- The connected SEO tool's related and matching terms, if available.
- Questions customers actually ask: sales calls, support tickets, reviews, forums.
Deduplicate and normalise (lower case, trimmed). Drop terms that are clearly off-market. Aim for 50 to 300 candidates. More is rarely useful at this stage.
Step 3: attach a demand tier
For each term give a tier and say how confident you are. Read
references/data-sources.md for how to triangulate.
| Tier | Default threshold (monthly searches) |
| high | 10,000 or more |
| medium | 1,000 to 9,999 |
| low | under 1,000 |
| unknown | no source covered it |
Recalibrate for a niche. In a narrow B2B market, 500 a month may be "high". Say which scale you used.
Confidence: exact (paid tool), range (Keyword Planner bracket), observed (Search
Console impressions), relative (Trends index only), inferred (appears in autocomplete
or "People also ask", no number).
Search Console beats estimates for terms it covers. Never present the midpoint of a Keyword Planner range as a fact.
Step 4: classify intent
Intent decides the page type. Getting it wrong wastes the work even if the page ranks.
| Intent | Signal | Build |
| informational | how, what, why, guide, examples | Article, guide, glossary entry |
| commercial | best, vs, alternatives, review | Comparison page, "best X for Y", alternatives page |
| transactional | price, buy, book, demo, free trial, near me | Product, pricing, booking or landing page |
| navigational | a brand name, login | Usually nothing. Competitor brand plus "alternative" is the exception: that is commercial. |
Run the bundled classifier for a first pass:
python3 scripts/classify_intent.py keywords.txt --brand "yourbrand,yourproduct" --headerIt is deterministic and token-based, standard library only. Then check the clusters that
matter against the live results page: if the top ten are all product pages, the intent is
transactional whatever the words say. Read references/search-intent.md for the token
lists and edge cases.
Step 5: cluster
One cluster is one page. Two pages aimed at the same cluster compete with each other.
- First pass, shared head term. Group terms that share the core noun phrase ("crm for charities", "charity crm software"). Split a group if its terms have different intent.
- Second pass, results overlap. For the boundaries that matter, compare the top ten results. If two terms share a lot of the same ranking pages, the search engine treats them as one need.
If you have the top results per term (from a search tool, a connected SEO tool, or pasted), the bundled script does the second pass:
python3 scripts/serp_cluster.py serps.tsv --threshold 0.4Input is keyword<TAB>url, one row per result. Read references/clustering-and-gaps.md
for the method and how to tune the threshold.
Step 6: find the gaps
For each cluster, compare demand with what the site already has:
covered: the site ranks in the top 5 for the cluster's main terms.under-ranked: the site ranks 6 to 20. Often the best return: improve or merge the existing page.gap: nothing ranks. A new page is needed.unknown: no Search Console data and no obvious matching page.
Without Search Console, check the sitemap and a site: search for an existing page on the
cluster topic, and mark the result as lower confidence.
Then prioritise: demand tier, then intent that converts for this business, then how beatable the current top results look (forums and thin pages are beatable; big reference sites usually are not), then effort.
Step 7: write the keyword map
# Keyword map: <site or topic>, <date>
## Sources
- Used: <list>
- Missing: <list, and what that means for confidence>
- Demand scale: <default or recalibrated, and why>
## Top 5 opportunities
| Cluster | Intent | Demand | Status | Recommended page | Why now |
## Clusters
| Cluster | Main term | Terms | Intent | Demand | Status | Target page |
## Full keyword list
| Term | Cluster | Intent | Demand | Confidence | Source | Status |
## Cannibalisation warnings
<Clusters where two existing pages compete, and which one should own it.>Lead with the top five and a recommendation. The full list is for reference.
Offer a CSV of the full list if the person wants it in a spreadsheet.
Rules
- No invented numbers. If no source gave a figure, the tier is
unknown. - Market matters. Do not apply US volumes to a UK business.
- One cluster, one page. If a new page would overlap an existing one, recommend improving the existing page instead.
- AI answers change the value of informational terms. Simple definitional questions
are increasingly answered on the results page or in an assistant. Weight them for
citation potential, not only clicks; the
ai-search-visibilityskill covers that side. - Tool limits drift. Check
references/changes-ledger.mdbefore relying on one.
Example
User: Keyword research for my bookkeeping practice in Bristol. Seeds: bookkeeping, VAT returns, Xero setup. No paid tools.
Claude: No Search Console connected, so I cannot see what you already rank for; I will check your sitemap instead and mark coverage as lower confidence. Using autocomplete, "People also ask" and Trends. (...) Top opportunity: "bookkeeper Bristol" and five close variants form one transactional cluster with medium local demand, and your services page does not mention Bristol in the title or headings. That is a fix to an existing page, not a new one. Second: a "how to do a VAT return in Xero" cluster, informational, medium demand, where the top results are forum threads. A clear step-by-step guide can beat those.
Configuration
Two things vary per person:
- Market and demand scale. Country, language, and whether the default tiers suit their niche.
- Which data sources they have. Search Console access, a Google Ads account for Keyword Planner, and any connected SEO tool. The skill works with none of them, but says how much less it can see.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

