Skip to content
alyn
Ryze-AI-Adgent

Keyword Research skill

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".

$npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research
GitHub stars
9,108
Pack installs
211
Alyn Score
55/99
Updated
15 days ago
License
MIT

Install Keyword Research

Pick your agent. Every command is ready to paste.

$npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research

The 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

GitHub

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

  1. Expand the seed. google_ads__generateKeywordIdeas with the seed keyword(s) and/or the user's URL. Collect up to ~200 ideas.
  2. Metrics. google_ads__generateKeywordHistoricalMetrics on the candidate list — monthly volume, competition, CPC range, 12-month trend.
  3. Intent + difficulty (optional enrich). If the workspace exposes DataForSEO tools, call the Labs keyword_overview endpoint for the top ~50 (search intent, keyword difficulty, SERP features). Request shape: native__get_provider_docs provider dataforseo. Skip silently if unavailable — Google metrics alone are enough for a v1 plan.
  4. What they already rank for. google_search_console__runRawSearchAnalytics (dimension query, filtered to the topic) — mark keywords the site already has positions for; those are optimize-not-create.
  5. 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.

Similar skills. From other creators.