keyword-research
Skill4 starsChanged 13 days agoMITView on GitHub
Discover keyword opportunities, evaluate metrics and SERPs, and save/tag promising terms.
59 other projects use a version of this, 11 of them edited; 9 of 9 edited versions we compared changed its rules; 1 new project in the last 4 weeks, against 1 the 4 before.
How people change it
9 of 9 edited versions changed its rules, and some changes recur.
Of the 9 edited versions we compared: 9 made changes of their own.
Rules people drop
- If a report template applies (see
seo-report), its sections and tone replace this list.dropped by 9 of 9 - Call
get_project_contextfirst and ground the research in it — the business, the goal, the markets, and the competitors and key pages already saved.dropped by 8 of 9 - Before spending credits, check the research log. If the same research ran within the last 30 days, reuse that result and say so instead of re-buying it.dropped by 8 of 9
- If
projectIdis missing, uselist_projectsfirst. If the target market/location/language is unclear and would materially affect keyword metrics, ask the user; otherwise use the MCP tool defaults.dropped by 1 of 9 - Call
research_keywordsfor exploratory seeds. Use bulk calls when possible.dropped by 1 of 9 - Use
get_keyword_metricsto hydrate a fixed keyword list — or the striking-distance queries from step 1 — with volume, KD, and intent before prioritizing.dropped by 1 of 9 - Use
get_ranked_keywordswhen the user provides a domain/page and wants opportunities based on current rankings, near-misses, or competitor-owned terms.dropped by 1 of 9 - Use
get_serp_resultsfor high-potential or ambiguous keywords when SERP intent would change the recommendation; keep the default check small.dropped by 1 of 9
Rules people add
- If the request is local SEO, identify the business, location/coordinates or service area, and local categories. …added by 8 of 9
- Start with the highest-signal recommendation:added by 8 of 9
We split this file and each edited version into the rules they give an agent and match them by wording. A version that adds no rule of its own and has not changed since this file last did reads as an older text, so what it lacks is not counted as dropped. We keep no past texts of a file, so that is inferred, and an edited version that started from an older text still counts its gaps as drops.
Adopted by
Steady: 1 new project took it in the last 4 weeks, 1× the 4 weeks before.thin data
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-mcpedited, first seen Nov 16, 2026
- harborrank/harborrank-skillsedited, first seen Nov 16, 2026
- winsley-jeune/harborrank-skillsedited, first seen Nov 15, 2026
- asospy/asospy-agent-skillstheir own version, first seen Nov 15, 2026
Used with
Projects with it also use review-analysis and serp-analysis.
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.
liangdabiaoSkillreview-analysis
对亚马逊商品评论进行深度分析,自动识别产品痛点、分析退货原因,生成改进建议和客服回复模板。Invoke when user uses /review-analysis command with a product ASIN.
Also in 5 projects that use this
opencueSkillserp-analysis
Use when the user asks to "analyze SERPs"; reviews ranking factors, features, intent, AI Overviews, and snippets. SERP分析/搜索结果
Also in 6 projects that use this
Other versions59 projects use a version of this.
Word for word · 1
- every-app/open-seo★ 28k100% same
Edited · 11
- Jwuthri/Tracely-ai★ 1.3k84% same
- VladSez/easy-invoice-pdf★ 1.1k84% same
- jwuthri-cloud/Tracely-ai★ 97984% same
- petera2c/simple-table★ 23584% same
- harborrank/harborrank-skills★ 226% same
- kid7st/agenticseo★ 218% same
- ventra-rocket/EchoSEO★ 282% same
- winsley-jeune/harborrank-skills★ 226% same
- ictlondon/kraftskills★ 085% same
- IsaacBell/ai-marketing-toolkit★ 084% same
1 more not listed
Wrote their own version · 47
- Ryze-AI-Adgent/open-seo-mcp-skills★ 8.4ksame name
- nowork-studio/toprank★ 4.2ksame name
- nowork-studio/notfair-plugin★ 4.2ksame name
- liangdabiao/amazon-sorftime-research-MCP-skill★ 1.1ksame name
- kostja94/marketing-skills★ 1.1ksame name
- indranilbanerjee/digital-marketing-pro★ 934same name
- OpenClaudia/openclaudia-skills★ 731same name
- Karanjot786/TermUI★ 238same name
- fenjo26/OpenGSC★ 57same name
- agencia-conversion/agentic-seo-skills★ 51same name
37 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 repository29 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .claude/CLAUDE.mdCLAUDE.md
- ai-prompt-researchSkill
- ai-visibility-auditSkill
- competitive-landscapeSkill
- competitor-analysisSkill
- create-repo-skillSkill
- deslopSkill
- evaluate-skillSkill
- keyword-clusteringSkill
- link-prospectingSkill
- local-seoSkill
- merge-readySkill
- observability-triageSkill
- openseo-release-notesSkill
- openseo-review-web-contentSkill
- papercutsSkill
- review-briefSkill
- review-simplifySkill
- review-ui-statesSkill
- seo-auditSkill
- seo-coachSkill
- seo-project-setupSkill
- seo-reportSkill
- setup-openseoSkill
- simple-issue-descriptionSkill
- stageshowSkill
- test-auditSkill
- verify-local-mcpSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. 0 are common, 3 are distinctive, and 10 are very specific to this project.
0
Common
Most of the 53 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
10
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 18
If projectId is missing, use list_projects first.
- Very specific: line 24
Call get_project_context first and ground the research in it — the business, the goal, the markets, and the competitors and key pages …
- Distinctive: line 26
Before spending credits, check the research log.
- Very specific: line 48
Call research_keywords for exploratory seeds.
- Very specific: line 49
Use get_keyword_metrics to hydrate a fixed keyword list — or the striking-distance queries from step 1 — with volume, KD, and intent before …
- Very specific: line 50
Use get_ranked_keywords when the user provides a domain/page and wants opportunities based on current rankings, near-misses, or …
- Distinctive: line 51
Remove irrelevant, duplicate, branded-only, and off-intent terms.
- Very specific: line 59
Use get_serp_results for high-potential or ambiguous keywords when SERP intent would change the recommendation.
- Very specific: line 61
Ask before saving keywords.
- Very specific: line 67
If a report template applies (see seo-report), its sections and tone replace this list.
- Very specific: line 81
Do not invent metrics. If OpenSEO does not return a value, write unknown.
- Very specific: line 82
Do not call save_keywords without explicit confirmation.
- Distinctive: line 83
Prefer business-fit and intent-fit over chasing the largest volume term.
“Common” is measured: kept by at least 6 in 10 of the 53 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
OpenSEO Keyword Research
Goal
Turn seed topics into a prioritized keyword opportunity set using OpenSEO MCP data. The output should help the user decide what to target, what to save, and what to research next.
Required inputs
projectId- One or more seed topics, products, pages, competitors, or audience problems
- Optional market/location/language
If projectId is missing, use list_projects first. If the target market/location/language is unclear and would materially affect keyword metrics, ask the user; otherwise use the MCP tool defaults.
Project context
The project-context tools are free and shared with the app and other agents.
- Call
get_project_contextfirst and ground the research in it — the business, the goal, the markets, and the competitors and key pages already saved. - This skill needs
business_overviewandcurrent_goal. If either is empty, run a minimal inline setup: ask the user, or infer from the site and confirm, just enough to fill them, write them back withupdate_project_context, then continue the research. Never front-load the full interview; suggestseo-project-setupat the end for the rest. - Before spending credits, check the research log. If the same research ran within the last 30 days, reuse that result and say so instead of re-buying it.
- On finish, write back what is durable — a sharpened
business_overvieworcurrent_goal, competitors that kept appearing in the SERPs viaaddCompetitors, pages the keywords should land on viaaddKeyPages— and append a research log entry:{ appendResearchLog: { summary: "Keyword research: <seeds/market>. Verdict: <conclusion>" } }.
Deliver as a report
Deliver through the seo-report skill, saving with skill: "keyword-research". If that skill is not available, say so and stop before writing HTML.
OpenSEO MCP tools
research_keywords: primary discovery tool. Use 1-5 seeds per call and prefer 150 results unless the user asks for exhaustive research. For demand in one city, county, or region, callsearch_serp_locationsand pass the returnedlocationNameon the seed: volume, CPC, and competition become local; keyword ideas, KD, and intent stay national.get_keyword_metrics: hydrate up to 700 known keywords with volume, keyword difficulty (KD), search intent, CPC, and monthly trends in one call. Use it to score candidate or known terms — including the Search Console striking-distance queries from step 1.get_ranked_keywords: pull exact ranking keyword rows when a target domain or page is part of the research brief.get_search_console_performance: when Search Console is connected, start from the project's real first-party demand — queries already earning impressions and near-ranking ("striking distance") terms. PassminPosition: 5, maxPosition: 20, minImpressions: 50so the server filters the striking-distance rows for you (Google sorts by clicks and can't filter by position itself). Then hydrate those striking-distance queries withget_keyword_metricsto attach difficulty and intent.get_serp_results: inspect SERPs for the top candidate terms, especially when intent is ambiguous. Pass the samelocationNamefor the SERP in one city, county, or region.search_local_businesses,get_local_serp_results, andget_google_business_questions: use for local SEO topics when a business/location radius matters.list_saved_keywords: avoid duplicating already-saved work or use existing tags as context.save_keywords: save selected keywords only after explicit user confirmation.
Workflow
- Normalize seeds into a small set of distinct research angles. If Search Console is connected for the project, first pull
get_search_console_performancewithminPosition: 5, maxPosition: 20, minImpressions: 50(default lookback), and hydrate those queries withget_keyword_metricsto attach KD and intent. That ranked, hydrated list is your fastest opportunity set — work it before broad discovery. - If the request is local SEO, identify the business, location/coordinates or service area, and local categories. Research local volume for that city or county with
research_keywordsandlocationName. Usesearch_local_businessesandget_local_serp_resultsfor the most important location/keyword set instead of relying only on national keyword/SERP data. - Call
research_keywordsfor exploratory seeds. Use bulk calls when possible. - Use
get_keyword_metricsto hydrate a fixed keyword list — or the striking-distance queries from step 1 — with volume, KD, and intent before prioritizing. - Use
get_ranked_keywordswhen the user provides a domain/page and wants opportunities based on current rankings, near-misses, or competitor-owned terms. - Remove irrelevant, duplicate, branded-only, and off-intent terms.
- Prioritize by practical opportunity, not volume alone:
- Strong match to the user's product/page/topic
- Clear search intent
- Reasonable difficulty
- Useful volume/CPC signal
- SERP where the user can plausibly compete
- For local SEO, local-pack/Maps visibility and proximity fit
- Use
get_serp_resultsfor high-potential or ambiguous keywords when SERP intent would change the recommendation; keep the default check small. - Present a shortlist and a longer opportunity table.
- Ask before saving keywords. When saving, suggest concise tags such as
topic:<topic>,intent:<intent>, orpage:<slug>.
Output format
h1: the site or topic.
If a report template applies (see seo-report), its sections and tone replace this list.
Sections in this order:
- The opportunity — one or two opening sentences naming the best theme and why the site can win it now.
- Target these now — a table of keyword, intent, volume, KD, CPC, and the page to make. Add a bar chart comparing the volumes of the shortlist.
- Why these — one finding per keyword that needs justifying: the SERP or metric evidence, then the page to build.
- The longer opportunity list — a second table, same columns.
- Risks and caveats — notes: SERP intent that would change the recommendation, missing metrics written as
unknown, close-variant volumes that are one bucket rather than several. - What to do next — an ordered list, including whether to run keyword clustering, write a content brief, or save the chosen keywords.
- How this report was made — opens with the skill link line from
seo-report, pointing athttps://openseo.so/docs/skills/keyword-research("OpenSEO Keyword Research skill"), then which tools returned what.
Guardrails
- Do not invent metrics. If OpenSEO does not return a value, write
unknown. - Do not call
save_keywordswithout explicit confirmation. - Prefer business-fit and intent-fit over chasing the largest volume term.
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.

