agentleFS
teemukarjaluototeemukarjaluoto/seo-sauna-mcp/skills/keyword-research/SKILL.md

keyword-research

Skill0 starsChanged 19 days agoMITView on GitHub

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

59 other projects use a version of this, 12 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use openseo-release-notes, openseo-review-web-content and 5 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JwuthriSkill

    openseo-release-notes

    Cut an OpenSEO release — bump the version, draft user-facing release notes from commits since the last tag, run a review + subagent-verification pass, and open a "release: vX.X.X" PR. Use when the user asks to prepare a release, bump the version, or write release notes.

    Also in 6 projects that use this

  • JwuthriSkill

    openseo-review-web-content

    Write and review content for the OpenSEO website (web/) — blog posts, guides, feature pages, FAQs. Distills the philosophy for on-brand, useful, accurate content. Use whenever adding or editing user-facing prose in web/content or web/src.

    Also in 5 projects that use this

  • Ethan-paseyaSkill

    review-analysis

    Amazon review and VOC analysis using SellerSprite MCP. Use when the user runs `/review-analysis {ASIN} {SITE}` to analyze positive and negative reviews, identify product pain points, listing mismatch, service risks, and product improvement actions.

    Also in 6 projects that use this

  • Kungfookenny123Skill

    app-marketing-context

    When the user wants to create or update their app marketing context document. Also use when the user mentions "app context", "marketing brief", "app positioning", or when starting any ASO or app marketing project. This is the foundation skill — all other skills check for this context first.

    Also in 4 projects that use this

  • Kungfookenny123Skill

    metadata-optimization

    When the user wants to optimize App Store metadata — title, subtitle, keyword field, or description. Also use when the user mentions "optimize my title", "ASO metadata", "keyword field", "character limits", "app description", or "write my subtitle". For keyword discovery, see keyword-research. For full ASO audits, see aso-audit.

    Also in 4 projects that use this

  • OpenClaudiaSkill

    backlink-audit

    Audit a domain's backlink profile using the SemRush API. Use when the user says "audit backlinks", "check my backlinks", "backlink analysis", "link profile", "toxic links", "disavow", "link building opportunities", "referring domains", "anchor text", or asks about a site's link authority.

    Also in 4 projects that use this

  • +1 more from Jwuthri

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 3 are distinctive, and 10 are very specific to this project.

  • 0

    Common

    Most of the 54 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 10

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    If projectId is missing, use list_projects first.

    line 18
  2. Very specific:

    Call get_project_context first and ground the research in it, the business, the goal, the markets, and the competitors and key pages …

    line 24
  3. Distinctive:

    Before spending credits, check the research log.

    line 26
  4. Very specific:

    Call research_keywords for exploratory seeds.

    line 48
  5. Very specific:

    Use get_keyword_metrics to hydrate a fixed keyword list, or the striking-distance queries from step 1, with volume, KD, and intent before …

    line 49
  6. Very specific:

    Use get_ranked_keywords when the user provides a domain/page and wants opportunities based on current rankings, near-misses, or …

    line 50
  7. Distinctive:

    Remove irrelevant, duplicate, branded-only, and off-intent terms.

    line 51
  8. Very specific:

    Use get_serp_results for high-potential or ambiguous keywords when SERP intent would change the recommendation.

    line 59
  9. Very specific:

    Ask before saving keywords.

    line 61
  10. Very specific:

    If a report template applies (see seo-report), its sections and tone replace this list.

    line 67
  11. Very specific:

    Do not invent metrics. If SEO Sauna does not return a value, write unknown.

    line 81
  12. Very specific:

    Do not call save_keywords without explicit confirmation.

    line 82
  13. Distinctive:

    Prefer business-fit and intent-fit over chasing the largest volume term.

    line 83

“Common” is measured: kept by at least 6 in 10 of the 54 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

SEO Sauna Keyword Research

Goal

Turn seed topics into a prioritized keyword opportunity set using SEO Sauna MCP data. The output should help the user decide what to target, what to save, and what to research next.

Required inputs

  • projectId
  • One or more seed topics, products, pages, competitors, or audience problems
  • Optional market/location/language

If projectId is missing, use list_projects first. If the target market/location/language is unclear and would materially affect keyword metrics, ask the user; otherwise use the MCP tool defaults.

Project context

The project-context tools are free and shared with the app and other agents.

  1. Call get_project_context first and ground the research in it, the business, the goal, the markets, and the competitors and key pages already saved.
  2. This skill needs business_overview and current_goal. If either is empty, run a minimal inline setup: ask the user, or infer from the site and confirm, just enough to fill them, write them back with update_project_context, then continue the research. Never front-load the full interview; suggest seo-project-setup at the end for the rest.
  3. Before spending credits, check the research log. If the same research ran within the last 30 days, reuse that result and say so instead of re-buying it.
  4. On finish, write back what is durable, a sharpened business_overview or current_goal, competitors that kept appearing in the SERPs via addCompetitors, pages the keywords should land on via addKeyPages, and append a research log entry: { appendResearchLog: { summary: "Keyword research: <seeds/market>. Verdict: <conclusion>" } }.

