Back to Skills

keyword-research

Discover keyword opportunities, evaluate metrics and SERPs, and save/tag promising terms.

10,250stars1,181forksUpdated 8/4/2026

Security Assessment

Safe(95/100)
Security Score95/100

About keyword-research

This skill turns seed topics into a prioritized keyword opportunity set using OpenSEO MCP data, helping the user decide what to target, what to save, and what to research next. It addresses the common SEO problem of chasing high-volume terms without regard to intent, difficulty, or a site's real ability to rank, by grounding recommendations in first-party demand and objective metrics.

The workflow normalizes seeds into distinct research angles and, when Search Console is connected, starts from real first-party demand, pulling performance data, filtering to striking-distance positions (roughly 5-20) client-side, and hydrating those queries with metrics. It orchestrates a set of read-oriented OpenSEO MCP tools: research_keywords for discovery, get_keyword_metrics to attach volume, keyword difficulty, intent, CPC, and trends, get_ranked_keywords for a target domain or page, get_serp_results to inspect intent, and local-SEO tools for location-based topics. It prioritizes by product fit, clear intent, reasonable difficulty, useful volume/CPC signal, and competitive plausibility, then presents a shortlist plus an opportunity table and next actions. Guardrails require it to not invent metrics (writing 'unknown' when data is absent) and to save keywords only after explicit user confirmation.

It is aimed at SEO practitioners, content strategists, and marketers using the OpenSEO platform. It requires a projectId and one or more seeds, and is a read-and-recommend workflow whose only write action, save_keywords, is gated behind explicit confirmation.

FAQ

What inputs does it require?

A projectId (it will call list_projects if missing) and one or more seed topics, products, pages, competitors, or audience problems; market/location/language are optional.

Which data source does it use?

OpenSEO MCP tools such as research_keywords, get_keyword_metrics, get_ranked_keywords, get_serp_results, and local-SEO tools, plus Search Console performance when connected.

How does it prioritize keywords?

By practical opportunity: strong product/page fit, clear intent, reasonable difficulty, useful volume/CPC signal, and a SERP where the user can plausibly compete, rather than volume alone.

Does it save keywords automatically?

No. save_keywords is only called after explicit user confirmation, and it suggests concise tags like topic:, intent:, or page:.

What if a metric is unavailable?

It never invents metrics; it writes 'unknown' when OpenSEO does not return a value.

Install keyword-research

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill