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

- 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 2026-04-11 23:38:12 -07:00
parent 61b3f0d7e3
commit 7ea840dbb2
120 changed files with 25729 additions and 352 deletions

View file

@ -0,0 +1,309 @@
---
name: competitor-analysis
description: 'Analyze competitor SEO/GEO: keywords, content, backlinks, AI citations, traffic share gaps. 竞品分析/竞争对手'
version: "6.0.0"
license: Apache-2.0
compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations."
homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills"
when_to_use: "Use when analyzing competitor SEO strategy, comparing domains, benchmarking against competitors, or finding competitor keywords and content gaps."
argument-hint: "<competitor URL or domain>"
metadata:
author: aaron-he-zhu
version: "6.0.0"
geo-relevance: "medium"
tags:
- seo
- geo
- competitor-analysis
- competitive-intelligence
- benchmarking
- competitor-keywords
- competitor-backlinks
- market-analysis
- spyfu-alternative
- 竞品分析
- 競合分析
- 경쟁분석
- analisis-competitivo
triggers:
# EN-formal
- "analyze competitors"
- "competitor SEO"
- "competitive analysis"
- "competitor keywords"
- "competitor backlinks"
- "market analysis"
- "competitive intelligence"
# EN-casual
- "what are my competitors doing"
- "what are they doing differently"
- "why do they rank higher"
- "spy on competitor SEO"
- "what are they doing better"
- "why do they outrank me"
# EN-question
- "who are my SEO competitors"
- "how do I beat my competitors"
- "why do competitors rank higher"
# EN-competitor
- "SpyFu alternative"
- "Semrush competitor analysis"
- "Ahrefs competitor tool"
# ZH-pro
- "竞品分析"
- "竞争对手分析"
- "竞品SEO"
- "对标分析"
- "竞争情报"
# ZH-casual
- "竞品怎么做的"
- "他们排名为什么比我高"
- "看看对手在干什么"
- "为什么他们排名好"
# JA
- "競合分析"
- "競合SEO分析"
- "ライバル分析"
# KO
- "경쟁 분석"
- "경쟁사 SEO"
- "경쟁사 키워드"
# ES
- "análisis de competidores"
- "análisis competitivo SEO"
# PT
- "análise de concorrentes"
# Misspellings
- "competitve analysis"
- "compeditor analysis"
---
# Competitor Analysis
> **[SEO & GEO Skills Library](https://github.com/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · [ClawHub](https://clawhub.ai/u/aaron-he-zhu) · [skills.sh](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)
> **System Mode**: This research skill follows the shared [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) and [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md).
This skill provides comprehensive analysis of competitor SEO and GEO strategies, revealing what's working in your market and identifying opportunities to outperform the competition.
**System role**: Research layer skill. It turns market signals into reusable strategic inputs for the rest of the library.
## When This Must Trigger
Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
Use this whenever the task needs reusable market intelligence that should influence strategy, not just an ad hoc answer.
- Entering a new market or niche
- Planning content strategy based on competitor success
- Understanding why competitors rank higher
- Finding backlink and partnership opportunities
- Identifying content gaps competitors are missing
- Analyzing competitor AI citation strategies
- Benchmarking your SEO performance
## What This Skill Does
1. **Keyword Analysis**: Identifies keywords competitors rank for
2. **Content Audit**: Analyzes competitor content strategies and formats
3. **Backlink Profiling**: Reviews competitor link-building approaches
4. **Technical Assessment**: Evaluates competitor site health
5. **GEO Analysis**: Identifies how competitors appear in AI responses
6. **Gap Identification**: Finds opportunities competitors miss
7. **Strategy Extraction**: Reveals actionable insights from competitor success
## Quick Start
Start with one of these prompts. Finish with a short handoff summary using the repository format in [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).
### Basic Competitor Analysis
```
Analyze SEO strategy for [competitor URL]
```
```
Compare my site [URL] against [competitor 1], [competitor 2], [competitor 3]
```
### Specific Analysis
```
What content is driving the most traffic for [competitor]?
```
```
Analyze why [competitor] ranks #1 for [keyword]
```
### GEO-Focused Analysis
```
How is [competitor] getting cited in AI responses? What can I learn?
```
## Skill Contract
**Expected output**: a prioritized research brief, evidence-backed findings, and a short handoff summary ready for `memory/research/`.
- **Reads**: user goals, target market inputs, available tool data, and prior strategy from [CLAUDE.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CLAUDE.md) and the shared [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md) when available.
- **Writes**: a user-facing research deliverable plus a reusable summary that can be stored under `memory/research/`.
- **Promotes**: durable keyword priorities, competitor facts, entity candidates, and strategic decisions to `CLAUDE.md`, `memory/decisions.md`, and `memory/research/`; hand canonical entity work to `entity-optimizer`.
- **Next handoff**: use the `Next Best Skill` below when the findings are ready to drive action.
## Data Sources
> **Note:** All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.
> See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) for tool category placeholders.
**With ~~SEO tool + ~~analytics + ~~AI monitor connected:**
Automatically pull competitor keyword rankings, backlink profiles, top performing content, domain authority metrics from ~~SEO tool. Compare against your site's metrics from ~~analytics and ~~search console. Check AI citation patterns for both your site and competitors using ~~AI monitor.
**With manual data only:**
Ask the user to provide:
1. Competitor URLs to analyze (2-5 recommended)
2. Your own site URL and current metrics (traffic, rankings if known)
3. Industry or niche context
4. Specific aspects to focus on (keywords, content, backlinks, etc.)
5. Any known competitor strengths or weaknesses
Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.
## Instructions
When a user requests competitor analysis:
1. **Identify Competitors**
If not specified, help identify competitors:
```markdown
### Competitor Identification Framework
**Direct Competitors** (same product/service)
- Search "[your main keyword]" and note top 5 organic results
- Check who's advertising for your keywords
- Ask: Who do customers compare you to?
**Indirect Competitors** (different solution, same problem)
- Search problem-focused keywords
- Look at alternative solutions
**Content Competitors** (compete for same keywords)
- May not sell same product
- Rank for your target keywords
- Include media sites, blogs, aggregators
```
2. **Gather Competitor Data**
Collect for each competitor: URL, domain age, estimated traffic, domain authority, business model, target audience, and key offerings.
3. **Analyze Keyword Rankings**
Document total keywords ranking, top 10/top 3 counts, top performing keywords (with position, volume, traffic, page URL), keyword distribution by intent, and keyword gaps.
4. **Audit Content Strategy**
Analyze content volume by type, top performing content, content patterns (word count, frequency, formats), content themes, and success factors.
5. **Analyze Backlink Profile**
Review total backlinks, referring domains, link quality distribution, top linking domains, link acquisition patterns, and linkable assets.
6. **Technical SEO Assessment**
Evaluate Core Web Vitals, mobile-friendliness, site architecture, internal linking quality, URL structure, and technical strengths/weaknesses.
7. **GEO/AI Citation Analysis**
Test competitor content in AI systems: document which queries cite them, GEO strategies observed (definitions, statistics, Q&A, authority signals), and GEO opportunities they are missing.
8. **Synthesize Competitive Intelligence**
Produce a final report with: Executive Summary, Competitive Landscape comparison table, CITE domain authority comparison, Strengths to Learn From, Weaknesses to Exploit, Keyword Opportunities, Content Strategy Recommendations, and Action Plan (Immediate / Short-term / Long-term).
> **Reference**: See [references/analysis-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/analysis-templates.md) for detailed templates for each step.
## Validation Checkpoints
### Input Validation
- [ ] Competitor URLs verified as relevant to your niche
- [ ] Analysis scope defined (comprehensive or specific focus area)
- [ ] Your own site metrics available for comparison
- [ ] Minimum 2-3 competitors identified for meaningful patterns
### Output Validation
- [ ] Every recommendation cites specific data points (not generic advice)
- [ ] Competitor strengths backed by measurable evidence (metrics, rankings)
- [ ] Opportunities based on identifiable gaps, not assumptions
- [ ] Action plan items are specific and actionable (not vague strategies)
- [ ] Source of each data point clearly stated (~~SEO tool data, ~~analytics data, ~~AI monitor data, user-provided, or estimated)
## Example
> **Reference**: See [references/example-report.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/example-report.md) for a complete example analyzing HubSpot's marketing keyword dominance.
## Advanced Analysis Types
### Content Gap Analysis
```
Show me content [competitor] has that I don't, sorted by traffic potential
```
### Link Intersection
```
Find sites linking to [competitor 1] AND [competitor 2] but not me
```
### SERP Feature Analysis
```
What SERP features do competitors win? (Featured snippets, PAA, etc.)
```
### Historical Tracking
```
How has [competitor]'s SEO strategy evolved over the past year?
```
## Tips for Success
1. **Analyze 3-5 competitors** for comprehensive view
2. **Include indirect competitors** - they often have innovative approaches
3. **Look beyond rankings** - analyze content quality, user experience
4. **Study their failures** - avoid their mistakes
5. **Monitor regularly** - competitor strategies evolve
6. **Focus on actionable insights** - what can you actually implement?
### Save Results
After delivering findings to the user, ask:
> "Save these results for future sessions?"
If yes, write a dated summary to `memory/research/competitor-analysis/YYYY-MM-DD-<topic>.md` containing:
- One-line headline finding
- Top 3-5 actionable items
- Open loops or blockers
- Source data references
If any findings should influence ongoing strategy, recommend promoting key conclusions to `memory/hot-cache.md`.
## Reference Materials
- [Analysis Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/analysis-templates.md) — Detailed templates for each analysis step (profile, keywords, content, backlinks, technical, GEO, synthesis)
- [Battlecard Template](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/battlecard-template.md) — Quick-reference competitive battlecard for sales and marketing teams
- [Positioning Frameworks](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/positioning-frameworks.md) — Positioning maps, messaging matrices, narrative analysis, and differentiation frameworks
- [Example Report](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/competitor-analysis/references/example-report.md) — Complete example analyzing HubSpot's marketing keyword dominance
## Next Best Skill
- **Primary**: [content-gap-analysis](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/research/content-gap-analysis/SKILL.md) — turn competitor findings into a focused opportunity map.

View file

@ -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]
```

View file

@ -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.
```

View file

@ -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
```

View file

@ -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