Deliver as a report

Deliver through the seo-report skill, saving with skill: "keyword-research". If that skill is not available, say so and stop before writing HTML.

SEO Sauna MCP tools

  • research_keywords: primary discovery tool. Use 1-5 seeds per call and prefer 150 results unless the user asks for exhaustive research. For demand in one city, county, or region, call search_serp_locations and pass the returned locationName on the seed: volume, CPC, and competition become local; keyword ideas, KD, and intent stay national.
  • get_keyword_metrics: hydrate up to 700 known keywords with volume, keyword difficulty (KD), search intent, CPC, and monthly trends in one call. Use it to score candidate or known terms, including the Search Console striking-distance queries from step 1.
  • get_ranked_keywords: pull exact ranking keyword rows when a target domain or page is part of the research brief.
  • get_search_console_performance: when Search Console is connected, start from the project's real first-party demand, queries already earning impressions and near-ranking ("striking distance") terms. Pass minPosition: 5, maxPosition: 20, minImpressions: 50 so the server filters the striking-distance rows for you (Google sorts by clicks and can't filter by position itself). Then hydrate those striking-distance queries with get_keyword_metrics to attach difficulty and intent.
  • get_serp_results: inspect SERPs for the top candidate terms, especially when intent is ambiguous. Pass the same locationName for the SERP in one city, county, or region.
  • search_local_businesses, get_local_serp_results, and get_google_business_questions: use for local SEO topics when a business/location radius matters.
  • list_saved_keywords: avoid duplicating already-saved work or use existing tags as context.
  • save_keywords: save selected keywords only after explicit user confirmation.

Workflow

  1. Normalize seeds into a small set of distinct research angles. If Search Console is connected for the project, first pull get_search_console_performance with minPosition: 5, maxPosition: 20, minImpressions: 50 (default lookback), and hydrate those queries with get_keyword_metrics to attach KD and intent. That ranked, hydrated list is your fastest opportunity set, work it before broad discovery.
  2. If the request is local SEO, identify the business, location/coordinates or service area, and local categories. Research local volume for that city or county with research_keywords and locationName. Use search_local_businesses and get_local_serp_results for the most important location/keyword set instead of relying only on national keyword/SERP data.
  3. Call research_keywords for exploratory seeds. Use bulk calls when possible.
  4. Use get_keyword_metrics to hydrate a fixed keyword list, or the striking-distance queries from step 1, with volume, KD, and intent before prioritizing.
  5. Use get_ranked_keywords when the user provides a domain/page and wants opportunities based on current rankings, near-misses, or competitor-owned terms.
  6. Remove irrelevant, duplicate, branded-only, and off-intent terms.
  7. Prioritize by practical opportunity, not volume alone:
    • Strong match to the user's product/page/topic
    • Clear search intent
    • Reasonable difficulty
    • Useful volume/CPC signal
    • SERP where the user can plausibly compete
    • For local SEO, local-pack/Maps visibility and proximity fit
  8. Use get_serp_results for high-potential or ambiguous keywords when SERP intent would change the recommendation; keep the default check small.
  9. Present a shortlist and a longer opportunity table.
  10. Ask before saving keywords. When saving, suggest concise tags such as topic:<topic>, intent:<intent>, or page:<slug>.

Output format

h1: the site or topic.

If a report template applies (see seo-report), its sections and tone replace this list.

Sections in this order:

  1. The opportunity, one or two opening sentences naming the best theme and why the site can win it now.
  2. Target these now, a table of keyword, intent, volume, KD, CPC, and the page to make. Add a bar chart comparing the volumes of the shortlist.
  3. Why these, one finding per keyword that needs justifying: the SERP or metric evidence, then the page to build.
  4. The longer opportunity list, a second table, same columns.
  5. Risks and caveats, notes: SERP intent that would change the recommendation, missing metrics written as unknown, close-variant volumes that are one bucket rather than several.
  6. What to do next, an ordered list, including whether to run keyword clustering, write a content brief, or save the chosen keywords.
  7. How this report was made, opens with the fixed line from seo-report (workflow name "Keyword Research"), then which tools returned what.

Guardrails

  • Do not invent metrics. If SEO Sauna does not return a value, write unknown.
  • Do not call save_keywords without explicit confirmation.
  • Prefer business-fit and intent-fit over chasing the largest volume term.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.