Keyword Research Skill

Description

Activate this skill when the user wants to research, identify, or prioritise keywords for a topic, niche, or website. Trigger phrases include: "keyword research", "find keywords for", "what should I rank for", "keyword analysis", "best keywords for [topic]", "keyword strategy", "what are people searching for about [topic]", "SEO keywords for [niche]".

Input Format

{
  "topic": "string — the subject to research keywords for",
  "business_type": "string — what the business or site does",
  "target_audience": "string — who the content is for",
  "content_goal": "rank | convert | educate | all",
  "location": "string — optional, country or city for local SEO",
  "intent_focus": "informational | transactional |
                   commercial | navigational | all",
  "competitor_urls": ["string — optional, up to 3 competitor URLs
                       to inform keyword gaps"],
  "user_keywords": ["string — optional keywords the owner already cares about"],
  "site_context": "string — optional audit findings, page list, or product description",
  "research_mode": "browser | api | both | unavailable — default both"
}

Start by asking the owner which keywords, products, audiences, locations, and business outcomes matter. If they do not know, derive provisional candidates from the site, audit findings, competitor language, and observed search results. Do not silently replace owner-supplied priorities with guessed keywords.

Live search-intent research

Use both browser research and available search/keyword APIs when the environment supports them. Prefer APIs for repeatable data and browser inspection for actual result-page intent, related questions, snippets, and current wording. If only one is available, state which source was used. If neither is available, perform semantic research only and mark volume, difficulty, rankings, and SERP observations as unverified.

For each important query, record:

• the exact query and market/device when known;
• dominant result intent: learn, compare, evaluate, buy, navigate, or troubleshoot;
• the problems and questions visible in results, related searches, and snippets;
• the content formats ranking: landing page, guide, comparison, tool, forum, video, or documentation;
• the conversion opportunity and the page that should own the query;
• the date/source and confidence level.

Prioritize problem-related queries that the product can genuinely solve. Search intent outranks attractive but irrelevant volume.

Difficulty & Volume Rubric

Important: This skill estimates difficulty and volume based on semantic analysis and competitive signals. It does not connect to live data APIs. All figures are directional estimates, not verified data. Always validate with a live tool (Ahrefs, SEMrush, Google Keyword Planner) before committing to a full content strategy.

Difficulty Scale

Volume Scale (Estimated Monthly Searches)

CPC Context

CPC (Cost Per Click) signals commercial value even for organic content. Use it to prioritise keywords where advertisers are spending — this means the intent is likely transactional and conversions are valuable.

Output Structure

…