Agent skill

Keyword Research

by Ryze-AI-Adgent in Ryze-AI-Adgent/open-seo-mcp-skills

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

MITAuto-check passedMarketing & SEO

Install Keyword Research

skills CLI
$ npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Ryze-AI-Adgent/open-seo-mcp-skills keyword-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/keyword-research .claude/skills/keyword-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
keyword-research
GitHub stars
4.7k
Token cost
~581 tokens
SKILL.md length
262 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Expand the seed.… → Metrics.… → Intent + difficulty (optional enrich).… → …
  • Asked to find keywords
  • SKILL.md covers Requires, Workflow, Output and Rules
  • Calls claude; reaches connector.get-ryze.ai

What it does

Keyword Research is an agent skill from Ryze-AI-Adgent/open-seo-mcp-skills. 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".

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Keyword research and AI search optimization. It works with Model Context Protocol and Google Ads. The repository describes itself as: Free SEO MCP server + open-source SEO and GEO skills for Claude: keyword research, rank tracking, audits, backlinks, AI visibility on your real GSC/GA4/ads data. claude mcp add…. The licence is MIT.

When your agent uses it

  • Asked to find keywords
  • Keyword research for X
  • What should I rank for
  • Build a keyword plan

Example prompts

  • “find keywords”
  • “keyword research for X”
  • “what should I rank for”
  • “/keyword-research”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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…
  4. What they already rank for. google_search_console__runRawSearchAnalytics (dimension query, filtered to the topic) — mark keywords the site…
  5. Cluster. Group by intent and topic into content clusters: pillar + supporting pages. For each cluster: target keyword, supporting…

What it can do on your machine

Read from SKILL.md and the folder at commit 81ac50e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • connector.get-ryze.ai

    Also links to:

    • get-ryze.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Keyword Research loads about 581 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~581

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Ryze-AI-Adgent/open-seo-mcp-skills at commit 81ac50e, republished under its MIT licence (© Ryze-AI-Adgent). 262 words, ~581 tokens.

