MCPInstall

find-keywords

Build a prioritized keyword list for a website, topic, or campaign. Use when the user asks about keyword research, finding keywords to target, building a keyword list, search demand, keyword difficulty, intent mapping, or which keywords to prioritize. For writing content around keywords, see brief. For grouping keywords into clusters, see build-clusters.

Installs
7K
Last 24h
—
Trending rank
—
Security
Warn

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/calm-north/seojuice-skills --skill find-keywords
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads find-keywords automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The skill is a set of instructional guidelines for keyword research and search intent mapping. It contains no executable code, shell commands, or obfuscated content. External references are contextually appropriate for the stated purpose.
Socket PassNo alerts
Snyk WarnMEDIUM ·Risk: MEDIUM · 1 issue
Runlayer WarnMEDIUM ·1/1 file flagged
ZeroLeaks PassNONE ·Score: 93/100 · 2 sections analyzed

SKILL.md

The instructions your agent reads when the skill is triggered.

Find Keywords

Build a prioritized keyword universe from a seed topic using intent mapping, difficulty-adjusted opportunity scoring, and cluster seeding.

Before You Start

Gather this context (ask if not provided):

  1. Domain and goal. What site is this for? What is the primary conversion (leads, sign-ups, sales, traffic)?
  2. Seed topic. The core subject area — not a single keyword but the business category (e.g., "project management software", "personal injury law Chicago").
  3. Existing rankings. Does the site already rank for terms in this area? Existing rankings tell you where to defend vs. expand.
  4. Constraints. Budget, team size, content velocity — these determine whether to chase head terms or focus on long-tail.

Step 0: Cannibalization Screen

Before building a new keyword list, check what the site already targets. Creating a new page for a keyword you already rank for can split authority and hurt both pages.

For each keyword you're considering:

  1. Search site:yourdomain.com [keyword] — does an existing page already target this term?
  2. Check Google Search Console — is an existing page already getting impressions for this keyword?
  3. If yes: update the existing page instead of creating a new one.
  4. If multiple pages rank for the same keyword: you have a cannibalization problem. Consolidate before expanding.

Low-Hanging Fruit Check

Before chasing new keywords, look for existing wins:

  • Positions 11-20 — You're almost on page 1. These keywords need content improvements or better internal linking, not new pages.
  • High impressions, low clicks — Title/meta description optimization can unlock traffic without new content.
  • Declining positions — Keywords where you're losing ground may need content refreshes (see recover-content).

Address these before building net-new keyword lists.

Keyword Universe Construction

Build the universe in three tiers:

Tier 1 — Head Terms (high volume, high difficulty)

  • Typically 1-2 words
  • Define the category
  • Target with pillar pages or the homepage
  • Realistic timeline: 6-18 months for new sites

Tier 2 — Body Terms (medium volume, medium difficulty)

  • Typically 2-3 words, specific enough to indicate intent
  • Target with dedicated landing pages or cluster articles
  • 3-6 month window for established sites

Tier 3 — Long-tail Terms (lower volume, low difficulty)

  • 3+ words, specific intent
  • Fastest to rank, highest conversion rate
  • Target with blog posts, FAQ sections, supporting content
  • 4-12 week window for fresh content

For each tier, produce:

KeywordMonthly VolumeDifficulty (0-100)IntentTierPriority
.........informational / transactional / navigational / commercial1/2/3high / medium / low

Intent Classification

Classify every keyword by search intent and sub-category:

Informational (user wants to learn)

Sub-categorySignal WordsExampleContent Type
Educationalwhat, why, definition, explain"what is SEO"Guide, explainer
Instructionalhow to, steps, tutorial, guide"how to set up GA4"Step-by-step tutorial
Exploratorytypes of, techniques, strategies"link building techniques"Comprehensive roundup
Troubleshootingnot working, fix, error, why is"why is my site not ranking"Diagnostic guide

Commercial Investigation (user is evaluating)

Sub-categorySignal WordsExampleContent Type
Comparisonvs, compared to, or"Ahrefs vs SEMrush"Side-by-side comparison
Review-seekingreview, worth it, honest"Ahrefs review"In-depth review
Best-ofbest, top, tools for"best SEO tools"Curated list
Evaluationfor [audience], features, pricing"SEO tools for small business"Buyer's guide

Transactional (user is ready to act)

Sub-categorySignal WordsExampleContent Type
Purchasebuy, price, discount, deal"buy Ahrefs subscription"Product/pricing page
Signup/Trialfree trial, sign up, demo"Ahrefs free trial"Landing page
Downloaddownload, template, PDF, checklist"SEO checklist PDF"Gated resource
Hire/Engagehire, agency, near me, book"SEO agency near me"Service page

Navigational (looking for a specific brand)

Sub-categorySignal WordsExampleContent Type
Brand search[brand name]"HubSpot"Homepage/brand page
Feature search[brand] + [feature]"Ahrefs keyword explorer"Feature page
Support/docs[brand] + login, docs, help"Ahrefs API docs"Support content

SERP Feature Correlation by Intent

Use this to anticipate which SERP features you can target per keyword:

