mirror of
https://github.com/MODSetter/SurfSense.git
synced 2026-04-30 19:36:25 +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
|
|
@ -0,0 +1,285 @@
|
|||
# Competitor Analysis — Analysis Templates
|
||||
|
||||
Templates for each step of the competitor analysis workflow. Use these to structure your output.
|
||||
|
||||
## Competitor Profile Template
|
||||
|
||||
```markdown
|
||||
## Competitor Profile: [Name]
|
||||
|
||||
**Basic Info**
|
||||
- URL: [website]
|
||||
- Domain Age: [years]
|
||||
- Estimated Traffic: [monthly visits]
|
||||
- Domain Authority/Rating: [score]
|
||||
|
||||
**Business Model**
|
||||
- Type: [SaaS/E-commerce/Content/etc.]
|
||||
- Target Audience: [description]
|
||||
- Key Offerings: [products/services]
|
||||
```
|
||||
|
||||
## Keyword Analysis Template
|
||||
|
||||
```markdown
|
||||
### Keyword Analysis: [Competitor]
|
||||
|
||||
**Total Keywords Ranking**: [X]
|
||||
**Keywords in Top 10**: [X]
|
||||
**Keywords in Top 3**: [X]
|
||||
|
||||
#### Top Performing Keywords
|
||||
|
||||
| Keyword | Position | Volume | Traffic Est. | Page |
|
||||
|---------|----------|--------|--------------|------|
|
||||
| [kw 1] | [pos] | [vol] | [traffic] | [url] |
|
||||
| [kw 2] | [pos] | [vol] | [traffic] | [url] |
|
||||
|
||||
#### Keyword Distribution by Intent
|
||||
|
||||
- Informational: [X]% ([keywords])
|
||||
- Commercial: [X]% ([keywords])
|
||||
- Transactional: [X]% ([keywords])
|
||||
- Navigational: [X]% ([keywords])
|
||||
|
||||
#### Keyword Gaps (They rank, you don't)
|
||||
|
||||
| Keyword | Their Position | Volume | Opportunity |
|
||||
|---------|----------------|--------|-------------|
|
||||
| [kw 1] | [pos] | [vol] | [analysis] |
|
||||
```
|
||||
|
||||
## Content Analysis Template
|
||||
|
||||
```markdown
|
||||
### Content Analysis: [Competitor]
|
||||
|
||||
**Content Volume**
|
||||
- Total Pages: [X]
|
||||
- Blog Posts: [X]
|
||||
- Landing Pages: [X]
|
||||
- Resource Pages: [X]
|
||||
|
||||
**Content Performance**
|
||||
|
||||
#### Top Performing Content
|
||||
|
||||
| Title | URL | Est. Traffic | Keywords | Backlinks |
|
||||
|-------|-----|--------------|----------|-----------|
|
||||
| [title 1] | [url] | [traffic] | [X] | [X] |
|
||||
|
||||
**Content Patterns**
|
||||
|
||||
- Average word count: [X] words
|
||||
- Publishing frequency: [X] posts/month
|
||||
- Content formats used:
|
||||
- Blog posts: [X]%
|
||||
- Guides/tutorials: [X]%
|
||||
- Case studies: [X]%
|
||||
- Tools/calculators: [X]%
|
||||
- Videos: [X]%
|
||||
|
||||
**Content Themes**
|
||||
|
||||
| Theme | # Articles | Combined Traffic |
|
||||
|-------|------------|------------------|
|
||||
| [theme 1] | [X] | [traffic] |
|
||||
| [theme 2] | [X] | [traffic] |
|
||||
|
||||
**What Makes Their Content Successful**
|
||||
|
||||
1. [Success factor 1 with example]
|
||||
2. [Success factor 2 with example]
|
||||
3. [Success factor 3 with example]
|
||||
```
|
||||
|
||||
## Backlink Analysis Template
|
||||
|
||||
```markdown
|
||||
### Backlink Analysis: [Competitor]
|
||||
|
||||
**Overview**
|
||||
- Total Backlinks: [X]
|
||||
- Referring Domains: [X]
|
||||
- Domain Rating: [X]
|
||||
|
||||
**Link Quality Distribution**
|
||||
- High Authority (DR 70+): [X]%
|
||||
- Medium Authority (DR 30-69): [X]%
|
||||
- Low Authority (DR <30): [X]%
|
||||
|
||||
**Top Linking Domains**
|
||||
|
||||
| Domain | DR | Link Type | Target Page |
|
||||
|--------|-----|-----------|-------------|
|
||||
| [domain 1] | [DR] | [type] | [page] |
|
||||
|
||||
**Link Acquisition Patterns**
|
||||
|
||||
- Guest posts: [X]%
|
||||
- Editorial/organic: [X]%
|
||||
- Resource pages: [X]%
|
||||
- Directories: [X]%
|
||||
- Other: [X]%
|
||||
|
||||
**Linkable Assets (Content attracting links)**
|
||||
|
||||
| Asset | Type | Backlinks | Why It Works |
|
||||
|-------|------|-----------|--------------|
|
||||
| [asset 1] | [type] | [X] | [reason] |
|
||||
```
|
||||
|
||||
## Technical SEO Assessment Template
|
||||
|
||||
```markdown
|
||||
### Technical Analysis: [Competitor]
|
||||
|
||||
**Site Performance**
|
||||
- Core Web Vitals: [Pass/Fail]
|
||||
- LCP: [X]s
|
||||
- FID: [X]ms
|
||||
- CLS: [X]
|
||||
- Mobile-friendly: [Yes/No]
|
||||
|
||||
**Site Structure**
|
||||
- Site architecture depth: [X] levels
|
||||
- Internal linking quality: [Rating]
|
||||
- URL structure: [Clean/Messy]
|
||||
- Sitemap present: [Yes/No]
|
||||
|
||||
**Technical Strengths**
|
||||
1. [Strength 1]
|
||||
2. [Strength 2]
|
||||
|
||||
**Technical Weaknesses**
|
||||
1. [Weakness 1]
|
||||
2. [Weakness 2]
|
||||
```
|
||||
|
||||
## GEO/AI Citation Analysis Template
|
||||
|
||||
```markdown
|
||||
### GEO Analysis: [Competitor]
|
||||
|
||||
**AI Visibility Assessment**
|
||||
|
||||
Test competitor content in AI systems for relevant queries:
|
||||
|
||||
| Query | AI Mentions Competitor? | What's Cited | Why |
|
||||
|-------|------------------------|--------------|-----|
|
||||
| [query 1] | Yes/No | [content] | [reason] |
|
||||
| [query 2] | Yes/No | [content] | [reason] |
|
||||
|
||||
**GEO Strategies Observed**
|
||||
|
||||
1. **Clear Definitions**
|
||||
- Example: [quote from their content]
|
||||
- Effectiveness: [rating]
|
||||
|
||||
2. **Quotable Statistics**
|
||||
- Example: [quote from their content]
|
||||
- Effectiveness: [rating]
|
||||
|
||||
3. **Q&A Format Content**
|
||||
- Examples found: [X] pages
|
||||
- Topics covered: [list]
|
||||
|
||||
4. **Authority Signals**
|
||||
- Expert authorship: [Yes/No]
|
||||
- Citations to sources: [Yes/No]
|
||||
- Original research: [Yes/No]
|
||||
|
||||
**GEO Opportunities They're Missing**
|
||||
|
||||
| Topic | Why Missing | Your Opportunity |
|
||||
|-------|-------------|------------------|
|
||||
| [topic 1] | [reason] | [action] |
|
||||
```
|
||||
|
||||
## Synthesis Report Template
|
||||
|
||||
```markdown
|
||||
# Competitive Analysis Report
|
||||
|
||||
**Analysis Date**: [Date]
|
||||
**Competitors Analyzed**: [List]
|
||||
**Your Site**: [URL]
|
||||
|
||||
## Executive Summary
|
||||
|
||||
[2-3 paragraph overview of key findings and recommendations]
|
||||
|
||||
## Competitive Landscape
|
||||
|
||||
| Metric | You | Competitor 1 | Competitor 2 | Competitor 3 |
|
||||
|--------|-----|--------------|--------------|--------------|
|
||||
| Domain Authority | [X] | [X] | [X] | [X] |
|
||||
| Organic Traffic | [X] | [X] | [X] | [X] |
|
||||
| Keywords Top 10 | [X] | [X] | [X] | [X] |
|
||||
| Backlinks | [X] | [X] | [X] | [X] |
|
||||
| Content Pages | [X] | [X] | [X] | [X] |
|
||||
|
||||
**Domain Authority Comparison (Recommended)**
|
||||
|
||||
When domain-level comparison is needed, run `domain-authority-auditor` for each competitor to get CITE scores:
|
||||
|
||||
| Domain | CITE Score | C (Citation) | I (Identity) | T (Trust) | E (Eminence) | Veto |
|
||||
|--------|-----------|-------------|-------------|----------|-------------|------|
|
||||
| Your domain | [score] | [score] | [score] | [score] | [score] | [pass/fail] |
|
||||
| Competitor 1 | [score] | [score] | [score] | [score] | [score] | [pass/fail] |
|
||||
| Competitor 2 | [score] | [score] | [score] | [score] | [score] | [pass/fail] |
|
||||
|
||||
This reveals domain authority gaps that inform link building and brand strategy beyond keyword-level competition.
|
||||
|
||||
## Competitor Strengths to Learn From
|
||||
|
||||
### [Competitor 1]
|
||||
- **Strength**: [description]
|
||||
- **Why It Works**: [analysis]
|
||||
- **How to Apply**: [action item]
|
||||
|
||||
[Repeat for each competitor]
|
||||
|
||||
## Competitor Weaknesses to Exploit
|
||||
|
||||
### Gap 1: [Description]
|
||||
- Who's weak: [competitors]
|
||||
- Opportunity size: [estimate]
|
||||
- Recommended action: [specific steps]
|
||||
|
||||
[Repeat for each gap]
|
||||
|
||||
## Keyword Opportunities
|
||||
|
||||
### Keywords to Target (Competitor overlap)
|
||||
| Keyword | Volume | Avg Position | Best Strategy |
|
||||
|---------|--------|--------------|---------------|
|
||||
| [kw] | [vol] | [pos] | [strategy] |
|
||||
|
||||
### Untapped Keywords (No competitor coverage)
|
||||
| Keyword | Volume | Difficulty | Opportunity |
|
||||
|---------|--------|------------|-------------|
|
||||
| [kw] | [vol] | [diff] | [description] |
|
||||
|
||||
## Content Strategy Recommendations
|
||||
|
||||
Based on competitor analysis:
|
||||
|
||||
1. **Create**: [Content type] about [topic] because [reason]
|
||||
2. **Improve**: [Existing content] to match/exceed [competitor content]
|
||||
3. **Promote**: [Content] to sites like [competitor's link sources]
|
||||
|
||||
## Action Plan
|
||||
|
||||
### Immediate (This Week)
|
||||
1. [Action item]
|
||||
2. [Action item]
|
||||
|
||||
### Short-term (This Month)
|
||||
1. [Action item]
|
||||
2. [Action item]
|
||||
|
||||
### Long-term (This Quarter)
|
||||
1. [Action item]
|
||||
2. [Action item]
|
||||
```
|
||||
|
|
@ -0,0 +1,256 @@
|
|||
# Competitive Battlecard Template
|
||||
|
||||
A fill-in-the-blank template for creating competitive battlecards that equip sales, marketing, and content teams with actionable intelligence. Maintain one battlecard per major competitor and review quarterly.
|
||||
|
||||
## Overview
|
||||
|
||||
A competitive battlecard is a concise reference document that summarizes a competitor's strengths, weaknesses, positioning, and how to compete against them. Battlecards are living documents that should be updated as competitors evolve.
|
||||
|
||||
**Audience:** Sales teams, content strategists, marketing leadership
|
||||
**Update frequency:** Quarterly review minimum; update immediately on major competitor changes
|
||||
**Length target:** 2-3 pages per competitor (scannable, not exhaustive)
|
||||
|
||||
---
|
||||
|
||||
## Battlecard Template
|
||||
|
||||
### Header
|
||||
|
||||
```
|
||||
COMPETITIVE BATTLECARD: [Competitor Name]
|
||||
Last Updated: [Date]
|
||||
Updated By: [Name/Team]
|
||||
Confidence Level: [High/Medium/Low] — based on data recency and source quality
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Section 1: Competitor Overview
|
||||
|
||||
| Field | Details |
|
||||
|-------|---------|
|
||||
| **Company Name** | [Name] |
|
||||
| **Website** | [URL] |
|
||||
| **Founded** | [Year] |
|
||||
| **Headquarters** | [Location] |
|
||||
| **Company Size** | [Employees] |
|
||||
| **Funding/Revenue** | [Known funding rounds or estimated revenue] |
|
||||
| **Target Customer** | [Primary audience: SMB, mid-market, enterprise, etc.] |
|
||||
| **Pricing Model** | [Freemium, subscription, usage-based, custom, etc.] |
|
||||
| **Pricing Range** | [Entry price → Enterprise price] |
|
||||
|
||||
**One-Sentence Summary:**
|
||||
> [Competitor] is a [category] that helps [target audience] to [primary benefit] by [mechanism].
|
||||
|
||||
---
|
||||
|
||||
### Section 2: Their Pitch
|
||||
|
||||
**Tagline/Slogan:**
|
||||
> [Their exact tagline from website]
|
||||
|
||||
**Top 3 Claimed Differentiators:**
|
||||
1. [Differentiator 1 — their claim, not your assessment]
|
||||
2. [Differentiator 2]
|
||||
3. [Differentiator 3]
|
||||
|
||||
**Positioning Statement (Reverse-Engineered):**
|
||||
> For [their target audience], [product] is the [category] that [key benefit] because [reason to believe].
|
||||
|
||||
**Key Messages They Repeat:**
|
||||
- [Message 1 — found in blog, ads, sales decks]
|
||||
- [Message 2]
|
||||
- [Message 3]
|
||||
|
||||
---
|
||||
|
||||
### Section 3: Strengths (Be Honest)
|
||||
|
||||
Credibility depends on honestly assessing where competitors are genuinely strong. Sugarcoating weaknesses or ignoring strengths reduces trust in the battlecard.
|
||||
|
||||
| Strength | Evidence | Impact on Deals |
|
||||
|----------|---------|----------------|
|
||||
| [Strength 1] | [Where you observed this — reviews, demos, customer feedback] | [How this affects your competitive win rate] |
|
||||
| [Strength 2] | [Evidence] | [Impact] |
|
||||
| [Strength 3] | [Evidence] | [Impact] |
|
||||
|
||||
---
|
||||
|
||||
### Section 4: Weaknesses
|
||||
|
||||
| Weakness | Evidence | How to Exploit |
|
||||
|----------|---------|---------------|
|
||||
| [Weakness 1] | [Sources: G2 reviews, customer complaints, technical limitations] | [Talking point or demo moment that highlights this gap] |
|
||||
| [Weakness 2] | [Evidence] | [How to exploit] |
|
||||
| [Weakness 3] | [Evidence] | [How to exploit] |
|
||||
|
||||
**Common Complaints (from review sites):**
|
||||
- "[Exact quote from G2/Capterra/TrustRadius]" — [Source, Date]
|
||||
- "[Exact quote]" — [Source, Date]
|
||||
- "[Exact quote]" — [Source, Date]
|
||||
|
||||
---
|
||||
|
||||
### Section 5: Your Differentiators
|
||||
|
||||
For each differentiator, provide the claim AND the proof. Unsupported claims erode credibility.
|
||||
|
||||
| Differentiator | Your Advantage | Proof Point | How to Demo/Show |
|
||||
|---------------|---------------|------------|-----------------|
|
||||
| [Differentiator 1] | [What you do better] | [Data, testimonial, or demo evidence] | [Specific demo step or slide] |
|
||||
| [Differentiator 2] | [What you do better] | [Proof] | [How to show] |
|
||||
| [Differentiator 3] | [What you do better] | [Proof] | [How to show] |
|
||||
|
||||
---
|
||||
|
||||
### Section 6: Feature Comparison
|
||||
|
||||
| Feature/Capability | You | [Competitor] | Notes |
|
||||
|-------------------|-----|-------------|-------|
|
||||
| [Feature 1] | [Yes/No/Partial + detail] | [Yes/No/Partial + detail] | [Context] |
|
||||
| [Feature 2] | [Yes/No/Partial] | [Yes/No/Partial] | [Context] |
|
||||
| [Feature 3] | [Yes/No/Partial] | [Yes/No/Partial] | [Context] |
|
||||
| [Feature 4] | [Yes/No/Partial] | [Yes/No/Partial] | [Context] |
|
||||
| [Feature 5] | [Yes/No/Partial] | [Yes/No/Partial] | [Context] |
|
||||
| [Integration A] | [Yes/No] | [Yes/No] | [Context] |
|
||||
| [Integration B] | [Yes/No] | [Yes/No] | [Context] |
|
||||
|
||||
---
|
||||
|
||||
### Section 7: Pricing Comparison
|
||||
|
||||
| Tier | You | [Competitor] | Advantage |
|
||||
|------|-----|-------------|-----------|
|
||||
| Entry/Free | [Price + what's included] | [Price + what's included] | [Who wins at this tier and why] |
|
||||
| Mid-tier | [Price + what's included] | [Price + what's included] | [Who wins] |
|
||||
| Enterprise | [Price + what's included] | [Price + what's included] | [Who wins] |
|
||||
|
||||
**Hidden Costs to Highlight:**
|
||||
- [Competitor charges extra for X, which you include]
|
||||
- [Competitor requires Y add-on for common use case]
|
||||
- [Competitor's pricing scales poorly because Z]
|
||||
|
||||
---
|
||||
|
||||
### Section 8: Objection Handling
|
||||
|
||||
| When They Say... | You Respond With... | Supporting Evidence |
|
||||
|-----------------|--------------------|--------------------|
|
||||
| "[Competitor] has more features" | "[Your response — focus on outcomes, not feature count]" | [Case study, data point, or demo] |
|
||||
| "[Competitor] is cheaper" | "[Your response — focus on total value, ROI, or hidden costs]" | [TCO comparison, customer quote] |
|
||||
| "[Competitor] is more established" | "[Your response — focus on innovation, agility, or support quality]" | [Growth metrics, customer satisfaction data] |
|
||||
| "We're already using [Competitor]" | "[Your response — focus on switching ease, quick wins, or pain points]" | [Migration case study, time-to-value data] |
|
||||
| "[Competitor] integrates with [tool]" | "[Your response — confirm your integration or alternative]" | [Integration docs, workaround, or roadmap] |
|
||||
|
||||
---
|
||||
|
||||
### Section 9: Landmine Questions
|
||||
|
||||
Questions to ask prospects early in the sales process that highlight your advantages and surface competitor weaknesses. Use these in discovery calls.
|
||||
|
||||
| Landmine Question | What It Exposes | Your Advantage |
|
||||
|------------------|----------------|---------------|
|
||||
| "How important is [capability you have, they don't] to your workflow?" | Creates need for your differentiator | [Your capability] |
|
||||
| "Have you experienced [common pain point with competitor]?" | Surfaces known competitor weakness | [Your solution to that pain] |
|
||||
| "What's your timeline for seeing ROI from this tool?" | Highlights time-to-value differences | [Your faster time-to-value] |
|
||||
| "How does your team currently handle [use case you excel at]?" | Opens discussion where you shine | [Your approach to this use case] |
|
||||
|
||||
---
|
||||
|
||||
### Section 10: Win/Loss Analysis
|
||||
|
||||
| Theme | Win Reasons (Why We Won) | Loss Reasons (Why We Lost) |
|
||||
|-------|------------------------|---------------------------|
|
||||
| Product | [What product features drove the win] | [What product gaps caused the loss] |
|
||||
| Pricing | [Price advantage or value perception] | [Price disadvantage or perceived poor value] |
|
||||
| Relationship | [Sales process, support quality] | [Better existing relationship with competitor] |
|
||||
| Brand | [Brand trust, market perception] | [Competitor brand stronger in this segment] |
|
||||
|
||||
**Recent Win Story:**
|
||||
> [Brief narrative: who was the customer, what were they comparing, why did they choose you]
|
||||
|
||||
**Recent Loss Story:**
|
||||
> [Brief narrative: who was the customer, what were they comparing, why did they choose competitor]
|
||||
|
||||
---
|
||||
|
||||
### Section 11: SEO/Content Intelligence
|
||||
|
||||
| Dimension | [Competitor] | Your Position |
|
||||
|-----------|-------------|--------------|
|
||||
| Domain Authority/Rating | [Score] | [Score] |
|
||||
| Organic traffic (est.) | [Monthly visits] | [Monthly visits] |
|
||||
| Keywords in top 10 | [Count] | [Count] |
|
||||
| Top-performing content | [URL + topic] | [Your equivalent or gap] |
|
||||
| Content publishing cadence | [Posts/month] | [Posts/month] |
|
||||
| Backlink count | [Count] | [Count] |
|
||||
| AI citation frequency | [High/Medium/Low] | [High/Medium/Low] |
|
||||
|
||||
**Content Strategy Observations:**
|
||||
- [What content themes drive their traffic]
|
||||
- [What formats they use effectively]
|
||||
- [Where their content is weak or outdated]
|
||||
|
||||
---
|
||||
|
||||
## Battlecard Maintenance Guidelines
|
||||
|
||||
### Update Triggers
|
||||
|
||||
Update the battlecard immediately when any of these occur:
|
||||
|
||||
| Trigger | What to Update |
|
||||
|---------|---------------|
|
||||
| Competitor launches new feature | Feature comparison, differentiators, landmine questions |
|
||||
| Competitor changes pricing | Pricing comparison, objection handling |
|
||||
| Competitor raises funding / IPO | Overview section, positioning |
|
||||
| Major review trends change | Weaknesses, objection handling, win/loss |
|
||||
| You launch competing feature | Differentiators, feature comparison |
|
||||
| Significant win or loss against them | Win/loss analysis, objection handling |
|
||||
| Competitor publishes major content | SEO/content intelligence |
|
||||
|
||||
### Quarterly Review Checklist
|
||||
|
||||
- [ ] Verify all pricing information is current
|
||||
- [ ] Check for new features launched by competitor
|
||||
- [ ] Review latest G2/Capterra/TrustRadius reviews for new themes
|
||||
- [ ] Update win/loss analysis with recent deals
|
||||
- [ ] Refresh SEO/content metrics
|
||||
- [ ] Confirm differentiators are still accurate
|
||||
- [ ] Test all landmine questions with sales team for relevance
|
||||
- [ ] Archive outdated information (don't delete -- move to "Historical" section)
|
||||
|
||||
### Data Sources for Battlecard Updates
|
||||
|
||||
| Source | What to Gather | Update Frequency |
|
||||
|--------|---------------|-----------------|
|
||||
| Competitor website | Pricing, features, messaging, positioning | Monthly |
|
||||
| G2/Capterra reviews | Strengths, weaknesses, customer sentiment | Quarterly |
|
||||
| LinkedIn/social media | Team changes, company news, content strategy | Monthly |
|
||||
| Industry press/blogs | Funding, partnerships, market perception | As published |
|
||||
| Sales team feedback | Win/loss themes, objection patterns | Monthly |
|
||||
| SEO tools | Traffic, rankings, backlinks, content changes | Monthly |
|
||||
| AI system queries | AI citation patterns, brand mentions | Quarterly |
|
||||
| Customer feedback | Competitive switching reasons | Quarterly |
|
||||
|
||||
---
|
||||
|
||||
## Example: Populated Battlecard Header
|
||||
|
||||
```
|
||||
COMPETITIVE BATTLECARD: SEMrush
|
||||
Last Updated: 2026-02-01
|
||||
Updated By: Content Strategy Team
|
||||
Confidence Level: High
|
||||
|
||||
One-Sentence Summary:
|
||||
SEMrush is an all-in-one SEO and digital marketing platform that helps marketing
|
||||
professionals manage SEO, PPC, content, and social media campaigns from a single dashboard.
|
||||
|
||||
Tagline: "Online Marketing Can Be Easy"
|
||||
|
||||
Positioning Statement:
|
||||
For digital marketing professionals and agencies, SEMrush is the all-in-one marketing
|
||||
toolkit that provides competitive intelligence and workflow automation because it combines
|
||||
55+ tools across SEO, PPC, content, and social in one platform.
|
||||
```
|
||||
|
|
@ -0,0 +1,75 @@
|
|||
# Competitor Analysis — Example Report
|
||||
|
||||
This is a complete example output showing the expected format for competitor analysis deliverables.
|
||||
|
||||
## Prompt
|
||||
|
||||
**User**: "Analyze why HubSpot ranks so well for marketing-related keywords"
|
||||
|
||||
## Example Output
|
||||
|
||||
```markdown
|
||||
# Competitive Analysis: HubSpot
|
||||
|
||||
## SEO Strategy Overview
|
||||
|
||||
HubSpot dominates marketing keywords through a combination of:
|
||||
1. **Massive content moat** - 10,000+ blog posts
|
||||
2. **Free tools as linkbait** - Website grader, email signature generator
|
||||
3. **Educational brand** - Academy, certifications, courses
|
||||
4. **Topic cluster model** - Pioneered the pillar/cluster approach
|
||||
|
||||
## What Makes Them Successful
|
||||
|
||||
### Content Strategy
|
||||
|
||||
**Publishing Volume**: 50-100 posts/month
|
||||
**Average Word Count**: 2,500+ words
|
||||
**Content Types**:
|
||||
- In-depth guides (35%)
|
||||
- How-to tutorials (25%)
|
||||
- Templates & examples (20%)
|
||||
- Data/research (10%)
|
||||
- Tools & calculators (10%)
|
||||
|
||||
**Top Performing Content Pattern**:
|
||||
1. Ultimate guides on broad topics
|
||||
2. Free templates with email gate
|
||||
3. Statistics roundup posts
|
||||
4. Definition posts ("What is [term]")
|
||||
|
||||
### GEO Success Factors
|
||||
|
||||
HubSpot appears in AI responses frequently because:
|
||||
|
||||
1. **Clear definitions** at the start of every post
|
||||
> "Inbound marketing is a business methodology that attracts customers by creating valuable content and experiences tailored to them."
|
||||
|
||||
2. **Quotable statistics**
|
||||
> "Companies that blog get 55% more website visitors"
|
||||
|
||||
3. **Comprehensive coverage** - AI trusts their authority
|
||||
|
||||
### Linkable Assets
|
||||
|
||||
| Asset | Backlinks | Why It Works |
|
||||
|-------|-----------|--------------|
|
||||
| Website Grader | 45,000+ | Free, instant value |
|
||||
| Marketing Statistics | 12,000+ | Quotable reference |
|
||||
| Blog Ideas Generator | 8,500+ | Solves real problem |
|
||||
|
||||
## Weaknesses to Exploit
|
||||
|
||||
1. **Content becoming dated** - Many posts 3+ years old
|
||||
2. **Generic advice** - Lacks industry-specific depth
|
||||
3. **Enterprise focus** - Underserves solopreneurs
|
||||
4. **Slow innovation** - Same formats for years
|
||||
|
||||
## Your Opportunities
|
||||
|
||||
1. Create more specific, niche content they can't cover
|
||||
2. Target long-tail keywords they ignore
|
||||
3. Build interactive tools in emerging areas
|
||||
4. Add original research they don't have
|
||||
5. Focus on GEO-optimized definitions in your niche
|
||||
```
|
||||
|
|
@ -0,0 +1,320 @@
|
|||
# Positioning Frameworks
|
||||
|
||||
Comprehensive frameworks for analyzing competitor positioning, developing your own positioning strategy, and identifying differentiation opportunities. Use these frameworks to map competitive landscapes, craft positioning statements, and find messaging vulnerabilities.
|
||||
|
||||
## Overview
|
||||
|
||||
Positioning is how your product or brand occupies a distinct place in the mind of your target audience relative to competitors. Strong positioning makes your value proposition clear, your differentiation obvious, and your target audience feel understood.
|
||||
|
||||
This reference covers:
|
||||
1. Positioning statement templates
|
||||
2. 2x2 positioning map methodology
|
||||
3. Category strategy options
|
||||
4. Differentiation playbooks
|
||||
5. Messaging vulnerability analysis
|
||||
|
||||
---
|
||||
|
||||
## 1. Positioning Statement Templates
|
||||
|
||||
### Classic Positioning Statement
|
||||
|
||||
The foundational template used across industries:
|
||||
|
||||
```
|
||||
For [target audience],
|
||||
[product/brand] is the [category]
|
||||
that [key benefit / point of difference]
|
||||
because [reason to believe / proof point].
|
||||
```
|
||||
|
||||
**Example (SEO tool):**
|
||||
> For growth-stage SaaS marketers, Clearscope is the content optimization platform that ensures every article ranks on page one because it uses real-time SERP data and NLP to grade content against ranking competitors.
|
||||
|
||||
### Extended Positioning Statement
|
||||
|
||||
Adds competitive context and emotional resonance:
|
||||
|
||||
```
|
||||
For [target audience] who [situation/need],
|
||||
[product/brand] is the [category]
|
||||
that [functional benefit]
|
||||
unlike [competitive alternative]
|
||||
because [unique capability / proof].
|
||||
This matters because [emotional benefit / outcome].
|
||||
```
|
||||
|
||||
**Example:**
|
||||
> For content teams who struggle to consistently rank new articles, MarketMuse is the content planning platform that identifies exactly which topics to cover, unlike manual keyword research tools, because it uses AI-driven topic models trained on ranking content. This matters because teams stop guessing and start publishing with confidence.
|
||||
|
||||
### Before/After/Bridge Positioning
|
||||
|
||||
Focuses on transformation:
|
||||
|
||||
```
|
||||
BEFORE: [Current painful state for target audience]
|
||||
AFTER: [Desired improved state]
|
||||
BRIDGE: [Your product] makes this possible by [mechanism].
|
||||
```
|
||||
|
||||
### Problem-Agitation-Solution Positioning
|
||||
|
||||
Focuses on pain point amplification:
|
||||
|
||||
```
|
||||
PROBLEM: [What the target audience struggles with]
|
||||
AGITATION: [Why this problem is worse than they think — consequences, hidden costs]
|
||||
SOLUTION: [How your product solves it differently than alternatives]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Positioning Map (2x2 Matrix) Methodology
|
||||
|
||||
### How to Build a Positioning Map
|
||||
|
||||
A positioning map plots competitors on two key dimensions to visualize the competitive landscape and identify open positioning space.
|
||||
|
||||
#### Step 1: Choose Your Axes
|
||||
|
||||
Select two dimensions that matter most to your target audience. The axes should be:
|
||||
- **Meaningful to buyers** (not internal metrics)
|
||||
- **Differentiating** (competitors should spread across the map)
|
||||
- **Independent** (the two dimensions should not be correlated)
|
||||
|
||||
#### Common Axis Pairs for SEO/Marketing
|
||||
|
||||
| Axis Pair | X-Axis | Y-Axis | Best For |
|
||||
|-----------|--------|--------|---------|
|
||||
| Value Positioning | Price (Low → High) | Capability (Basic → Advanced) | Understanding market tiers |
|
||||
| UX Positioning | Ease of Use (Complex → Simple) | Power (Limited → Comprehensive) | Evaluating UX/capability tradeoffs |
|
||||
| Audience Positioning | SMB Focus ← → Enterprise Focus | Point Solution ← → Full Platform | Identifying segment gaps |
|
||||
| Innovation Positioning | Established/Stable ← → Innovative/Cutting-Edge | Niche ← → Broad | Timing market positioning |
|
||||
| Content Positioning | Data-Driven ← → Opinion-Driven | Beginner ← → Expert | Content strategy differentiation |
|
||||
|
||||
#### Step 2: Plot Competitors
|
||||
|
||||
Place each competitor (including yourself) on the map based on objective assessment.
|
||||
|
||||
```
|
||||
HIGH CAPABILITY
|
||||
│
|
||||
Enterprise │ All-in-One
|
||||
Suites │ Platforms
|
||||
│
|
||||
LOW ───────────────┼─────────────── HIGH
|
||||
PRICE │ PRICE
|
||||
│
|
||||
Free/Basic │ Premium
|
||||
Tools │ Specialists
|
||||
│
|
||||
LOW CAPABILITY
|
||||
```
|
||||
|
||||
#### Step 3: Identify White Space
|
||||
|
||||
Look for quadrants or areas where:
|
||||
- **No competitor exists** (market opportunity)
|
||||
- **Only weak competitors exist** (displacement opportunity)
|
||||
- **Crowded clusters exist** (differentiation challenge -- avoid or reframe)
|
||||
|
||||
#### Step 4: Choose Your Position
|
||||
|
||||
Select a position that:
|
||||
- Aligns with your actual product capabilities
|
||||
- Serves an underserved audience segment
|
||||
- Is defensible (hard for competitors to copy)
|
||||
- Connects to a clear value narrative
|
||||
|
||||
### Positioning Map Anti-Patterns
|
||||
|
||||
| Anti-Pattern | Description | Fix |
|
||||
|-------------|------------|-----|
|
||||
| Aspiration mapping | Plotting yourself where you want to be, not where you are | Be honest about current position; create a roadmap to desired position |
|
||||
| Vanity axes | Choosing dimensions that make you look good but don't matter to buyers | Validate axes with customer research |
|
||||
| Missing competitors | Only plotting direct competitors, missing substitutes | Include indirect competitors and alternative solutions |
|
||||
| Static mapping | Building the map once and never updating | Refresh quarterly as market shifts |
|
||||
|
||||
---
|
||||
|
||||
## 3. Category Strategy Options
|
||||
|
||||
How you define your category determines your competitive set and positioning flexibility.
|
||||
|
||||
### Strategy 1: Win the Existing Category
|
||||
|
||||
**When to use:** You have a genuinely superior product in an established category.
|
||||
**Approach:** Accept the existing category definition and compete on being the best.
|
||||
**Messaging:** "The best [category] for [audience]"
|
||||
**Risk:** Head-to-head competition with established players.
|
||||
|
||||
**Example:** "The best SEO tool for content marketers" (competing within "SEO tools")
|
||||
|
||||
### Strategy 2: Create a New Sub-Category
|
||||
|
||||
**When to use:** You have a genuine differentiator that deserves its own label.
|
||||
**Approach:** Segment the existing category and own the new segment.
|
||||
**Messaging:** "The first [new sub-category]"
|
||||
**Risk:** Market may not recognize the sub-category.
|
||||
|
||||
**Example:** "Content optimization platform" (sub-category of "SEO tools" focused on content)
|
||||
|
||||
### Strategy 3: Create a New Category
|
||||
|
||||
**When to use:** Your product genuinely doesn't fit existing categories.
|
||||
**Approach:** Define a new category and position yourself as the category creator.
|
||||
**Messaging:** "Introducing [new category]: [definition]"
|
||||
**Risk:** High education cost; market may not adopt the category.
|
||||
|
||||
**Example:** "GEO optimization platform" (new category combining SEO + AI visibility)
|
||||
|
||||
### Strategy 4: Reframe the Category
|
||||
|
||||
**When to use:** The existing category frames competition in a way that disadvantages you.
|
||||
**Approach:** Change how buyers think about the problem, shifting the evaluation criteria.
|
||||
**Messaging:** "Stop thinking about [old category]. Start thinking about [new frame]."
|
||||
**Risk:** Confusing prospects who use existing category to search/evaluate.
|
||||
|
||||
**Example:** "Not another SEO tool -- a revenue intelligence platform" (reframing from SEO to revenue)
|
||||
|
||||
### Category Strategy Decision Matrix
|
||||
|
||||
| Factor | Win Existing | New Sub-Category | New Category | Reframe |
|
||||
|--------|-------------|-----------------|-------------|---------|
|
||||
| Product differentiation | Low-Medium | Medium-High | Very High | Medium |
|
||||
| Market education cost | Low | Medium | Very High | High |
|
||||
| Competitive intensity | High | Medium | Low (initially) | Medium |
|
||||
| SEO/search difficulty | High (competitive terms) | Medium (new terms) | Low (no competition) | Medium |
|
||||
| Sales cycle impact | Short (known category) | Medium | Long (education needed) | Medium-Long |
|
||||
|
||||
---
|
||||
|
||||
## 4. Differentiation Playbooks
|
||||
|
||||
### Types of Differentiation
|
||||
|
||||
Not all differentiation is equal. Stronger forms are harder to copy.
|
||||
|
||||
| Type | Strength | Durability | Examples |
|
||||
|------|---------|-----------|---------|
|
||||
| **Feature** | Low | Low (easily copied) | "We have feature X" |
|
||||
| **Integration** | Medium | Medium | "We connect to Y ecosystem" |
|
||||
| **Experience** | Medium-High | Medium-High | "Our UX is designed for Z workflow" |
|
||||
| **Data/Network** | High | High | "Our data from N users makes results better" |
|
||||
| **Methodology** | High | High | "We invented the X framework" |
|
||||
| **Mission/Values** | High | Very High | "We're the only [category] focused on [mission]" |
|
||||
|
||||
### Differentiation Audit Template
|
||||
|
||||
For each competitor, assess your differentiation strength:
|
||||
|
||||
| Dimension | Your Approach | Competitor's Approach | Differentiation Strength | Defensibility |
|
||||
|-----------|-------------|---------------------|------------------------|--------------|
|
||||
| Core technology | [Your tech] | [Their tech] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
| Target audience | [Your audience] | [Their audience] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
| Pricing model | [Your model] | [Their model] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
| Content/education | [Your approach] | [Their approach] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
| Customer support | [Your approach] | [Their approach] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
| Data advantage | [Your data] | [Their data] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
| Brand/community | [Your brand] | [Their brand] | [Weak/Medium/Strong] | [Easy/Hard to copy] |
|
||||
|
||||
### The "Only We" Test
|
||||
|
||||
For each claimed differentiator, apply this test:
|
||||
|
||||
> "Only [your company] [does X] because [unique reason]."
|
||||
|
||||
If a competitor could truthfully make the same claim, it is not a true differentiator. Revise until the statement is uniquely yours.
|
||||
|
||||
**Strong example:**
|
||||
> "Only Clearscope grades content against real-time SERP competitor analysis because we built a proprietary NLP model trained on ranking content patterns."
|
||||
|
||||
**Weak example:**
|
||||
> "Only we offer great customer support." (Every company claims this.)
|
||||
|
||||
### Differentiation Messaging Formula
|
||||
|
||||
```
|
||||
We're the only [category] that [unique capability]
|
||||
which means [customer benefit]
|
||||
so you can [desired outcome].
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Messaging Vulnerability Analysis
|
||||
|
||||
### Identifying Competitor Messaging Vulnerabilities
|
||||
|
||||
A messaging vulnerability is a gap between what a competitor claims and what they actually deliver, or a message that sounds good but collapses under scrutiny.
|
||||
|
||||
#### Vulnerability Types
|
||||
|
||||
| Vulnerability Type | Description | How to Exploit |
|
||||
|-------------------|------------|---------------|
|
||||
| **Promise-Reality Gap** | They claim X but reviews say Y | Reference review data; offer proof of your delivery |
|
||||
| **Specificity Gap** | They use vague claims ("best-in-class") without proof | Be specific with your claims; use data |
|
||||
| **Audience Mismatch** | Their messaging targets one audience but product serves another | Speak directly to the underserved audience |
|
||||
| **Legacy Positioning** | Their positioning is outdated; product has evolved | Position against their OLD story, which is stuck in market perception |
|
||||
| **Feature Overload** | They list features without connecting to outcomes | Lead with outcomes, not features |
|
||||
| **Price Sensitivity** | They avoid discussing price, suggesting it's high or confusing | Be transparent about pricing; create TCO comparisons |
|
||||
|
||||
#### Competitor Messaging Audit Worksheet
|
||||
|
||||
For each competitor, analyze their messaging across touchpoints:
|
||||
|
||||
| Touchpoint | Their Message | Vulnerability? | Your Counter-Message |
|
||||
|-----------|-------------|---------------|---------------------|
|
||||
| Homepage hero | [Their headline] | [Yes/No — what's weak?] | [Your alternative angle] |
|
||||
| Pricing page | [How they frame pricing] | [Yes/No — what's hidden?] | [Your transparency approach] |
|
||||
| Blog/content | [Content themes and tone] | [Yes/No — what's missing?] | [Your content differentiation] |
|
||||
| Social media | [Social messaging and engagement] | [Yes/No — what's performative?] | [Your authentic approach] |
|
||||
| Sales emails/outreach | [Known sales messaging] | [Yes/No — what's pushy/generic?] | [Your consultative approach] |
|
||||
| Customer reviews | [What customers actually say] | [Yes/No — gap from their claims?] | [Highlight alignment of your claims + reviews] |
|
||||
|
||||
### Counter-Positioning Strategies
|
||||
|
||||
| Strategy | When to Use | Messaging Pattern |
|
||||
|----------|-----------|-----------------|
|
||||
| **Contrast** | When competitor is dominant but has clear weakness | "Unlike [competitor], we [your strength]" |
|
||||
| **Flanking** | When competitor ignores a valuable segment | "Built specifically for [underserved segment]" |
|
||||
| **Reframing** | When competitor's strength is actually a weakness in disguise | "[Competitor's feature] sounds good until you realize [negative consequence]" |
|
||||
| **Elevation** | When competing on features is a losing game | "Stop comparing features. What matters is [higher-level outcome]" |
|
||||
| **Specificity** | When competitor uses vague claims | "[Specific metric] for [specific audience] in [specific timeframe]" |
|
||||
|
||||
### Messaging Strength Test
|
||||
|
||||
Rate each competitor's messaging on these dimensions (1-5):
|
||||
|
||||
| Dimension | What to Evaluate | Score |
|
||||
|-----------|-----------------|-------|
|
||||
| Clarity | Can you understand their value prop in 5 seconds? | [1-5] |
|
||||
| Specificity | Do they use concrete numbers and claims? | [1-5] |
|
||||
| Differentiation | Is their message distinct from competitors? | [1-5] |
|
||||
| Proof | Do they back claims with evidence? | [1-5] |
|
||||
| Audience fit | Does the message resonate with their target? | [1-5] |
|
||||
| Consistency | Is messaging consistent across all touchpoints? | [1-5] |
|
||||
| Emotional resonance | Does it connect with real pain or aspiration? | [1-5] |
|
||||
|
||||
**Total Score** = Sum / 35
|
||||
|
||||
| Score Range | Assessment |
|
||||
|------------|-----------|
|
||||
| 0.8-1.0 | Very strong messaging -- find a niche angle to compete |
|
||||
| 0.6-0.79 | Solid messaging -- exploit specific gaps |
|
||||
| 0.4-0.59 | Average messaging -- multiple attack vectors available |
|
||||
| Below 0.4 | Weak messaging -- opportunity to dominate with clarity |
|
||||
|
||||
---
|
||||
|
||||
## Applying These Frameworks Together
|
||||
|
||||
### Recommended Workflow
|
||||
|
||||
1. **Start with Positioning Maps** to understand the landscape visually
|
||||
2. **Analyze Category Strategy** to decide how to frame your competitive set
|
||||
3. **Build Positioning Statement** using the templates
|
||||
4. **Audit Differentiation** to ensure claims are defensible
|
||||
5. **Identify Messaging Vulnerabilities** to find attack angles
|
||||
6. **Create Battlecards** (see [battlecard-template.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/battlecard-template.md)) incorporating all insights
|
||||
7. **Review quarterly** as the competitive landscape shifts
|
||||
Loading…
Add table
Add a link
Reference in a new issue