mirror of
https://github.com/MODSetter/SurfSense.git
synced 2026-05-08 07:12:39 +02:00
feat: enhance SurfSense with new skills, blog section, and improve SEO metadata
Some checks failed
Build and Push Docker Images / tag_release (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Has been cancelled
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Has been cancelled
Some checks failed
Build and Push Docker Images / tag_release (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Has been cancelled
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Has been cancelled
- Added multiple new skills to skills-lock.json from the repository `aaron-he-zhu/seo-geo-claude-skills`. - Introduced `fuzzy-search` dependency in package.json for improved search functionality. - Updated pnpm-lock.yaml to include the new `fuzzy-search` package. - Enhanced SEO metadata across various pages, including canonical links and descriptions for better search visibility. - Improved layout and structure of several components, including the homepage and changelog, to enhance user experience.
This commit is contained in:
DESKTOP-RTLN3BA\$punk
parent
61b3f0d7e3
commit
7ea840dbb2
120 changed files with 25729 additions and 352 deletions
96
.cursor/skills/keyword-research/references/example-report.md
Normal file
96
.cursor/skills/keyword-research/references/example-report.md
Normal file
|
|
@ -0,0 +1,96 @@
|
|||
# Keyword Research — Example Report
|
||||
|
||||
This is a complete example output showing the expected format for keyword research deliverables.
|
||||
|
||||
## Prompt
|
||||
|
||||
**User**: "Research keywords for a project management software company targeting small businesses"
|
||||
|
||||
## Example Output
|
||||
|
||||
```markdown
|
||||
# Keyword Research Report: Project Management Software
|
||||
|
||||
**Generated**: [current month and year]
|
||||
**Target Audience**: Small business owners and teams
|
||||
**Business Goal**: Software signups and trials
|
||||
|
||||
## Executive Summary
|
||||
|
||||
- Total keywords analyzed: 150+
|
||||
- High-priority opportunities: 23
|
||||
- Estimated traffic potential: 45,000/month
|
||||
- Recommended focus areas:
|
||||
- Task management workflows
|
||||
- Team collaboration
|
||||
- Small business productivity
|
||||
|
||||
## Top Keyword Opportunities
|
||||
|
||||
### Quick Wins (Priority: Immediate)
|
||||
|
||||
| Keyword | Volume | Difficulty | Intent | Score |
|
||||
|---------|--------|------------|--------|-------|
|
||||
| project management for small teams | 1,200 | 28 | Commercial | 92 |
|
||||
| simple task management software | 890 | 25 | Commercial | 89 |
|
||||
| best free project management tool | 2,400 | 35 | Commercial | 85 |
|
||||
| how to manage remote team projects | 720 | 22 | Informational | 82 |
|
||||
| project tracking spreadsheet alternative | 480 | 18 | Commercial | 80 |
|
||||
|
||||
### Growth Keywords (Priority: 3-6 months)
|
||||
|
||||
| Keyword | Volume | Difficulty | Intent | Score |
|
||||
|---------|--------|------------|--------|-------|
|
||||
| project management software | 18,000 | 72 | Commercial | 65 |
|
||||
| best project management tools [current year] | 8,500 | 65 | Commercial | 62 |
|
||||
| project management app | 12,000 | 68 | Commercial | 58 |
|
||||
|
||||
### GEO Opportunities (AI-citation potential)
|
||||
|
||||
| Keyword | Type | AI Potential | Recommended Format |
|
||||
|---------|------|--------------|-------------------|
|
||||
| what is project management | Definition | ⭐⭐⭐⭐⭐ | Clear definition + methodology |
|
||||
| agile vs waterfall | Comparison | ⭐⭐⭐⭐⭐ | Side-by-side comparison table |
|
||||
| project management methodologies | List | ⭐⭐⭐⭐ | Comprehensive list with pros/cons |
|
||||
| how to create a project plan | How-to | ⭐⭐⭐⭐ | Step-by-step guide |
|
||||
| project management best practices | List | ⭐⭐⭐⭐ | Numbered best practices |
|
||||
|
||||
## Topic Clusters
|
||||
|
||||
### Cluster 1: Project Management Fundamentals
|
||||
|
||||
**Pillar**: "Complete Guide to Project Management" (8,500 volume)
|
||||
|
||||
Cluster articles:
|
||||
1. What is project management? (2,200 volume)
|
||||
2. Project management methodologies explained (1,800 volume)
|
||||
3. How to create a project plan (1,400 volume)
|
||||
4. Project management best practices (1,200 volume)
|
||||
5. Project management roles and responsibilities (890 volume)
|
||||
|
||||
### Cluster 2: Team Collaboration
|
||||
|
||||
**Pillar**: "Team Collaboration Tools Guide" (4,200 volume)
|
||||
|
||||
Cluster articles:
|
||||
1. How to improve team communication (1,600 volume)
|
||||
2. Remote team management tips (1,400 volume)
|
||||
3. Best practices for distributed teams (920 volume)
|
||||
4. Team productivity tools comparison (780 volume)
|
||||
|
||||
## Content Calendar Recommendations
|
||||
|
||||
| Month | Content | Target Keyword | Type |
|
||||
|-------|---------|----------------|------|
|
||||
| Week 1 | Simple Task Management Guide | simple task management software | Blog + Demo |
|
||||
| Week 2 | Project Management for Small Teams | project management for small teams | Pillar Page |
|
||||
| Week 3 | Agile vs Waterfall: Complete Comparison | agile vs waterfall | Comparison |
|
||||
| Week 4 | Free PM Tools Roundup | best free project management tool | Listicle |
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Immediate**: Create landing pages for top 5 quick-win keywords
|
||||
2. **Week 1-2**: Write pillar content for "Project Management Fundamentals"
|
||||
3. **Week 3-4**: Build out cluster content with internal linking
|
||||
4. **Ongoing**: Track rankings and adjust strategy based on performance
|
||||
```
|
||||
|
|
@ -0,0 +1,324 @@
|
|||
# Keyword Intent Taxonomy
|
||||
|
||||
A comprehensive classification system for understanding search intent, mapping keywords to content strategies, and aligning with conversion funnels.
|
||||
|
||||
## Overview
|
||||
|
||||
Search intent (also called user intent or query intent) is the underlying goal a user has when typing a query into a search engine or AI system. Correctly classifying intent determines content format, tone, depth, and conversion strategy.
|
||||
|
||||
This taxonomy defines **4 primary intent types**, each with **3-4 sub-categories**, along with signal words, SERP feature correlations, and content format recommendations.
|
||||
|
||||
---
|
||||
|
||||
## Primary Intent Types
|
||||
|
||||
### 1. Informational Intent
|
||||
|
||||
The user wants to **learn something**. They are seeking knowledge, not a product.
|
||||
|
||||
#### Sub-categories
|
||||
|
||||
| Sub-category | Description | Example Queries |
|
||||
|-------------|------------|----------------|
|
||||
| **Educational** | Broad learning about a topic | "what is SEO", "content marketing explained", "how search engines work" |
|
||||
| **Instructional** | Step-by-step guidance on completing a task | "how to set up Google Analytics", "how to write a meta description", "how to do keyword research" |
|
||||
| **Exploratory** | Open-ended research to understand options | "types of SEO strategies", "content marketing trends", "link building techniques" |
|
||||
| **Troubleshooting** | Diagnosing and fixing a problem | "why is my site not ranking", "Google indexing issues", "404 error fix" |
|
||||
|
||||
#### Signal Words and Modifiers
|
||||
|
||||
**Strong informational signals:**
|
||||
- what, what is, what are, what does
|
||||
- how, how to, how does, how do I
|
||||
- why, why is, why does, why do
|
||||
- when, when to, when should
|
||||
- who, who is, who does
|
||||
- where, where to, where can I
|
||||
- guide, tutorial, learn, explain
|
||||
- examples, tips, ideas, ways
|
||||
- definition, meaning, difference between
|
||||
- history of, basics of, introduction to
|
||||
- pros and cons, advantages, disadvantages
|
||||
- best practices, checklist, steps
|
||||
|
||||
**Weak informational signals (may overlap with commercial):**
|
||||
- overview, comparison, review (can be commercial)
|
||||
- list of, types of, methods
|
||||
|
||||
#### SERP Feature Correlation
|
||||
|
||||
| SERP Feature | Frequency for Informational | Notes |
|
||||
|-------------|---------------------------|-------|
|
||||
| Featured Snippet | Very High | Especially for "what is" and "how to" queries |
|
||||
| People Also Ask | Very High | Almost always present for informational queries |
|
||||
| Knowledge Panel | High | For entity-related informational queries |
|
||||
| AI Overview | Very High | AI systems prioritize informational answers |
|
||||
| Video Carousel | Medium-High | Especially for instructional queries |
|
||||
| Image Pack | Medium | For visual/diagram-seeking queries |
|
||||
| Shopping Results | Very Low | Rarely appears for pure informational |
|
||||
|
||||
#### Content Format Recommendations
|
||||
|
||||
| Sub-category | Best Formats | Target Length | Key Elements |
|
||||
|-------------|-------------|--------------|-------------|
|
||||
| Educational | Definitive guides, explainers, glossary entries | 1,500-3,000 words | Clear definitions, examples, visuals |
|
||||
| Instructional | Step-by-step tutorials, how-to guides, video walkthroughs | 2,000-4,000 words | Numbered steps, screenshots, code samples |
|
||||
| Exploratory | Listicles, roundups, trend reports, comparison tables | 2,000-3,500 words | Categories, pros/cons, use cases |
|
||||
| Troubleshooting | FAQ pages, debug guides, knowledge base articles | 800-2,000 words | Problem-solution pairs, error codes, screenshots |
|
||||
|
||||
---
|
||||
|
||||
### 2. Navigational Intent
|
||||
|
||||
The user wants to **find a specific website, page, or resource**. They already know where they want to go.
|
||||
|
||||
#### Sub-categories
|
||||
|
||||
| Sub-category | Description | Example Queries |
|
||||
|-------------|------------|----------------|
|
||||
| **Brand Search** | Looking for a specific company or product | "Ahrefs", "HubSpot CRM", "Moz Pro" |
|
||||
| **Product/Feature Search** | Looking for a specific feature or tool within a known brand | "Ahrefs keyword explorer", "Google Search Console coverage report" |
|
||||
| **Login/Access** | Trying to access an account or dashboard | "Ahrefs login", "Google Analytics sign in", "SEMrush dashboard" |
|
||||
| **Support/Docs** | Seeking help documentation for a known product | "Ahrefs API documentation", "Google Search Console help" |
|
||||
|
||||
#### Signal Words and Modifiers
|
||||
|
||||
**Strong navigational signals:**
|
||||
- [brand name] (standalone)
|
||||
- [brand name] login, sign in, sign up
|
||||
- [brand name] pricing, plans
|
||||
- [brand name] support, help, docs
|
||||
- [brand name] [feature name]
|
||||
- [brand name] download, app
|
||||
- official, website, site
|
||||
- [brand name] alternatives (borderline commercial)
|
||||
|
||||
#### SERP Feature Correlation
|
||||
|
||||
| SERP Feature | Frequency for Navigational | Notes |
|
||||
|-------------|---------------------------|-------|
|
||||
| Sitelinks | Very High | Brand queries almost always show sitelinks |
|
||||
| Knowledge Panel | High | For established brands with Google entity |
|
||||
| Featured Snippet | Low | Rarely for pure navigational |
|
||||
| People Also Ask | Medium | Often brand-related questions |
|
||||
| AI Overview | Low | AI usually defers to direct navigation |
|
||||
|
||||
#### Content Format Recommendations
|
||||
|
||||
| Sub-category | Best Formats | Key Elements |
|
||||
|-------------|-------------|-------------|
|
||||
| Brand Search | Homepage, about page, landing pages | Clear branding, value prop, navigation |
|
||||
| Product/Feature Search | Product pages, feature pages | Feature details, CTAs, screenshots |
|
||||
| Login/Access | Login page, getting started guide | Fast load, clear login form, password reset |
|
||||
| Support/Docs | Knowledge base, documentation hub | Search functionality, categorized articles |
|
||||
|
||||
---
|
||||
|
||||
### 3. Commercial Investigation Intent
|
||||
|
||||
The user is **researching before making a purchase decision**. They are comparing options, reading reviews, and evaluating alternatives.
|
||||
|
||||
#### Sub-categories
|
||||
|
||||
| Sub-category | Description | Example Queries |
|
||||
|-------------|------------|----------------|
|
||||
| **Comparison** | Evaluating two or more specific options | "Ahrefs vs SEMrush", "WordPress vs Squarespace for SEO" |
|
||||
| **Review-seeking** | Looking for opinions and evaluations | "Ahrefs review 2026", "best SEO tool reviews", "is Moz worth it" |
|
||||
| **Best-of Research** | Seeking curated top options in a category | "best SEO tools", "top keyword research tools", "best free backlink checkers" |
|
||||
| **Evaluation** | Assessing fit for a specific need | "SEO tools for small business", "enterprise SEO platform features", "SEO tool for agencies" |
|
||||
|
||||
#### Signal Words and Modifiers
|
||||
|
||||
**Strong commercial signals:**
|
||||
- best, top, leading
|
||||
- vs, versus, compared to, comparison
|
||||
- review, reviews, rating, ratings
|
||||
- alternative, alternatives to
|
||||
- like [brand], similar to
|
||||
- for [audience], for [use case]
|
||||
- pros and cons (when about products)
|
||||
- worth it, is [product] good
|
||||
- features, capabilities, integrations
|
||||
- pricing, cost, how much
|
||||
- free vs paid, premium
|
||||
|
||||
**Seasonal/temporal commercial signals:**
|
||||
- [product] [year] (e.g., "best SEO tools 2026")
|
||||
- new, latest, updated
|
||||
|
||||
#### SERP Feature Correlation
|
||||
|
||||
| SERP Feature | Frequency for Commercial | Notes |
|
||||
|-------------|------------------------|-------|
|
||||
| People Also Ask | Very High | Comparison and evaluation questions |
|
||||
| Featured Snippet | High | Especially for "best" and comparison queries |
|
||||
| AI Overview | High | AI often synthesizes comparisons |
|
||||
| Shopping Results | Medium | When products have direct purchase path |
|
||||
| Video Carousel | Medium | Review and comparison videos |
|
||||
| Ads (top) | Very High | Advertisers target commercial intent heavily |
|
||||
|
||||
#### Content Format Recommendations
|
||||
|
||||
| Sub-category | Best Formats | Target Length | Key Elements |
|
||||
|-------------|-------------|--------------|-------------|
|
||||
| Comparison | Side-by-side comparison pages, "X vs Y" articles | 2,500-4,000 words | Feature tables, pricing tables, verdict |
|
||||
| Review-seeking | In-depth reviews, user testimonials, case studies | 2,000-3,500 words | Honest pros/cons, screenshots, scoring |
|
||||
| Best-of Research | Ranked listicles, category roundups | 3,000-5,000 words | Criteria explanation, mini-reviews, comparison table |
|
||||
| Evaluation | Buying guides, use-case guides, ROI calculators | 2,000-3,500 words | Decision criteria, audience segmentation, recommendations |
|
||||
|
||||
---
|
||||
|
||||
### 4. Transactional Intent
|
||||
|
||||
The user wants to **complete a specific action**, typically a purchase, signup, or download.
|
||||
|
||||
#### Sub-categories
|
||||
|
||||
| Sub-category | Description | Example Queries |
|
||||
|-------------|------------|----------------|
|
||||
| **Purchase** | Ready to buy a product or service | "buy Ahrefs subscription", "SEMrush pricing plans", "order SEO audit" |
|
||||
| **Signup/Trial** | Ready to create an account or start a trial | "Ahrefs free trial", "sign up for Moz", "create Google Search Console account" |
|
||||
| **Download** | Wants to download software, template, or resource | "download Screaming Frog", "SEO checklist PDF download", "free keyword template" |
|
||||
| **Hire/Engage** | Ready to hire a professional or agency | "hire SEO consultant", "SEO agency near me", "freelance SEO expert" |
|
||||
|
||||
#### Signal Words and Modifiers
|
||||
|
||||
**Strong transactional signals:**
|
||||
- buy, purchase, order, subscribe
|
||||
- price, pricing, cost, discount, coupon, deal
|
||||
- free trial, demo, signup, sign up, register
|
||||
- download, install, get
|
||||
- hire, book, schedule, request quote
|
||||
- near me, in [location]
|
||||
- cheap, affordable, budget
|
||||
- premium, pro, enterprise
|
||||
- [product] discount code, [product] coupon
|
||||
|
||||
#### SERP Feature Correlation
|
||||
|
||||
| SERP Feature | Frequency for Transactional | Notes |
|
||||
|-------------|---------------------------|-------|
|
||||
| Shopping Results | Very High | Dominant for product purchase queries |
|
||||
| Ads (top + bottom) | Very High | Maximum ad coverage |
|
||||
| Local Pack | High | For service-based transactional queries |
|
||||
| Sitelinks | Medium | For brand-specific transactional |
|
||||
| Featured Snippet | Low | Rarely for pure transactional |
|
||||
| AI Overview | Low-Medium | Sometimes for pricing/comparison |
|
||||
|
||||
#### Content Format Recommendations
|
||||
|
||||
| Sub-category | Best Formats | Key Elements |
|
||||
|-------------|-------------|-------------|
|
||||
| Purchase | Product pages, pricing pages, checkout | Clear pricing, CTAs, trust signals, reviews |
|
||||
| Signup/Trial | Landing pages, signup forms, onboarding | Minimal friction, benefits, social proof |
|
||||
| Download | Resource landing pages, gated content | Preview, form, instant delivery |
|
||||
| Hire/Engage | Service pages, contact forms, portfolios | Credentials, case studies, clear next step |
|
||||
|
||||
---
|
||||
|
||||
## Intent Mapping to Conversion Funnel
|
||||
|
||||
### Full Funnel Alignment
|
||||
|
||||
```
|
||||
FUNNEL STAGE INTENT TYPE CONTENT GOAL
|
||||
─────────────────────────────────────────────────────────────
|
||||
Awareness → Informational Attract & educate
|
||||
(Educational, Exploratory)
|
||||
|
||||
Interest → Informational Deepen engagement
|
||||
(Instructional)
|
||||
|
||||
Consideration → Commercial Investigation Build preference
|
||||
(Best-of, Comparison)
|
||||
|
||||
Evaluation → Commercial Investigation Overcome objections
|
||||
(Review, Evaluation)
|
||||
|
||||
Decision → Transactional Convert
|
||||
(Purchase, Signup, Hire)
|
||||
|
||||
Retention → Navigational Support & retain
|
||||
(Support/Docs, Login)
|
||||
|
||||
Advocacy → Informational Enable sharing
|
||||
(Educational — about you)
|
||||
```
|
||||
|
||||
### Conversion Potential by Intent
|
||||
|
||||
| Intent Type | Avg. Conversion Rate | Typical CTA | Nurture Length |
|
||||
|------------|---------------------|-------------|---------------|
|
||||
| Informational | 0.5-2% | Newsletter signup, content download | Long (weeks-months) |
|
||||
| Navigational | N/A (already engaged) | Login, access feature | N/A |
|
||||
| Commercial Investigation | 2-5% | Free trial, demo request, comparison download | Medium (days-weeks) |
|
||||
| Transactional | 5-15% | Buy now, subscribe, hire | Short (immediate-days) |
|
||||
|
||||
---
|
||||
|
||||
## Mixed Intent Queries
|
||||
|
||||
Many real-world queries blend multiple intent types. Recognize and address the dominant + secondary intent.
|
||||
|
||||
### Common Mixed Intent Patterns
|
||||
|
||||
| Query Pattern | Primary Intent | Secondary Intent | Content Strategy |
|
||||
|--------------|---------------|-----------------|-----------------|
|
||||
| "best [product] for [use case]" | Commercial | Informational | Buying guide with educational context |
|
||||
| "how to [task] with [product]" | Instructional | Navigational | Tutorial featuring the product |
|
||||
| "[product] review and pricing" | Commercial | Transactional | Review with clear pricing CTAs |
|
||||
| "what is [concept] tools" | Informational | Commercial | Explainer that transitions to tool recommendations |
|
||||
| "[product] free download" | Transactional | Navigational | Landing page with download + product info |
|
||||
|
||||
### Handling Mixed Intent in Content
|
||||
|
||||
1. **Lead with the primary intent** -- answer the dominant question first
|
||||
2. **Bridge to the secondary intent** -- naturally transition to the secondary need
|
||||
3. **Match SERP format** -- if SERPs show mixed results, your content should too
|
||||
4. **Segment CTAs** -- provide different CTAs for different intent segments within the page
|
||||
|
||||
---
|
||||
|
||||
## SEO-Specific Keyword Intent Examples
|
||||
|
||||
### SEO Industry Keyword Classification
|
||||
|
||||
| Keyword | Intent | Sub-category | Recommended Content |
|
||||
|---------|--------|-------------|-------------------|
|
||||
| what is SEO | Informational | Educational | Definitive guide with visuals |
|
||||
| how to do keyword research | Informational | Instructional | Step-by-step tutorial |
|
||||
| best SEO tools 2026 | Commercial | Best-of Research | Ranked listicle with mini-reviews |
|
||||
| Ahrefs vs SEMrush | Commercial | Comparison | Side-by-side feature comparison |
|
||||
| buy Ahrefs subscription | Transactional | Purchase | Pricing/product page |
|
||||
| Google Search Console login | Navigational | Login/Access | Login page or redirect |
|
||||
| why is my site not indexing | Informational | Troubleshooting | Debug guide with solutions |
|
||||
| SEO agency for ecommerce | Transactional | Hire/Engage | Service page with portfolio |
|
||||
| is Moz worth it | Commercial | Review-seeking | Honest review with alternatives |
|
||||
| SEO checklist template | Transactional | Download | Gated resource landing page |
|
||||
| types of backlinks | Informational | Exploratory | Categorized explainer |
|
||||
| SEMrush pricing | Commercial | Evaluation | Pricing breakdown page |
|
||||
|
||||
---
|
||||
|
||||
## Applying Intent Taxonomy in Keyword Research
|
||||
|
||||
### Step-by-Step Classification Process
|
||||
|
||||
1. **Read the query literally** -- what is the user asking for?
|
||||
2. **Check for signal words** -- match against the signal word tables above
|
||||
3. **Verify against SERP** -- what does Google actually show? The SERP is the ground truth
|
||||
4. **Identify sub-category** -- narrow from primary intent to sub-category
|
||||
5. **Check for mixed intent** -- does the query blend two types?
|
||||
6. **Map to content format** -- select format based on intent + sub-category
|
||||
7. **Assign funnel stage** -- determine where this fits in the buyer journey
|
||||
8. **Set conversion expectation** -- align CTA and goals with intent type
|
||||
|
||||
### Common Classification Mistakes
|
||||
|
||||
| Mistake | Example | Why It's Wrong | Correct Classification |
|
||||
|---------|---------|---------------|----------------------|
|
||||
| Treating all "best" queries as informational | "best CRM software" | User is comparing products to buy | Commercial Investigation |
|
||||
| Treating all questions as informational | "how much does Ahrefs cost" | User is evaluating a purchase | Commercial / Transactional |
|
||||
| Ignoring local intent | "SEO services" | May have strong local intent in many contexts | Transactional (local) |
|
||||
| Missing navigational intent | "HubSpot blog" | User wants a specific page | Navigational |
|
||||
| Assuming single intent | "SEO tools" | Could be informational OR commercial | Mixed -- check SERP |
|
||||
|
|
@ -0,0 +1,41 @@
|
|||
# Keyword Prioritization Framework
|
||||
|
||||
Systematic scoring methodology for ranking keywords by strategic value.
|
||||
|
||||
## Relationship to Opportunity Score
|
||||
|
||||
**Which score to use**: Use the Priority Score (below) for initial keyword triage and shortlisting. Use the Opportunity Score (Step 6 in the main workflow) for final content calendar prioritization, where the additional GEO and competitive factors provide more nuanced ranking.
|
||||
|
||||
## Priority Scoring Matrix
|
||||
|
||||
Score each keyword 1-5 on these factors, then calculate weighted total:
|
||||
|
||||
| Factor | Weight | Score 1 (Low) | Score 5 (High) |
|
||||
|--------|--------|---------------|----------------|
|
||||
| Search Volume | 20% | <100/mo | >10,000/mo |
|
||||
| Keyword Difficulty | 25% | KD >80 (hard) | KD <20 (easy) |
|
||||
| Business Relevance | 30% | Tangential to offering | Core to offering |
|
||||
| Search Intent Match | 15% | Informational only | Transactional/commercial |
|
||||
| Trend Direction | 10% | Declining | Growing |
|
||||
|
||||
**Priority Score** = Σ(Factor Weight × Score) / 5
|
||||
|
||||
## Priority Categories
|
||||
|
||||
| Priority | Score Range | Action |
|
||||
|----------|------------|--------|
|
||||
| P0 — Must Target | 4.0-5.0 | Create content immediately |
|
||||
| P1 — High Value | 3.0-3.9 | Queue for next content sprint |
|
||||
| P2 — Opportunity | 2.0-2.9 | Plan for future content calendar |
|
||||
| P3 — Monitor | 1.0-1.9 | Track but don't prioritize |
|
||||
|
||||
## Seasonal Keyword Patterns
|
||||
|
||||
### Seasonal Analysis Framework
|
||||
|
||||
| Season Trigger | Example Keywords | Planning Lead Time | Content Strategy |
|
||||
|---------------|-----------------|-------------------|-----------------|
|
||||
| Calendar events | "Black Friday SEO", "New Year marketing plan" | 3-4 months ahead | Publish 6-8 weeks before peak |
|
||||
| Industry events | "[Conference] takeaways", "Google algorithm update" | 1-2 months / reactive | Pre-plan templates, react quickly |
|
||||
| Budget cycles | "marketing budget template Q1", "SEO ROI report" | 2-3 months ahead | Target planning season (Oct-Dec) |
|
||||
| Seasonal demand | "summer marketing ideas", "holiday email campaigns" | 2-3 months ahead | Refresh annually with new data |
|
||||
|
|
@ -0,0 +1,286 @@
|
|||
# Topic Cluster Templates
|
||||
|
||||
Planning worksheets, architecture patterns, and measurement frameworks for building topic clusters that establish topical authority and drive organic traffic.
|
||||
|
||||
## Overview
|
||||
|
||||
A topic cluster is a group of interlinked content pieces organized around a central pillar page. The pillar covers a broad topic comprehensively, while cluster pages dive deep into specific subtopics. Internal links bind the cluster together, signaling topical authority to search engines and AI systems.
|
||||
|
||||
---
|
||||
|
||||
## Topic Cluster Planning Worksheet
|
||||
|
||||
### Step 1: Define the Pillar Topic
|
||||
|
||||
Use this template to evaluate whether a topic deserves a full cluster:
|
||||
|
||||
| Field | Your Input |
|
||||
|-------|-----------|
|
||||
| **Pillar Topic** | [Broad topic name] |
|
||||
| **Pillar Keyword** | [Head keyword, typically 1-3 words] |
|
||||
| **Monthly Search Volume** | [Volume] |
|
||||
| **Keyword Difficulty** | [KD score] |
|
||||
| **Business Relevance** | [1-5 scale: how core is this to your product/service?] |
|
||||
| **Current Ranking** | [Your current position, or "Not ranking"] |
|
||||
| **Competitor Coverage** | [How many competitors have pillar content on this?] |
|
||||
| **Estimated Cluster Size** | [How many subtopics can you identify?] |
|
||||
| **Content Assets Available** | [Existing content you can repurpose or link] |
|
||||
|
||||
**Pillar viability checklist:**
|
||||
- [ ] At least 8-12 subtopics can be identified
|
||||
- [ ] Combined cluster keyword volume exceeds 5,000/month
|
||||
- [ ] Topic is directly relevant to your product or service
|
||||
- [ ] You can provide unique expertise or data on this topic
|
||||
- [ ] Competitors have not yet built a dominant cluster
|
||||
|
||||
### Step 2: Map Cluster Subtopics
|
||||
|
||||
| # | Subtopic | Target Keyword | Volume | KD | Intent | Content Format | Status |
|
||||
|---|---------|---------------|--------|-----|--------|---------------|--------|
|
||||
| 1 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 2 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 3 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 4 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 5 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 6 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 7 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
| 8 | [Subtopic name] | [Long-tail keyword] | [Vol] | [KD] | [I/N/C/T] | [Guide/Tutorial/List/etc.] | [Idea/Draft/Published] |
|
||||
|
||||
### Step 3: Define Internal Linking Map
|
||||
|
||||
| Source Page | Links To | Anchor Text Strategy |
|
||||
|------------|---------|---------------------|
|
||||
| Pillar | Cluster 1, 2, 3... (all) | Descriptive, keyword-relevant anchors |
|
||||
| Cluster 1 | Pillar + Cluster 2, 3 | Natural contextual links |
|
||||
| Cluster 2 | Pillar + Cluster 1, 4 | Natural contextual links |
|
||||
| Cluster 3 | Pillar + Cluster 1 | Natural contextual links |
|
||||
|
||||
**Linking rules:**
|
||||
- Every cluster page MUST link to the pillar page
|
||||
- The pillar page MUST link to every cluster page
|
||||
- Cluster pages SHOULD link to 2-3 related cluster pages where contextually relevant
|
||||
- Use descriptive anchor text (not "click here" or bare URLs)
|
||||
- Link placement should be within body content, not just in a footer list
|
||||
|
||||
---
|
||||
|
||||
## Hub-and-Spoke Architecture Patterns
|
||||
|
||||
### Pattern 1: Classic Hub-Spoke (Best for Educational Topics)
|
||||
|
||||
```
|
||||
┌──────────────────┐
|
||||
┌────│ What is [Topic]? │
|
||||
│ └──────────────────┘
|
||||
│ ┌──────────────────┐
|
||||
├────│ [Topic] Benefits │
|
||||
│ └──────────────────┘
|
||||
┌───────────────┐ │ ┌──────────────────┐
|
||||
│ PILLAR: │───┼────│ [Topic] Examples │
|
||||
│ Complete │ │ └──────────────────┘
|
||||
│ Guide to │ │ ┌──────────────────┐
|
||||
│ [Topic] │ ├────│ [Topic] Tools │
|
||||
└───────────────┘ │ └──────────────────┘
|
||||
│ ┌──────────────────┐
|
||||
├────│ [Topic] Mistakes │
|
||||
│ └──────────────────┘
|
||||
│ ┌──────────────────┐
|
||||
└────│ [Topic] Checklist │
|
||||
└──────────────────┘
|
||||
```
|
||||
|
||||
**Best for:** Broad educational topics where subtopics don't overlap much.
|
||||
**Example:** "Content Marketing" pillar with spokes for strategy, types, examples, tools, metrics, mistakes.
|
||||
|
||||
### Pattern 2: Layered Cluster (Best for Technical Topics)
|
||||
|
||||
```
|
||||
┌─────────────────────────────┐
|
||||
┌────│ BEGINNER CLUSTER │
|
||||
│ │ - Getting Started │
|
||||
│ │ - Basic Concepts │
|
||||
│ │ - First Steps Tutorial │
|
||||
│ └─────────────────────────────┘
|
||||
┌──────────┐ │ ┌─────────────────────────────┐
|
||||
│ PILLAR: │───┼────│ INTERMEDIATE CLUSTER │
|
||||
│ Complete │ │ │ - Advanced Techniques │
|
||||
│ Guide │ │ │ - Common Patterns │
|
||||
└──────────┘ │ │ - Optimization Strategies │
|
||||
│ └─────────────────────────────┘
|
||||
│ ┌─────────────────────────────┐
|
||||
└────│ ADVANCED CLUSTER │
|
||||
│ - Expert Strategies │
|
||||
│ - Edge Cases │
|
||||
│ - Integration Guides │
|
||||
└─────────────────────────────┘
|
||||
```
|
||||
|
||||
**Best for:** Topics with clear skill progressions (programming, technical SEO, data analysis).
|
||||
**Example:** "Technical SEO" pillar with beginner (crawling basics), intermediate (JavaScript rendering), advanced (log file analysis) layers.
|
||||
|
||||
### Pattern 3: Use-Case Cluster (Best for Product/Service Topics)
|
||||
|
||||
```
|
||||
┌──────────────────────┐
|
||||
┌────│ [Topic] for SMBs │
|
||||
│ └──────────────────────┘
|
||||
│ ┌──────────────────────┐
|
||||
┌──────────┐ ├────│ [Topic] for Enterprise│
|
||||
│ PILLAR: │───┤ └──────────────────────┘
|
||||
│ [Topic] │ │ ┌──────────────────────┐
|
||||
│ Guide │ ├────│ [Topic] for Agencies │
|
||||
└──────────┘ │ └──────────────────────┘
|
||||
│ ┌──────────────────────┐
|
||||
├────│ [Topic] for Ecommerce │
|
||||
│ └──────────────────────┘
|
||||
│ ┌──────────────────────┐
|
||||
└────│ [Topic] for SaaS │
|
||||
└──────────────────────┘
|
||||
```
|
||||
|
||||
**Best for:** Products/services with distinct audience segments.
|
||||
**Example:** "SEO Strategy" pillar with spokes for different business types (ecommerce SEO, SaaS SEO, local SEO, B2B SEO).
|
||||
|
||||
### Pattern 4: Process Cluster (Best for How-To Topics)
|
||||
|
||||
```
|
||||
┌──────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||||
│ PILLAR: │────→│ Step 1: │────→│ Step 2: │────→│ Step 3: │────→│ Step 4: │
|
||||
│ How to │ │ Research │ │ Plan │ │ Execute │ │ Measure │
|
||||
│ [Process]│ └─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||||
└──────────┘ │ │ │ │
|
||||
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
|
||||
│Sub-guide │ │Template │ │Tutorial │ │Dashboard │
|
||||
│ 1a │ │ 2a │ │ 3a │ │ Guide │
|
||||
└─────────┘ └─────────┘ └─────────┘ └─────────┘
|
||||
```
|
||||
|
||||
**Best for:** Multi-step processes where each step is complex enough for its own article.
|
||||
**Example:** "Link Building" pillar with sequential steps (prospecting, outreach, content creation, tracking).
|
||||
|
||||
---
|
||||
|
||||
## Internal Linking Patterns Within Clusters
|
||||
|
||||
### Linking Density Guidelines
|
||||
|
||||
| Cluster Size | Min Links Per Cluster Page | Max Links Per Cluster Page | Pillar Link Density |
|
||||
|-------------|--------------------------|--------------------------|-------------------|
|
||||
| 5-8 pages | 2-3 internal links | 5-6 internal links | Link to every cluster page |
|
||||
| 9-15 pages | 3-4 internal links | 6-8 internal links | Link to every cluster page |
|
||||
| 16+ pages | 4-5 internal links | 8-10 internal links | Link to top cluster pages, categorize rest |
|
||||
|
||||
### Anchor Text Strategy
|
||||
|
||||
| Link Type | Anchor Text Approach | Example |
|
||||
|-----------|---------------------|---------|
|
||||
| Cluster → Pillar | Broad keyword or branded | "our complete guide to keyword research" |
|
||||
| Pillar → Cluster | Specific keyword for that cluster page | "learn about long-tail keyword strategies" |
|
||||
| Cluster → Cluster | Contextual, conversational | "this connects to how you assess keyword difficulty" |
|
||||
|
||||
### Linking Anti-Patterns to Avoid
|
||||
|
||||
| Anti-Pattern | Why It's Bad | Fix |
|
||||
|-------------|-------------|-----|
|
||||
| Footer-only links to cluster pages | Low link equity, poor UX | Move links into body content |
|
||||
| Generic anchors ("click here", "read more") | No keyword signal | Use descriptive, keyword-relevant anchors |
|
||||
| Orphan cluster pages (no inbound links) | Search engines can't discover/value them | Add contextual links from pillar and related clusters |
|
||||
| Over-linking (20+ internal links per page) | Dilutes link equity, feels spammy | Keep to 5-10 relevant internal links |
|
||||
| Linking only to pillar (ignoring sibling clusters) | Misses cross-cluster relevance | Link to 2-3 related sibling pages |
|
||||
|
||||
---
|
||||
|
||||
## Content Calendar Integration
|
||||
|
||||
### Cluster Build Sequence
|
||||
|
||||
The order you publish cluster content matters. Follow this sequence for maximum impact:
|
||||
|
||||
| Phase | What to Publish | Why This Order |
|
||||
|-------|----------------|---------------|
|
||||
| **Phase 1: Pillar** | Publish the pillar page first | Establishes the hub; cluster pages need something to link to |
|
||||
| **Phase 2: Quick-win clusters** | Publish 3-4 lowest-difficulty cluster pages | Build early traffic and indexing momentum |
|
||||
| **Phase 3: High-value clusters** | Publish highest-volume cluster pages | Leverage pillar authority for competitive terms |
|
||||
| **Phase 4: Long-tail clusters** | Publish remaining niche subtopics | Fill coverage gaps, capture long-tail traffic |
|
||||
| **Phase 5: Update cycle** | Refresh pillar with new links; update outdated clusters | Maintain freshness signals |
|
||||
|
||||
### Sample Content Calendar for One Cluster
|
||||
|
||||
| Week | Content Piece | Type | Target Keyword | Word Count | Dependencies |
|
||||
|------|--------------|------|---------------|-----------|-------------|
|
||||
| 1 | Complete Guide to [Pillar Topic] | Pillar | [Head keyword] | 3,500-5,000 | None |
|
||||
| 2 | What is [Subtopic A]? | Cluster | [Long-tail A] | 1,500-2,000 | Pillar published |
|
||||
| 3 | How to [Subtopic B] | Cluster | [Long-tail B] | 2,000-2,500 | Pillar published |
|
||||
| 4 | [Subtopic C] vs [Subtopic D] | Cluster | [Long-tail C] | 2,000-2,500 | Pillar published |
|
||||
| 5 | Best [Subtopic E] Tools | Cluster | [Long-tail E] | 2,500-3,000 | Pillar published |
|
||||
| 6 | [Subtopic F] for Beginners | Cluster | [Long-tail F] | 1,500-2,000 | Pillar published |
|
||||
| 7 | [Subtopic G] Checklist | Cluster | [Long-tail G] | 1,000-1,500 | Pillar published |
|
||||
| 8 | Update Pillar + add all internal links | Update | -- | -- | All clusters published |
|
||||
|
||||
### Publishing Cadence Recommendations
|
||||
|
||||
| Team Size | Cluster Build Time | Recommended Cadence |
|
||||
|-----------|-------------------|-------------------|
|
||||
| Solo content creator | 6-8 weeks per cluster | 1 cluster per quarter |
|
||||
| Small team (2-3 writers) | 3-4 weeks per cluster | 1 cluster per month |
|
||||
| Content team (4-6 writers) | 2-3 weeks per cluster | 2 clusters per month |
|
||||
| Large team (7+ writers) | 1-2 weeks per cluster | 1 cluster per week |
|
||||
|
||||
---
|
||||
|
||||
## Cluster Performance Measurement Framework
|
||||
|
||||
### Key Metrics by Level
|
||||
|
||||
#### Cluster-Level Metrics
|
||||
|
||||
| Metric | What It Measures | Target | How to Track |
|
||||
|--------|-----------------|--------|-------------|
|
||||
| Total cluster traffic | Aggregate organic visits to all pages in cluster | Growing month-over-month | Analytics: filter by URL folder/tag |
|
||||
| Keyword coverage | Number of keywords cluster ranks for | 50+ keywords per mature cluster | SEO tool: filter by cluster URLs |
|
||||
| Average position | Mean ranking across all cluster keywords | Improving trend toward top 10 | SEO tool: average position report |
|
||||
| Internal link equity | PageRank flow within cluster | Pillar has highest internal links | Site audit tool: internal link report |
|
||||
| Cluster completeness | Percentage of planned subtopics published | 100% within planned timeframe | Content calendar tracking |
|
||||
|
||||
#### Page-Level Metrics (Per Cluster Page)
|
||||
|
||||
| Metric | Pillar Target | Cluster Page Target |
|
||||
|--------|-------------|-------------------|
|
||||
| Organic traffic | Highest in cluster | Proportional to keyword volume |
|
||||
| Keywords ranking | 50-200+ | 10-50 |
|
||||
| Backlinks | Attracts most links | Some organic links |
|
||||
| Avg. time on page | 4-8 minutes | 2-5 minutes |
|
||||
| Bounce rate | <60% | <70% |
|
||||
| Internal CTR | High clicks to cluster pages | Clicks to pillar + sibling pages |
|
||||
|
||||
### Performance Review Cadence
|
||||
|
||||
| Timeframe | What to Review | Action If Underperforming |
|
||||
|-----------|---------------|--------------------------|
|
||||
| 2 weeks post-publish | Indexing status, initial impressions | Fix indexing issues, check for crawl errors |
|
||||
| 1 month post-publish | Early ranking signals, traffic | Optimize titles/metas, add internal links |
|
||||
| 3 months post-publish | Ranking positions, traffic trends | Content refresh, add missing subtopics, build links |
|
||||
| 6 months post-publish | Full performance assessment | Major content update or strategic pivot |
|
||||
| Quarterly (ongoing) | Cluster-level aggregate trends | Identify declining pages, plan refreshes |
|
||||
|
||||
### Cluster Health Scorecard
|
||||
|
||||
Rate each cluster quarterly on these dimensions:
|
||||
|
||||
| Dimension | Score 1 (Poor) | Score 3 (Average) | Score 5 (Excellent) |
|
||||
|-----------|---------------|-------------------|-------------------|
|
||||
| Traffic growth | Declining | Flat | Growing 10%+ MoM |
|
||||
| Keyword coverage | <20 keywords | 20-50 keywords | 50+ keywords |
|
||||
| Top 10 rankings | 0 keywords in top 10 | 1-5 in top 10 | 5+ in top 10 |
|
||||
| Content freshness | Not updated in 12+ months | Updated within 6 months | Updated within 3 months |
|
||||
| Internal linking | Missing links, orphan pages | Basic linking in place | Full cross-linking with relevant anchors |
|
||||
| Completeness | <50% of subtopics covered | 50-80% covered | 80-100% covered |
|
||||
|
||||
**Cluster Health Score** = Average of all dimension scores
|
||||
|
||||
| Score Range | Health Status | Action |
|
||||
|------------|--------------|--------|
|
||||
| 4.0-5.0 | Healthy | Maintain cadence, expand to adjacent clusters |
|
||||
| 3.0-3.9 | Needs attention | Refresh outdated content, fill subtopic gaps |
|
||||
| 2.0-2.9 | At risk | Major content update, link building campaign |
|
||||
| 1.0-1.9 | Failing | Strategic review -- consider merging, rewriting, or retiring |
|
||||
Loading…
Add table
Add a link
Reference in a new issue