Skill: tktk-ai/tk-seo-keyword-mapper (version 1.0.0)

--- name: seo-keyword-mapper description: Generate comprehensive keyword maps for any niche — clusters, search intent, difficulty estimates, content briefs, and internal linking strategies. Turn one seed keyword into a full content strategy. metadata: version: 1.0.0 author: TKDigital category: SEO & Content tags: [seo, keywords, content strategy, keyword research, search intent, content planning, topical authority] --- # SEO Keyword Mapper Transform seed keywords into complete content strategies with clusters, intent mapping, and content briefs. ## What It Does 1. **Keyword Expansion** — Takes 1-3 seed keywords and generates 50-200 related terms 2. **Cluster Mapping** — Groups keywords into topical clusters (pillar + supporting content) 3. **Intent Classification** — Labels each keyword: informational, navigational, commercial, transactional 4. **Difficulty Estimation** — Rates competition level for prioritization 5. **Content Brief Generation** — Creates outlines with target keywords, headers, and word count 6. **Internal Linking Map** — Shows how content pieces should link to each other ## Usage ### Full Keyword Map ``` Create a keyword map for: [NICHE/TOPIC] Seed keywords: [1-3 keywords] Target audience: [Who are you writing for] Business type: [SaaS / agency / e-commerce / blog / etc.] Goal: [Traffic / leads / sales / authority] Generate: 1. 100 keyword ideas grouped into clusters 2. Search intent for each 3. Difficulty estimate (easy/medium/hard) 4. Priority ranking (which to target first) 5. Content type recommendation per keyword (blog/landing page/comparison/guide) 6. Internal linking structure ``` ### Quick Cluster Analysis ``` I want to rank for "[TARGET KEYWORD]". Give me: 1. The pillar content piece I need (topic, angle, word count) 2. 10-15 supporting articles that build topical authority 3. How they should interlink 4. What order to publish them in 5. Estimated timeline to rank (based on competition signals) ``` ### Content Calendar from Keywords ``` Turn this keyword map into a 3-month content calendar: Month 1: Foundation pieces (low competition, high relevance) Month 2: Supporting content (medium competition, topical depth) Month 3: Money pages (commercial intent, conversion-focused) For each piece: title, target keyword, word count, publish date, internal links ``` ### Competitor Keyword Gap ``` I'm competing with these sites: 1. [Competitor URL 1] 2. [Competitor URL 2] My site: [Your URL] Find keywords they rank for that I don't. Group into: - Quick wins (low difficulty, high relevance) - Strategic targets (high value, worth investing in) - Ignore (irrelevant or too competitive) ``` ## Output Format ### Keyword Cluster ``` ## Cluster: [Topic Name] **Pillar Page**: [Main keyword] — [search volume estimate] — [difficulty] | Supporting Keyword | Intent | Difficulty | Content Type | Priority | |-------------------|--------|------------|--------------|----------| | [keyword] | Info | Easy | Blog post | High | | [keyword] | Commercial | Medium | Comparison | High | | [keyword] | Transactional | Hard | Landing page | Medium | **Internal Linking**: - All supporting articles link to pillar page - Pillar links to top 5 supporting articles - Cross-link related supporting articles ``` ### Content Brief ``` ## Brief: [Title] **Target Keyword**: [primary keyword] **Secondary Keywords**: [2-4 terms to include] **Intent**: [Informational / Commercial / Transactional] **Word Count**: [Recommended range] **Difficulty**: [Easy / Medium / Hard] ### Required Sections: - H1: [Title with keyword] - H2: [Section heading] - Key points to cover - H2: [Section heading] - Key points to cover - H2: FAQ (target People Also Ask) - Q: [Common question] - Q: [Common question] ### Internal Links: - Link TO: [related article on your site] - Link FROM: [articles that should link here] ### Competitive Notes: - Top 3 ranking pages: [what they cover] - Gap: [what they miss that you should include] ``` ## SEO Principles Built In - **Topical authority** — Build clusters, not random articles - **Intent matching** — Match content format to search intent - **Low-hanging fruit first** — Target easy keywords early for quick wins - **Internal linking** — Every piece strengthens the cluster - **Content depth** — Longer isn't better, more comprehensive IS better ## References - `references/intent-guide.md` — How to classify search intent - `references/difficulty-estimation.md` — How competition is estimated - `references/content-type-matrix.md` — Which content format for which intent

