Install Keyword Research
Pick your agent. Every command is ready to paste.
npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-researchThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads keyword-research when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the keyword-research skill”. In Codex, type $keyword-research.
The skill itself
SKILL.md
Keyword Research
Requires
The free Ryze MCP connector (https://connector.get-ryze.ai/mcp). Claude Code: claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp. claude.ai / Desktop / Cursor: add it as a custom connector with the same URL. Setup: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp?utm_source=github&utm_content=open-seo-mcp-skills
Seed → ideas → metrics → clusters. Volumes come from Google Ads planner data (the source everyone else resells), enriched with DataForSEO intent/difficulty.
Workflow
- Expand the seed.
google_ads__generateKeywordIdeaswith the seed keyword(s) and/or the user's URL. Collect up to ~200 ideas. - Metrics.
google_ads__generateKeywordHistoricalMetricson the candidate list — monthly volume, competition, CPC range, 12-month trend. - Intent + difficulty (optional enrich). If the workspace exposes DataForSEO tools, call the Labs
keyword_overviewendpoint for the top ~50 (search intent, keyword difficulty, SERP features). Request shape:native__get_provider_docsproviderdataforseo. Skip silently if unavailable — Google metrics alone are enough for a v1 plan. - What they already rank for.
google_search_console__runRawSearchAnalytics(dimensionquery, filtered to the topic) — mark keywords the site already has positions for; those are optimize-not-create. - Cluster. Group by intent and topic into content clusters: pillar + supporting pages. For each cluster: target keyword, supporting keywords, total volume, intent, existing page (if any) or "new page".
Output
One table per cluster (keyword, volume, CPC, intent, current position if any), then a ranked plan: which clusters to attack first and why (volume × winnability — favor clusters where the site already has striking-distance positions). Plain language, no filler.
Rules
- Never invent volumes. If a metrics call fails, show the keyword without numbers and say why.
- CPC belongs in the output — it tells the user what the traffic is worth, and this doubles as an ads negative-keyword source.
Tips for Keyword Research
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 8 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Keyword Research
What does the Keyword Research skill do?
Keyword research from a seed topic — ideas, real Google volume/CPC, intent, difficulty, clustered into a plan. Use when asked to "find keywords", "keyword research for X", "what should I rank for", or "build a keyword plan".
How do I install Keyword Research?
Run "npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Keyword Research work in Cursor and Codex?
Yes. Keyword Research uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Keyword Research free?
Keyword Research is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Keyword Research?
Keyword Research is published by Ryze-AI-Adgent in the Ryze-AI-Adgent/open-seo-mcp-skills repository, together with 7 other skills.



