# Keyword Research

Keyword research from a seed topic, ideas, real Google volume/CPC, intent, difficulty...

- Repository: https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills (8540 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -g -a claude-code -y`
Codex: `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -g -a codex -y`
Cursor: `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -g -a cursor -y`
Gemini CLI: `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Ryze-AI-Adgent/open-seo-mcp-skills`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills/blob/HEAD/skills/keyword-research/SKILL.md