path: README.md
content: # SEO Keyword Mapper — ClawHub Skill

> Turn seed keywords into complete content strategies with clusters, intent mapping, difficulty estimates, and content briefs.

## Why This Skill?

Most SEO tools cost $100-300/month. They give you data but not strategy. This skill gives you the strategy — keyword clusters, content briefs, internal linking maps, and publication calendars — from a few seed keywords.

**Replaces**: Ahrefs keyword explorer ($99/mo), Semrush keyword magic tool ($129/mo), manual keyword research (10+ hours/month)

## Quick Start

```bash
clawhub install seo-keyword-mapper
```

Then:
```
Create a keyword map for "AI automation for small business". Give me clusters, content briefs, and a 3-month publishing calendar.
```

## Features

| Feature | Description |
|---------|-------------|
| Keyword Expansion | 1-3 seeds → 50-200 related terms |
| Cluster Mapping | Pillar + supporting content groups |
| Intent Classification | Info / navigational / commercial / transactional |
| Difficulty Estimation | Easy / medium / hard with reasoning |
| Content Briefs | Full outlines with keywords, headers, word counts |
| Internal Linking | How every piece connects |
| Content Calendar | 3-month prioritized publishing schedule |
| Competitor Gaps | Keywords they rank for that you don't |

## Ideal For

- **Bloggers** — Stop guessing what to write
- **Agencies** — Deliver keyword strategies to clients in minutes
- **SaaS companies** — Build topical authority systematically
- **E-commerce** — Map product and category page keywords
- **Freelance SEOs** — 10x your research speed

## Author

**TKDigital** — AI automation for revenue  
Built with OpenClaw | [clawhub.com](https://clawhub.com)


path: references/intent-guide.md
content: # Search Intent Classification Guide

## The 4 Intent Types

### Informational (60-70% of searches)
**Signal words**: how, what, why, when, guide, tutorial, tips, examples, learn
**User goal**: Learn something, understand a concept
**Content format**: Blog posts, guides, tutorials, explainers
**Monetization**: Ads, affiliate links, email capture → nurture → sell
**Example**: "how to automate social media posting"

### Navigational (10-15% of searches)
**Signal words**: [brand name], login, pricing, reviews, [brand] vs
**User goal**: Find a specific page or brand
**Content format**: Landing pages, brand pages, documentation
**Monetization**: Direct if it's your brand, comparison pages if competitor
**Example**: "OpenClaw documentation", "Buffer login"

### Commercial Investigation (15-20% of searches)
**Signal words**: best, top, review, comparison, vs, alternative to, for [use case]
**User goal**: Research before buying, compare options
**Content format**: Comparison posts, reviews, roundups, "best X for Y"
**Monetization**: Affiliate links, lead capture, product pages
**Example**: "best ai writing tools for agencies 2026"

### Transactional (5-10% of searches)
**Signal words**: buy, price, discount, coupon, free trial, download, sign up
**User goal**: Complete a purchase or action
**Content format**: Product pages, pricing pages, landing pages
**Monetization**: Direct sales, signups, downloads
**Example**: "openclaw pricing", "ai content tool free trial"

## Intent → Content Type Matrix

| Intent | Best Content Type | Avg Word Count | CTA Type |
|--------|-------------------|---------------|----------|
| Informational | Blog post, guide | 1,500-3,000 | Email signup, related content |
| Navigational | Landing page | 500-1,000 | Direct action (login, docs) |
| Commercial | Comparison, review | 2,000-4,000 | Affiliate link, free trial |
| Transactional | Product/pricing page | 500-1,500 | Buy button, signup form |

## Priority Order for New Sites

1. **Low-competition informational** — Build traffic and authority
2. **Commercial comparison** — Capture decision-stage visitors
3. **Transactional** — Convert existing brand awareness
4. **High-competition informational** — Long-term authority play


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)