Download SKILL.mdSave it as .claude/skills/keyword-research/SKILL.md (or your agent's skills folder).
name
keyword-research
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".

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

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.

© Ryze-AI-Adgent, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/keyword-research of Ryze-AI-Adgent/open-seo-mcp-skills.

Open the folder on GitHubat commit 81ac50e

Compare with similar skills

Keyword Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Keyword Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Keyword Research this skillRyze-AI-Adgent/open-seo-mcp-skills4.7k—~581Automated safety check: PassMIT
SEO DataforseoAgriciDaniel/codex-seo7992 repos~4.6kAutomated safety check: PassMIT
DataForSEO Live SEO DataAgriciDaniel/claude-seo19k—~4.4kAutomated safety check: PassMIT
SEONexus-JPF/note-companion870—~2.2kAutomated safety check: PassMIT
Localseodata Toolgarrettjsmith/localseoskills121—~4.1kAutomated safety check: PassMIT
SEO Dataforseohashgraph-online/awesome-codex-plugins1.3k—~4.5kAutomated safety check: NotesMIT

Similar skills

  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Marketing & SEOAuto-check passed
  • DataForSEO Live SEO Data

    AgriciDaniel/claude-seo

    Pulls live SERP results, keyword metrics, backlink profiles and AI visibility data through the DataForSEO MCP server, with a cost check before each call.

    19k GitHub stars~4.4k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • SEO

    Nexus-JPF/note-companion

    Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.

    870 GitHub stars~2.2k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Localseodata Tool

    garrettjsmith/localseoskills

    When the user wants to pull local SEO data — SERP results, local pack rankings, business profile data, reviews, citations, audits, geogrid scans, keyword research, AI visibility, competitor…

    121 GitHub stars~4.1k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • SEO Dataforseo

    hashgraph-online/awesome-codex-plugins

    Live SEO data via DataForSEO API credentials. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~4.5k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Evaluate Skill

    every-app/open-seo

    Test a candidate OpenSEO skill end to end by running fresh, isolated Codex sessions against the local backend and scoring the reports they save.

    23k GitHub stars~1.8k tokensUpdated 2 days ago
    Marketing & SEOAuto-check: notes

More from Ryze-AI-Adgent/open-seo-mcp-skills

All 8 skills in this repo
  • AI Visibility

    Ryze-AI-Adgent/open-seo-mcp-skills

    Measure real AI-engine visibility — traffic from ChatGPT, Perplexity, Claude, Gemini and which pages they cite — from actual GA4 referral data, not prompt sampling.

    4.7k GitHub stars~611 tokensUpdated 17 days ago
    Auto-check passed
  • Backlink Check

    Ryze-AI-Adgent/open-seo-mcp-skills

    Backlink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor.

    4.7k GitHub stars~515 tokensUpdated 17 days ago
    Auto-check passed
  • Competitor Gap

    Ryze-AI-Adgent/open-seo-mcp-skills

    Find keywords a competitor ranks for that the user's site doesn't — the content gap, prioritized by volume and winnability.

    4.7k GitHub stars~560 tokensUpdated 17 days ago
    Auto-check passed
  • Content Brief

    Ryze-AI-Adgent/open-seo-mcp-skills

    SERP-driven content brief for a target keyword — what ranks, what to cover, headings, questions, internal links from your own data.

    4.7k GitHub stars~610 tokensUpdated 17 days ago
    Auto-check passed
  • Rank Tracking

    Ryze-AI-Adgent/open-seo-mcp-skills

    Rank tracking without a tracker subscription — position movers between any two periods from real Search Console data.

    4.7k GitHub stars~573 tokensUpdated 17 days ago
    Auto-check passed
  • SEO Audit

    Ryze-AI-Adgent/open-seo-mcp-skills

    Full SEO audit of a site from its real Search Console + GA4 data — indexation health, CTR anomalies, decaying pages, striking-distance keywords, quick wins.

    4.7k GitHub stars~663 tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Keyword Research

What does Keyword Research do?

Keyword research from a seed topic — ideas, real Google volume/CPC, intent, difficulty, clustered into a plan. Keyword Research is an agent skill from Ryze-AI-Adgent/open-seo-mcp-skills. Keyword research from a seed topic — ideas, real Google volume/CPC, intent, difficulty, clustered into a plan.

When should I use Keyword Research?

Keyword Research fits situations like: asked to find keywords; keyword research for X; what should I rank for; build a keyword plan.

How do I install Keyword Research in Claude Code?

Run `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -a claude-code`. Or copy the skill folder (skills/keyword-research in Ryze-AI-Adgent/open-seo-mcp-skills) into .claude/skills/keyword-research in your project. Claude Code loads it when a task matches its description.

How do I install Keyword Research in Codex?

Run `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -a codex`. Or copy the skill folder (skills/keyword-research in Ryze-AI-Adgent/open-seo-mcp-skills) into .agents/skills/keyword-research in your project. Codex loads it when a task matches its description.

Can I use Keyword Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Ryze-AI-Adgent/open-seo-mcp-skills --skill keyword-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/keyword-research, .gemini/skills/keyword-research, .github/skills/keyword-research and .opencode/skills/keyword-research in your project.

What does Keyword Research need to run?

Going by SKILL.md and its folder, Keyword Research needs the command-line tools its instructions call (claude).

Does Keyword Research access the network?

SKILL.md names 2 domains. In commands or code: connector.get-ryze.ai; the agent is likely to contact it when it follows the instructions. As links in the text: get-ryze.ai. This is read from the text; nothing was executed.

Is Keyword Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Keyword Research use?

Keyword Research is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Keyword Research use?

About 581 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Keyword Research?

Skills that share tags, products or a category with Keyword Research: SEO Dataforseo (AgriciDaniel/codex-seo, 799 stars), DataForSEO Live SEO Data (AgriciDaniel/claude-seo, 19k stars), SEO (Nexus-JPF/note-companion, 870 stars) and Localseodata Tool (garrettjsmith/localseoskills, 121 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Keyword Research?

Ryze-AI-Adgent (a GitHub organization) maintains it in Ryze-AI-Adgent/open-seo-mcp-skills, which has 4,672 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 24, 2026.

Source: Ryze-AI-Adgent/open-seo-mcp-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.