seo-aeo-keyword-research – Marketing & SEO skill for AI agents

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 text bundles no API connector. Use actually available authorized tools for measured metrics; cite provider, market, date and definition. Semantic analysis alone cannot measure monthly searches or CPC: mark those unknown instead of inventing numeric estimates. Qualitative difficulty is a hypothesis, not a provider score. Validate with a live tool

(Ahrefs, SEMrush, Google Keyword Planner) before committing

to a full content strategy.

Difficulty Scale

| Score | Label | Meaning |

|--------|-------------|------------------------------------------------------|

| 0–20 | Easy | Low competition, newer or niche keyword |

| 21–40 | Moderate | Some established content exists, beatable with quality |

| 41–60 | Competitive | Strong content exists, needs solid authority |

| 61–80 | Hard | Dominated by high-authority sites |

| 81–100 | Very Hard | Reserved for the biggest players — avoid early on |

Volume Scale (Estimated Monthly Searches)

| Label | Range |

|-------------|--------------------|

| Very High | 100,000+ |

| High | 10,000–99,999 |

| Medium | 1,000–9,999 |

| Low | 100–999 |

| Very Low | Under 100 |

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.

| CPC Range | Signal |

|-------------|------------------------------------------------------|

| $0–$1 | Low commercial value, good for awareness content |

| $1–$5 | Moderate value, mix of info and commercial intent |

| $5–$15 | High commercial value, strong conversion potential |

| $15+ | Very high value — transactional, competitive space |

---

Output Structure

The skill must always produce output in this exact format:

# Keyword Research Report

**Topic:** [topic]
**Business Type:** [business_type]
**Target Audience:** [target_audience]
**Content Goal:** [content_goal]
**Location:** [location or "Global"]
**Note:** All volume and difficulty figures are estimates.
Validate with a live keyword tool before final decisions.

---

## Seed Keywords

Core terms that define the topic's search territory:

| Seed Keyword         | Est. Volume | Difficulty | CPC Est. | Intent          |
|----------------------|-------------|------------|----------|-----------------|
| [keyword]            | [label]     | [score]    | [$x]     | [intent type]   |
| [keyword]            | [label]     | [score]    | [$x]     | [intent type]   |
| [keyword]            | [label]     | [score]    | [$x]     | [intent type]   |

---

## Priority Keyword Tiers

### 🟢 Tier 1 — Target First (High Value, Achievable)
Low-to-moderate difficulty. Should anchor your first
wave of content.

| Keyword              | Est. Volume | Difficulty | CPC Est. | Intent        | Content Type to Create  |
|----------------------|-------------|------------|----------|---------------|-------------------------|
| [keyword]            | [label]     | [score]    | [$x]     | [intent]      | [landing page / blog]   |
| [keyword]            | [label]     | [score]    | [$x]     | [intent]      | [content type]          |
| [keyword]            | [label]     | [score]    | [$x]     | [intent]      | [content type]          |

---

### 🟡 Tier 2 — Build Toward (Medium Difficulty)
Competitive but winnable with topical authority.
Target after Tier 1 content is live.

| Keyword              | Est. Volume | Difficulty | CPC Est. | Intent        | Content Type to Create  |
|----------------------|-------------|------------|----------|---------------|-------------------------|
| [keyword]            | [label]     | [score]    | [$x]     | [intent]      | [content type]          |
| [keyword]            | [label]     | [score]    | [$x]     | [intent]      | [content type]          |

---

### 🔴 Tier 3 — Long-Term Goals (High Difficulty)
Dominated by high-authority sites. Do not target these
until significant topical authority is established.

| Keyword              | Est. Volume | Difficulty | CPC Est. | Intent        | Notes                   |
|----------------------|-------------|------------|----------|---------------|-------------------------|
| [keyword]            | [label]     | [score]    | [$x]     | [intent]      | [why it's hard]         |

---

## Long-Tail Keywords

Long-tail specificity may improve intent fit; volume, difficulty and conversion performance require evidence and are not guaranteed by query length.

| Long-Tail Keyword                    | Est. Volume | Difficulty | Intent        | Best For              |
|--------------------------------------|-------------|------------|---------------|-----------------------|
| [keyword]                            | [label]     | [score]    | [intent]      | [blog / landing page] |
| [keyword]                            | [label]     | [score]    | [intent]      | [content type]        |
| [keyword]                            | [label]     | [score]    | [intent]      | [content type]        |
| [keyword]                            | [label]     | [score]    | [intent]      | [content type]        |
| [keyword]                            | [label]     | [score]    | [intent]      | [content type]        |

---

## AEO Keywords

Question-based and conversational keywords that AI engines
surface in direct answers, featured snippets, and
People Also Ask boxes.

| AEO Keyword / Question                         | Est. Volume | Intent        | Answer Format to Use   |
|------------------------------------------------|-------------|---------------|------------------------|
| What is [topic]?                               | [label]     | informational | Definition sentence    |
| How does [topic] work?                         | [label]     | informational | Numbered steps         |
| What is the best [topic] for [audience]?       | [label]     | commercial    | Comparison table       |
| How much does [topic] cost?                    | [label]     | transactional | Direct number + range  |
| [topic] vs [alternative] — which is better?   | [label]     | commercial    | Comparison block       |
| Is [topic] worth i

… (full content is in the download package)