SERP FeatureInformationalCommercialTransactionalNavigational
Featured SnippetVery HighHighLowLow
People Also AskVery HighVery HighLowMedium
AI OverviewVery HighHighLow-MediumLow
Shopping ResultsVery LowMediumVery HighLow
Local PackLowLowHighLow
SitelinksLowLowMediumVery High

Conversion Potential by Intent

IntentAvg Conversion RateNurture Length
Informational0.5-2%Long (weeks to months)
Commercial Investigation2-5%Medium (days to weeks)
Transactional5-15%Short (immediate to days)
NavigationalN/A — brand-dependentN/A

Common Classification Mistakes

MistakeCorrect Classification
Treating "best CRM software" as informationalCommercial Investigation
Treating "how much does X cost" as informationalCommercial / Transactional
Ignoring local intent in "SEO services"Transactional (local)
Assuming single intent for "SEO tools"Mixed — check the SERP to confirm

Two keywords with different intents should never target the same page.

Opportunity Scoring

Score each keyword:

Opportunity Score = (Volume x (1 - Difficulty/100)) x Intent Multiplier

Intent multipliers:

  • Transactional: 1.5
  • Commercial investigation: 1.3
  • Informational: 1.0
  • Navigational: 0.2

This surfaces low-competition, high-intent targets over vanity volume plays.

Cluster Seeding

Group the keyword universe into topic clusters:

Cluster NamePillar KeywordSupporting Keywords (3-5)Total Volume
............

Each cluster needs one pillar page (head term) and 3-8 supporting pages (body + long-tail).

Output Format

Keyword Research: [topic or domain]

Summary

  • Total keywords: [count]
  • Total addressable volume: [sum]
  • Difficulty range: [min]-[max]
  • Clusters identified: [count]

Priority Matrix [Tiered keyword table]

Cluster Seeds [Cluster table]

Start Here — Top 5 Keywords

For each of the 5 highest-opportunity keywords:

  • Why this keyword now (difficulty, intent, business value)
  • What page type to create
  • Which cluster it anchors or supports

Pro Tip: Use the free Blog Keyword Generator and Autocomplete Research tools at seojuice.com for seed keyword discovery. SEOJuice MCP users can run /seojuice:keyword-analysis for live ranking data and /seojuice:content-strategy to see content gaps — keywords your competitors rank for that you don't.

FAQ

What does the find-keywords skill do?

Build a prioritized keyword list for a website, topic, or campaign. Use when the user asks about keyword research, finding keywords to target, building a keyword list, search demand, keyword difficulty, intent mapping, or which keywords to prioritize. For writing content around keywords, see brief. For grouping keywords into clusters, see build-clusters.

How do I install find-keywords?

Run npx skills add https://github.com/calm-north/seojuice-skills --skill find-keywords in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/find-keywords/ (personal) or .claude/skills/find-keywords/ (project).

Which AI agents can use find-keywords?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is find-keywords safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk flagged items to review; Runlayer flagged items to review; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains find-keywords?

It is published by calm-north in calm-north/seojuice-skills. It has 6,979 recorded installs.

More from calm-north/seojuice-skills

View all →

optimize-for-ai

calm-north/seojuice-skills

Optimize content for AI search engines — ChatGPT, Perplexity, Claude, Gemini, Google AI Overviews. Use when the user asks about AI SEO, AISO, getting cited by AI, appearing in AI answers, answer engine optimization, AEO, GEO, LLMO, AI Overviews, zero-click search, or how to appear in ChatGPT/Perplexity results. For traditional SEO, see diagnose-seo.

Marketing & SEO6.6K installs

build-links

calm-north/seojuice-skills

Design a link building campaign with prospect identification, asset creation, and outreach strategy. Use when the user asks about link building, backlinks, domain authority, how to get backlinks, outreach campaigns, digital PR, guest posting, or link acquisition. For internal linking, see fix-linking.

brief

calm-north/seojuice-skills

Produce an editor-ready content brief for a target keyword or topic. Use when the user asks for a content brief, writing guidelines, article outline, SEO brief, what to include in a blog post, or how to structure content for a keyword. For choosing which topics to write about, see find-keywords. For a full site-wide SEO audit, see audit.

Docs & Writing6.4K installs

audit

calm-north/seojuice-skills

Run a comprehensive SEO audit on a website covering technical health, on-page optimization, content quality, and backlink profile. Use when the user asks for an SEO audit, site review, SEO health check, "what's wrong with my SEO", website analysis, or a full diagnostic of their site's search performance. For speed-specific issues, see audit-speed. For technical crawl/index issues only, see diagnose-seo.

Security6.4K installs

rank-local

calm-north/seojuice-skills

Build a local SEO strategy covering Google Business Profile, local citations, reviews, and NAP consistency. Use when the user asks about local SEO, Google Business Profile, Google Maps ranking, local pack, NAP consistency, local citations, review strategy, or ranking for "[service] near me" searches.

Marketing & SEO2.5K installs

audit-speed

calm-north/seojuice-skills

Deep Core Web Vitals and page speed audit. Use when the user asks about page speed, Core Web Vitals, LCP, CLS, INP, FCP, TTFB, Lighthouse scores, why a page is slow, performance optimization, or resource size analysis. For broader technical SEO issues, see diagnose-seo.

Security2.4K installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs