| name | topical-authority-mapper |
| description | Map complete topic clusters for any subject area — hub pages, spoke articles, supporting content, internal linking architecture. Identifies content gaps, priority order, and builds a structured content calendar. Produces topic maps that build genuine topical authority, not random blog posts.
|
| tags | ["seo"] |
Topical Authority Mapper
Most content strategies are just keyword lists turned into blog posts. Real topical authority requires a structured map: pillar pages that own broad topics, cluster pages that go deep on subtopics, and an internal linking architecture that tells Google "we comprehensively cover this subject." This skill builds that map.
Core principle: Google rewards topical depth, not random keyword coverage. A site with 15 interlinked articles that thoroughly cover "sales automation" will outrank a site with 50 unrelated blog posts that happen to mention the phrase. This skill builds the cluster architecture that creates genuine authority.
When to Use
- "What content should we create to dominate [topic]?"
- "Build a topic cluster strategy for our blog"
- "Map out our topical authority for [category]"
- "Create a content calendar based on topic clusters"
- "What content gaps do we have?"
Tool Enhancement (Optional)
Topic cluster mapping is significantly better with keyword data that shows search volume, difficulty, and semantic relationships across hundreds of subtopic variations.
Agent Prompt to User
"I can build a comprehensive topical authority map using competitive analysis and content gap identification. For the most precise results — especially accurate volume data and keyword clustering at scale — I'd recommend connecting a keyword data API."
Recommended: DataForSEO (pay-per-use, ~$0.01/keyword, no monthly minimum)
- Sign up at dataforseo.com → get API login + password
- Set
DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD env vars
Alternatives that also work:
- Keywords Everywhere API ($1 per 10 credits = 100K keywords, very cheap) → set
KEYWORDS_EVERYWHERE_API_KEY
- SEMrush API (if you have a subscription) → set
SEMRUSH_API_KEY
- Ahrefs API (if you have a subscription) → set
AHREFS_API_TOKEN
"Want to use one of these, or should I proceed with baseline mode? Baseline uses our existing SEO tools and web research — still produces a strong topic map, but with less granular volume data per subtopic."
Mode Selection
- Enhanced mode — Bulk keyword data via DataForSEO / Keywords Everywhere / SEMrush / Ahrefs. Gets search volume, difficulty, and semantic grouping for every subtopic. Enables data-driven prioritization and precise gap identification. Also supports keyword clustering APIs that automatically group related terms.
- Baseline mode — Uses
seo-domain-analyzer for domain metrics, web_search for topic research, reddit-scraper for question mining, competitor analysis via site-content-catalog. Topic mapping and cluster architecture are equally strong. Volume estimates are directional rather than exact.
Phase 0: Intake
- Your site URL — For existing content audit
- Target topics — 1-5 broad topic areas you want authority in (e.g., "sales automation", "content marketing", "data privacy")
- Competitors — 2-5 competitor URLs who rank well for these topics
- ICP — Who reads your content? (role, pain, goal)
- Content capacity — How many articles can your team produce per month?
- Existing content — Do you have a blog? How many articles? (we'll audit it)
- Time horizon — 3-month plan? 6-month? 12-month?
- Tool preference — Enhanced mode with keyword API, or baseline? (see Tool Enhancement above)
Phase 1: Current State Audit
1A: Your Existing Content
Run site-content-catalog on your site:
python3 skills/site-content-catalog/scripts/catalog_site.py \
--url "<your_site_url>" \
--output json
Map all existing content:
- Blog posts by topic
- Resource pages, guides, glossary
- Landing pages with content
- Identify which topics you already have content for
- Note: thin pages, outdated content, orphan pages (no internal links)
1B: Competitor Content Mapping
For each competitor, run site-content-catalog:
python3 skills/site-content-catalog/scripts/catalog_site.py \
--url "<competitor_url>" \
--output json
Map their content architecture:
- How do they structure topic clusters?
- Which topics have pillar pages?
- How deep do their clusters go?
- Internal linking patterns
- Content freshness (update dates)
1C: Domain Authority Baseline
Run seo-domain-analyzer for your site and competitors:
- Your domain authority vs. competitors
- Keyword overlap analysis
- Where competitors rank that you don't
Phase 2: Topic Universe Expansion
2A: Subtopic Discovery
For each target topic area, generate the full subtopic universe:
Enhanced mode (DataForSEO / Keywords Everywhere):
# DataForSEO keyword suggestions
POST /v3/dataforseo_labs/google/keyword_suggestions/live
{
"keyword": "<topic>",
"limit": 500
}
# DataForSEO related keywords
POST /v3/dataforseo_labs/google/related_keywords/live
{
"keyword": "<topic>",
"limit": 500
}
Extract:
- All related keywords and questions
- Search volumes per keyword
- Keyword difficulty scores
- Semantic groups (auto-clustered by meaning)
Baseline mode:
Use multiple sources to build the subtopic list:
web_search for "topic + [what/how/why/best/vs/guide/examples]"reddit-scraper for questions people ask about the topic- Google autocomplete patterns (via web search)
- Competitor content titles (from Phase 1B)
- PAA questions from search results
2B: Question Mining
Run reddit-scraper for each topic area:
python3 skills/reddit-scraper/scripts/scrape_reddit.py \
--query "<topic>" \
--subreddits "<relevant_subs>" \
--sort relevance --time year --limit 50
Extract:
- Questions people ask (→ individual article topics)
- Recurring themes (→ cluster pillars)
- Misconceptions (→ myth-busting content)
- Comparisons people make (→ vs/ content)
- Use cases discussed (→ use-case content)
2C: Keyword Clustering
Group all discovered keywords/subtopics into semantic clusters:
Enhanced mode: Use DataForSEO keyword clustering API or group by SERP overlap (keywords that share 3+ ranking URLs likely belong to the same cluster).
Baseline mode: Manual semantic grouping based on:
- Shared root concepts
- User intent alignment (informational / commercial / navigational)
- Topic hierarchy (broad → specific)
Phase 3: Cluster Architecture
3A: Pillar-Cluster Mapping
For each topic area, design the cluster hierarchy:
PILLAR: [Broad Topic] — "The Complete Guide to [Topic]"
│
├── CLUSTER 1: [Subtopic Group A]
│ ├── Article: [Specific subtopic A1]
│ ├── Article: [Specific subtopic A2]
│ └── Article: [Specific subtopic A3]
│
├── CLUSTER 2: [Subtopic Group B]
│ ├── Article: [Specific subtopic B1]
│ ├── Article: [Specific subtopic B2]
│ └── Article: [Specific subtopic B3]
│
├── CLUSTER 3: [Subtopic Group C]
│ ├── Article: [Specific subtopic C1]
│ └── Article: [Specific subtopic C2]
│
└── SUPPORTING: [Glossary terms, FAQs, tools]
├── Glossary: [Term 1]
├── Glossary: [Term 2]
└── FAQ: [Common questions]
3B: Content Type Assignment
For each piece in the cluster:
| Content Type | When to Use | Typical Word Count |
|---|
| Pillar page | Broad topic overview, links to all cluster content | 3,000-5,000+ |
| Cluster article | Deep dive on subtopic | 1,500-3,000 |
| Comparison post | vs/ or alternatives content | 2,000-3,500 |
| How-to guide | Step-by-step instruction | 1,500-2,500 |
| Glossary entry | Definition + context | 500-1,000 |
| Tool/Calculator | Interactive resource | 500 + tool |
| Case study | Proof point | 1,000-2,000 |
| Listicle | Curated collection | 1,500-3,000 |
3C: Internal Linking Architecture
Design the linking structure:
- Pillar → All cluster articles (every cluster article gets a link from the pillar)
- Cluster articles → Pillar (every article links back to the pillar)
- Cluster articles ↔ Related cluster articles (cross-links within the cluster)
- Cross-cluster links where topics overlap
- Supporting content → Relevant cluster articles (glossary terms link to articles that explain them in depth)
Map specific anchor text for each link.
Phase 4: Gap Analysis & Prioritization
4A: Coverage Gap Matrix
| Subtopic | Your Content | Competitor A | Competitor B | Volume | Difficulty | Gap? |
|---|
| [subtopic 1] | ✗ None | ✓ Pillar page | ✓ Blog post | [vol] | [diff] | ✓ High priority |
| [subtopic 2] | ✓ Thin post | ✓ Deep guide | ✗ None | [vol] | [diff] | ✓ Update needed |
| [subtopic 3] | ✓ Strong guide | ✓ Similar | ✓ Similar | [vol] | [diff] | ✗ Covered |
| [subtopic 4] | ✗ None | ✗ None | ✗ None | [vol] | [diff] | ✓ White space |
4B: Priority Scoring
Score each content piece to create:
| Factor | Weight | Description |
|---|
| Search volume | 25% | Monthly search demand |
| Competitive gap | 25% | How much better can you be than what exists? |
| Intent alignment | 20% | Does the searcher match your ICP? |
| Cluster completeness | 15% | Does this fill a critical gap in a cluster? |
| Effort | 15% | How much work to create high-quality content? |
4C: Content Calendar
Based on content capacity and priority scores:
Month 1: Build [N] pillar foundations
- [Pillar 1] — [rationale]
- [3-5 highest-priority cluster articles]
Month 2: Deepen Cluster 1, start Cluster 2
- [5-8 articles] — [rationale]
Month 3: Complete Cluster 2, begin Cluster 3
- [5-8 articles] — [rationale]
Months 4-6: Expansion
- [Continue pattern based on capacity]
Phase 5: Output
# Topical Authority Map — [Site/Client] — [DATE]
## Executive Summary
- Topic areas mapped: [N]
- Total content pieces identified: [N] (pillars: [N], clusters: [N], supporting: [N])
- Existing content: [N] pages ([N] strong, [N] need updates, [N] gaps)
- Net new content needed: [N] pages
- Estimated timeline to full coverage: [N] months at [N] articles/month
---
## Topic Map: [Topic Area 1]
### Cluster Architecture
[Visual tree structure per Phase 3A]
### Pillar Page
- **Target keyword:** [keyword] ([volume]/mo, [difficulty])
- **Title:** [recommended title]
- **Content type:** Comprehensive guide
- **Word count target:** [X]-[Y]
- **Links to:** [all cluster articles listed]
- **Status:** [Exists — needs update / New — priority [P0/P1/P2]]
### Cluster: [Subtopic Group A]
#### Article: [Subtopic A1]
- **Target keyword:** [keyword] ([volume]/mo, [difficulty])
- **Content type:** [how-to / comparison / listicle / etc.]
- **Word count target:** [X]-[Y]
- **Links to:** Pillar + [related articles]
- **Links from:** Pillar + [related articles]
- **Priority:** [P0/P1/P2]
- **Anchor text:** "[anchor]" from pillar, "[anchor]" from [related article]
#### Article: [Subtopic A2]
...
### Cluster: [Subtopic Group B]
...
---
## Topic Map: [Topic Area 2]
...
---
| From ↓ / To → | Pillar | Article A1 | Article A2 | Article B1 | ... |
|----------------|--------|-----------|-----------|-----------|-----|
| | — | ✓ "[anchor]" | ✓ "[anchor]" | ✓ "[anchor]" | |
| | ✓ "[anchor]" | — | ✓ "[anchor]" | | |
| | ✓ "[anchor]" | ✓ "[anchor]" | — | | |
| | ✓ "[anchor]" | | | — | |
---
| Week | Content Piece | Type | Cluster | Keywords | Priority |
|------|--------------|------|---------|----------|----------|
| W1 | [Pillar: Topic 1] | Pillar page | — | [kw] ([vol]) | P0 |
| W1 | [Article A1] | Cluster article | A | [kw] ([vol]) | P0 |
| W2 | [Article A2] | Cluster article | A | [kw] ([vol]) | P0 |
| W2 | [Article B1] | Cluster article | B | [kw] ([vol]) | P0 |
...
...
---
| Topic | Competitor Coverage | Your Status | Volume | Recommended Action |
|-------|-------------------|-------------|--------|--------------------|
| [topic] | A: Pillar, B: Blog post | None | [vol] | Create [content type] |
| Topic | Your Current Page | Issue | Volume | Recommended Action |
|-------|------------------|-------|--------|--------------------|
| [topic] | [URL] | Thin (400 words) | [vol] | Expand to [X] words, add [sections] |
| URL | Issue | Action Required | Effort |
|-----|-------|----------------|--------|
| [url] | Outdated (2023 data) | Update stats, refresh examples | 2 hours |
| [url] | No internal links | Add [N] links to cluster articles | 30 min |
| [url] | Missing from pillar | Add link from pillar with "[anchor]" | 15 min |
---
— Articles created vs. total identified
— Avg links per article within cluster
— Time from publish to page 1 per cluster
— Position for head terms
— Traffic attributed to each topic cluster
Save to clients/<client-name>/seo/topical-authority-map-[YYYY-MM-DD].md.
For large topic maps (3+ topic areas), also export a summary CSV:
clients/<client-name>/seo/content-calendar-[YYYY-MM-DD].csv
Cost
| Component | Cost |
|---|
| Site catalog (your site, once) | ~$0.05-0.10 |
| Site catalog per competitor | ~$0.05-0.10 |
| SEO domain analyzer | ~$0.10-0.20 |
| Reddit scraper (per topic area) | ~$0.05-0.10 |
| DataForSEO keyword data (enhanced) | ~$0.50-3.00 (depending on keyword count) |
| Keywords Everywhere (enhanced alt) | ~$0.01-0.10 |
| Page fetches (competitor content analysis) | ~$0.01-0.05 |
| Analysis | Free (LLM reasoning) |
| Total per topic area (baseline) | ~$0.25-0.50 |
| Total per topic area (enhanced) | ~$0.75-3.50 |
| 3 topic areas (baseline) | ~$0.75-1.50 |
| 3 topic areas (enhanced) | ~$2.25-10.50 |
Tools Required
- Apify API token —
APIFY_API_TOKEN env var
- Upstream skills:
site-content-catalog, seo-domain-analyzer, reddit-scraper, fetch_webpage
- Optional (enhanced): DataForSEO (
DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD), Keywords Everywhere (KEYWORDS_EVERYWHERE_API_KEY), SEMrush (SEMRUSH_API_KEY), or Ahrefs (AHREFS_API_TOKEN)
Scheduling
For ongoing topical authority tracking:
- Run quarterly to reassess coverage gaps
- Monthly: check for new subtopics emerging in the space
- After each content batch: update the map with published URLs and internal links
Trigger Phrases
- "Map our topical authority for [topic]"
- "Build a topic cluster strategy"
- "What content gaps do we have?"
- "Create a content calendar for SEO"
- "How do we build authority in [topic area]?"
- "Plan our content architecture"
