afrexai-seo-content-engine

# SEO Content Engine

Turn your AI agent into a full SEO content team. Research → Plan → Write → Optimize → Publish — all in natural language.

No APIs. No subscriptions. Just smart agent workflows using web search and structured frameworks.

---

## 1. Keyword Research Framework

### Seed Expansion
When given a topic, expand it systematically:

1. **Core keyword**: The main term (e.g., "project management software")
2. **Long-tail variants**: Add modifiers — best, top, free, for [audience], vs, alternative, review, how to, guide
3. **Question keywords**: How/What/Why/When/Where + core keyword
4. **Problem keywords**: What pain does this solve? ("team missing deadlines", "project overruns")
5. **Comparison keywords**: "[Product A] vs [Product B]", "[Product] alternatives"

### Search Intent Classification

For each keyword, classify intent:

| Intent | Signal Words | Content Type |
|--------|-------------|--------------|
| **Informational** | how to, what is, guide, tutorial, why | How-to guide, explainer, tutorial |
| **Commercial** | best, top, review, comparison, vs | Listicle, comparison, review |
| **Transactional** | buy, pricing, discount, free trial, download | Product page, landing page |
| **Navigational** | [brand name], login, support, docs | Brand page (skip — low value) |

### Competition Analysis (Using Web Search)

For each target keyword:

```
Step 1: Search the exact keyword
Step 2: Analyze top 5 results:
  - What type of content ranks? (listicle, guide, review)
  - What's the average word count? (check article length)
  - What subtopics do ALL top results cover? (table stakes)
  - What subtopics do NONE cover? (your opportunity)
  - Who wrote them? (big brand = harder, niche blog = beatable)
Step 3: Score opportunity:
  - Mostly forums/Reddit in top 5 = HIGH opportunity (no dedicated content)
  - All big brands (Forbes, HubSpot) = LOW opportunity (hard to outrank)
  - Mix of niche sites = MEDIUM opportunity (winnable with better content)
```

###...

# SEO Content Engine by AfrexAI

Turn your AI agent into a complete SEO content team. Research keywords, plan content clusters, write optimized articles, and track performance — all through natural conversation.

**No API keys. No subscriptions. No code.** Just install and start creating content that ranks.

## Install

```bash
clawhub install afrexai-seo-content-engine
```

## What's Inside

- **Keyword Research Framework** — seed expansion, intent classification, competition scoring, prioritization matrix
- **Content Planning System** — briefs, content clusters, pillar-cluster architecture, editorial calendars
- **4 Article Templates** — listicles, how-to guides, comparisons, ultimate guides (with fill-in structure)
- **Writing Framework (HBCFC)** — Hook → Bridge → Core → FAQ → CTA formula for every article
- **On-Page SEO Checklist** — 25-point checklist covering title, meta, headings, content, links, schema
- **Content Scoring Rubric** — 100-point system to grade articles before publishing
- **Schema Markup Templates** — ready-to-use Article + FAQ JSON-LD
- **Advanced Techniques** — featured snippets, semantic SEO, E-E-A-T signals, freshness optimization

## Quick Start

Just tell your agent:

- "Research keywords for [your topic]"
- "Create a content brief for [keyword]"
- "Write a comparison article: [X] vs [Y]"
- "Score this article for SEO"
- "Plan a content cluster for [topic]"

## Why This Over Other SEO Skills?

| Feature | Others | AfrexAI SEO Engine |
|---------|--------|--------------------|
| Keyword research framework | ❌ Fake API calls | ✅ Real web search workflow |
| Article templates | ❌ Generic outlines | ✅ 4 fill-in templates with structure |
| Writing rules | ❌ "Write good content" | ✅ Specific sentence/paragraph/keyword rules |
| SEO checklist | ❌ Basic tips | ✅ 25-point pre-publish checklist |
| Content scoring | ❌ None | ✅ 100-point rubric |
| Schema markup | ❌ Mentioned | ✅ Copy-paste JSON-LD templates |
| Content clusters | ❌...