Skip to main content
subagent CX Codex

seo-keyword-strategist — Claude Code subagent: SEO analysis

This subagent checks keyword use, estimates density, and finds related terms. Use it to review SEO content and plan semantic coverage.

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add wshobson/agents
/plugin install seo-technical-optimization@claude-code-workflows
Open on GitHub

What seo-keyword-strategist does

The subagent identifies primary and secondary keywords, calculates their density, maps related entities, and suggests semantic alternatives. It also infers likely search intent and flags signs of over-optimization. Its output includes guidance on keyword placement and topical coverage.

The workflow covers entities and related concepts, keyword distribution, question-style search terms, and topic clusters. The description also mentions WordPress SEO plugin integration and keyword schema in frontmatter for static sites. Claude Code setup requires adding the marketplace before installing the plugin, so both steps are part of the install process.

What it helps with

  • calculate keyword density in a draft
  • find semantic alternatives for a topic
  • flag repeated keywords that over-optimize a page
  • map entities and related concepts
  • plan keyword placement in an article

Example prompts for the agent

  • Analyze this draft, identify its main keywords, and calculate their density.
  • Suggest semantic alternatives and related concepts for this topic.
  • Review this page for over-optimization and recommend keyword placements.

How to install seo-keyword-strategist

1Plugin marketplace

/plugin marketplace add wshobson/agents
/plugin install seo-technical-optimization@claude-code-workflows

2Manually: put the files in place

.claude/agents/seo-keyword-strategist.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about seo-keyword-strategist

How do I install seo-keyword-strategist in Claude Code?

Add the marketplace with /plugin marketplace add wshobson/agents, then install the plugin with /plugin install seo-technical-optimization@claude-code-workflows.

What does seo-keyword-strategist do?

It reviews keyword usage, calculates density, maps related concepts, and suggests semantic alternatives. It can also flag over-optimization.

What kinds of recommendations does the subagent provide?

It suggests keyword placement, related entities and concepts to cover, plus question-based search terms and topic clusters.

Source text

seo-keyword-strategist.md · MIT
---
name: seo-keyword-strategist
description: Analyzes keyword usage in provided content, calculates density, suggests semantic variations and LSI keywords based on the topic. Prevents over-optimization. Use PROACTIVELY for content optimization.
model: haiku
---

You are a keyword strategist analyzing content for semantic optimization opportunities.

## Focus Areas

- Primary/secondary keyword identification
- Keyword density calculation and optimization
- Entity and topical relevance analysis
- LSI keyword generation from content
- Semantic variation suggestions
- Natural language patterns
- Over-optimization detection

## Keyword Density Guidelines

**Best Practice Recommendations:**

- Primary keyword: 0.5-1.5% density
- Avoid keyword stuffing
- Natural placement throughout content
- Entity co-occurrence patterns
- Semantic variations for diversity

## Entity Analysis Framework

1. Identify primary entity relationships
2. Map related entities and concepts
3. Analyze competitor entity usage
4. Build topical authority signals
5. Create entity-rich content sections

## Approach

1. Extract current keyword usage from provided content
2. Calculate keyword density percentages
3. Identify entities and related concepts in text
4. Determine likely search intent from content type
5. Generate LSI keywords based on topic
6. Suggest optimal keyword distribution
7. Flag over-optimization issues

## Output

**Keyword Strategy Package:**

```
Primary: [keyword] (0.8% density, 12 uses)
Secondary: [keywords] (3-5 targets)
LSI Keywords: [20-30 semantic variations]
Entities: [related concepts to include]
```

**Deliverables:**

- Keyword density analysis
- Entity and concept mapping
- LSI keyword suggestions (20-30)
- Search intent assessment
- Content optimization checklist
- Keyword placement recommendations
- Over-optimization warnings

**Advanced Recommendations:**

- Question-based keywords for PAA
- Voice search optimization terms
- Featured snippet opportunities
- Keyword clustering for topic hubs

**Platform Integration:**

- WordPress: Integration with SEO plugins
- Static sites: Frontmatter keyword schema

Focus on natural keyword integration and semantic relevance. Build topical depth through related concepts.

© Seth Hobson · MIT · wshobson/agents

Similar subagents

All subagents for SEO and GEO →

From the same set508

The whole set →
bash-pro Writes defensive, production-grade Bash scripts for CI/CD and automation. Enforces strict error handling, Bats tests, and cross-platform portability. CX Codex ★ 41,823repo stars seo-structure-architect Analyzes header hierarchy, suggests Schema markup, and maps internal linking opportunities. Organizes content structure so search engines and readers both understand it. CX Codex ★ 41,823repo stars seo-snippet-hunter Formats content for featured snippets and SERP features: direct answers, lists, tables. Useful when a page answers a question but never lands in position zero. CX Codex ★ 41,823repo stars seo-meta-optimizer The subagent generates search titles, meta descriptions, and clean URLs tailored to character limits and click-through rates. Useful when drafting metadata for new pages. CX Codex ★ 41,823repo stars seo-content-writer A subagent that turns a topic and keyword list into a full article with meta description, title options and internal link ideas. CX Codex ★ 41,823repo stars seo-content-planner Generates detailed SEO content outlines, maps topic clusters, and plans 30-60 day editorial calendars. It pinpoints topic gaps and matches search intent. CX Codex ★ 41,823repo stars seo-content-refresher Finds outdated dates, stats and examples in a page and turns them into a refresh plan. Useful when rankings start slipping. CX Codex ★ 41,823repo stars seo-cannibalization-detector Analyzes multiple pages to find keyword cannibalization, evaluate search intent conflicts, and propose content differentiation or merging plans. CX Codex ★ 41,823repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor