Index of every page on this site: llms.txt
All skills
ryze-ai-adgent avatar

/keyword-research

@f587b0a
Run it yourself

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

Use this Skill: https://skilld.dev/gh/ryze-ai-adgent/open-seo-mcp-skills/keyword-research

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈61 tokens for metadata: the name and description. ≈530 when used: this file.

Description uses 3.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈243 characters, or 3.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

2 warnings24d3 checks · Risk SAFE
  • Gen Agent Trust Hub24d

    This skill is a legitimate tool for keyword research. It integrates with Google Ads and Search Console via a vendor-provided MCP connector to retrieve keyword metrics and performance data. No malicious behavior or security risks were identified.

  • Socket24d

    1 alert: gptAnomaly

  • Snyk24d

    Risk: MEDIUM · 1 issue

Signed by skilld at f587b0a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 4 weeks ago

README badge

README badge for ryze-ai-adgent/open-seo-mcp-skills/keyword-research