feat: Brainstorm Topics with GSC + Issue #518 fixes + Blog Editor enhancements
Issue #518 - Subscription not updating after checkout: - Fix stale closure in SubscriptionContext checkout polling (use subscriptionRef) - Move checkout success polling from InitialRouteHandler into SubscriptionContext - Remove redundant polling code from InitialRouteHandler - Fix plan label: 'Free' instead of 'No Plan', proper capitalization - Add plan refresh button in UserBadge - Add 'View Costing Details' to UserBadge dropdown - Rename 'ALwrity Podcast Maker' to 'Podcast Creator' across UI - Clean subscription=success URL param after verification Blog Writer WYSIWYG Editor enhancements: - Per-section preview toggle (view/edit icons) - Enhanced hover-based toolbar - Circular SVG progress stats bar with detailed tooltip - Research tool chips in stats bar footer - Per-section TTS with useTextToSpeech hook (browser native) - Full blog preview modal with print/PDF support - PlayAllTTSButton: sequential playback with progress bar - OnThisPageNav: floating sidebar with scroll tracking - Section data attributes for scroll anchoring GSC Brainstorm Topics feature: - Backend: gsc_brainstorm_service.py (rule-based + LLM recommendations) - Backend: POST /gsc/brainstorm endpoint with 3-word minimum validation - Frontend: gscBrainstorm.ts API client - Frontend: useGSCBrainstormConnection hook (popup OAuth, no /onboarding redirect) - Frontend: useGSCBrainstorm hook (connect check + brainstorm call) - Frontend: GSCBrainstormModal (3-tab results: Opportunities, Gaps, AI Recs) - Frontend: BrainstormButton (visible at 3+ words, GSC connect overlay) - Wire BrainstormButton into ManualResearchForm and ResearchAction - Add blog_writer to gsc_auth router features for ALWRITY_ENABLED_FEATURES
This commit is contained in:
ajaysi
466
docs-site/docs/features/seo-dashboard/content-strategy-guide.md
Normal file
466
docs-site/docs/features/seo-dashboard/content-strategy-guide.md
Normal file
@@ -0,0 +1,466 @@
|
||||
# Content Strategy Tool Guide
|
||||
|
||||
## 📊 Overview
|
||||
|
||||
The ALwrity Content Strategy Analyzer helps you identify content gaps, discover opportunities, plan your content calendar, and develop a data-driven content strategy. Using AI analysis and competitive intelligence, you can create content that ranks and converts.
|
||||
|
||||
## 🎯 What You Can Do
|
||||
|
||||
### Content Gap Analysis
|
||||
- Identify topics you're missing
|
||||
- Find competitor content opportunities
|
||||
- Analyze content distribution
|
||||
- Discover emerging trends
|
||||
|
||||
### Opportunity Identification
|
||||
- Score opportunities by potential
|
||||
- Identify high-volume keywords
|
||||
- Find low-competition topics
|
||||
- Discover audience needs
|
||||
|
||||
### Content Planning
|
||||
- Generate topic recommendations
|
||||
- Suggest content types
|
||||
- Plan publishing schedule
|
||||
- Create content clusters
|
||||
|
||||
### Competitive Positioning
|
||||
- Analyze competitor content strategies
|
||||
- Find content advantages
|
||||
- Identify differentiation opportunities
|
||||
- Plan content differentiation
|
||||
|
||||
---
|
||||
|
||||
## Content Strategy Analysis
|
||||
|
||||
### Analysis Components
|
||||
|
||||
#### 1. Content Gaps
|
||||
**What It Shows**:
|
||||
Topics your competitors cover that you don't
|
||||
- Missing high-opportunity topics
|
||||
- Underserved audience needs
|
||||
- Emerging trend areas
|
||||
- Topic clusters without coverage
|
||||
|
||||
**Opportunity Scoring**:
|
||||
- **Search Volume**: Monthly search interest
|
||||
- **Difficulty**: Competition level (easy to hard)
|
||||
- **Opportunity Score**: Combined potential (0-100)
|
||||
- **Recommended Content Types**: Blog, guide, video, etc.
|
||||
|
||||
**Example Output**:
|
||||
```
|
||||
Topic: "Advanced Email Marketing Strategies"
|
||||
- Search Volume: 12,000/month
|
||||
- Difficulty: Medium
|
||||
- Opportunity Score: 82/100
|
||||
- Recommended Types: Blog post, guide, video tutorial
|
||||
- Your Gap: Not in top 20 results
|
||||
- Competitor Ranking: Competitor A #3, B #8
|
||||
```
|
||||
|
||||
#### 2. Content Distribution
|
||||
**What It Shows**:
|
||||
How your content is distributed across types and topics
|
||||
- Blog posts vs. pages vs. guides
|
||||
- Topic distribution
|
||||
- Content depth analysis
|
||||
- Content freshness
|
||||
|
||||
**Comparison**:
|
||||
- Your distribution vs. competitors
|
||||
- Underserved content types
|
||||
- Overexposed areas
|
||||
- Rebalancing recommendations
|
||||
|
||||
#### 3. Publishing Velocity
|
||||
**What It Shows**:
|
||||
How frequently you and competitors publish
|
||||
- Your publishing rate (posts/week)
|
||||
- Competitor rates
|
||||
- Trend over time
|
||||
- Recommendations for optimal frequency
|
||||
|
||||
**Analysis**:
|
||||
- Are you publishing enough?
|
||||
- Publishing frequency trends
|
||||
- Recommended increase/decrease
|
||||
- Content quality vs. quantity balance
|
||||
|
||||
#### 4. Competitive Content Analysis
|
||||
**What It Shows**:
|
||||
What content your competitors are creating successfully
|
||||
- Their top-performing topics
|
||||
- Content types they excel at
|
||||
- Content gaps in their strategy
|
||||
- Differentiation opportunities
|
||||
|
||||
---
|
||||
|
||||
## How to Use the Content Strategy Tool
|
||||
|
||||
### Getting Started
|
||||
|
||||
#### Step 1: Run the Analysis
|
||||
1. Go to **Content Strategy Analyzer**
|
||||
2. Enter your website URL
|
||||
3. Add competitors (optional)
|
||||
4. Click **"Analyze Content Strategy"**
|
||||
5. Wait for analysis to complete (5-10 minutes)
|
||||
|
||||
#### Step 2: Review the Report
|
||||
The report includes:
|
||||
- **Executive Summary**: Key findings and opportunities
|
||||
- **Content Gaps**: Top 10 high-opportunity topics
|
||||
- **Gap Analysis**: Missing topics with scoring
|
||||
- **Competitive Positioning**: How you compare
|
||||
- **Recommendations**: Specific action items
|
||||
|
||||
#### Step 3: Make a Plan
|
||||
1. Identify top 3-5 opportunities
|
||||
2. Assign priorities
|
||||
3. Plan content calendar
|
||||
4. Assign ownership
|
||||
5. Set timelines
|
||||
|
||||
### Example Workflow
|
||||
|
||||
```
|
||||
Monday: Run content strategy analysis
|
||||
Tuesday: Review findings, identify top 10 opportunities
|
||||
Wednesday: Select top 5, create content briefs
|
||||
Thursday: Assign to team members
|
||||
Friday: Plan publishing schedule
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Understanding Your Results
|
||||
|
||||
### Opportunity Scores
|
||||
|
||||
#### Scoring Breakdown
|
||||
- **0-20**: Low opportunity (low volume, high competition)
|
||||
- **21-40**: Moderate opportunity (niche topics)
|
||||
- **41-60**: Good opportunity (decent volume, moderate competition)
|
||||
- **61-80**: High opportunity (strong volume, manageable competition)
|
||||
- **81-100**: Excellent opportunity (high volume, low competition)
|
||||
|
||||
#### What Affects Scoring
|
||||
1. **Search Volume** (40%) - Higher is better
|
||||
2. **Competition** (30%) - Lower difficulty is better
|
||||
3. **Relevance** (20%) - Match to your audience
|
||||
4. **Trend** (10%) - Rising trends get bonus points
|
||||
|
||||
### Gap Types
|
||||
|
||||
#### Topic Gaps
|
||||
Missing entire topics competitors cover:
|
||||
- **Complete Gap**: Neither you nor competitors are strong
|
||||
- **Competitive Gap**: Competitors strong, you weak
|
||||
- **Emerging Gap**: New trend both miss
|
||||
|
||||
#### Content Type Gaps
|
||||
Missing specific content formats:
|
||||
- Blog posts (if competitors have videos)
|
||||
- Case studies (if missing examples)
|
||||
- Interactive content (if all text)
|
||||
- Video content (if no video)
|
||||
|
||||
#### Topic Cluster Gaps
|
||||
Missing clusters of related content:
|
||||
- Competitors have cluster, you don't
|
||||
- Cluster has high search volume
|
||||
- Your audience likely interested
|
||||
- Quick win opportunity
|
||||
|
||||
---
|
||||
|
||||
## Content Planning
|
||||
|
||||
### Creating Your Plan
|
||||
|
||||
#### Step 1: Prioritize Opportunities
|
||||
Score each gap:
|
||||
- **Impact Score**: Potential traffic gain (0-100)
|
||||
- **Effort Score**: Time/resources needed (0-100)
|
||||
- **Priority**: Impact ÷ Effort (higher = better)
|
||||
|
||||
#### Step 2: Plan Content
|
||||
For each top opportunity:
|
||||
1. **Topic**: Clear, specific title
|
||||
2. **Keywords**: Primary + secondary keywords
|
||||
3. **Type**: Blog, guide, video, etc.
|
||||
4. **Length**: Recommended word count
|
||||
5. **Timeline**: When to publish
|
||||
|
||||
#### Step 3: Create Clusters
|
||||
Group related content:
|
||||
- **Pillar**: Main topic (comprehensive guide)
|
||||
- **Cluster**: Supporting topics (detailed guides)
|
||||
- **Resources**: Additional materials
|
||||
|
||||
#### Step 4: Publish & Optimize
|
||||
1. Create content
|
||||
2. Optimize for keywords
|
||||
3. Build internal links
|
||||
4. Publish on schedule
|
||||
5. Promote on social
|
||||
|
||||
### Example Plan
|
||||
|
||||
```
|
||||
Pillar Topic: "Email Marketing Strategy"
|
||||
- Pillar Content: Complete guide (5,000+ words)
|
||||
|
||||
Cluster Topics:
|
||||
1. Email Segmentation (2,000 words)
|
||||
2. Email Automation (2,000 words)
|
||||
3. A/B Testing Emails (1,500 words)
|
||||
4. Email Personalization (1,500 words)
|
||||
|
||||
Supporting Resources:
|
||||
- Email templates (downloadable)
|
||||
- Best practices checklist
|
||||
- Tools comparison guide
|
||||
- Case study example
|
||||
|
||||
Timeline:
|
||||
- Pillar: Week 1
|
||||
- Cluster 1-2: Week 2-3
|
||||
- Cluster 3-4: Week 4-5
|
||||
- Resources: Week 6
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Advanced Analysis
|
||||
|
||||
### Content Type Recommendations
|
||||
|
||||
The tool recommends optimal content types based on:
|
||||
- Your audience preferences
|
||||
- Topic characteristics
|
||||
- Competitor strategies
|
||||
- Search intent
|
||||
- Engagement potential
|
||||
|
||||
#### Typical Recommendations
|
||||
- **Blog Post**: General informational topics
|
||||
- **Comprehensive Guide**: In-depth, authoritative topics
|
||||
- **How-To Guide**: Procedural, step-by-step topics
|
||||
- **Tutorial**: Technical, complex topics
|
||||
- **Case Study**: Implementation, real-world examples
|
||||
- **Video**: Visual, demonstration topics
|
||||
- **Infographic**: Data, comparison topics
|
||||
- **Checklist**: Action-oriented topics
|
||||
|
||||
### Topic Clustering
|
||||
|
||||
The tool identifies natural clusters:
|
||||
- **Related Topics**: Naturally grouped topics
|
||||
- **Pillar Content**: Main comprehensive topic
|
||||
- **Supporting Content**: Detailed subtopics
|
||||
- **Internal Linking**: Connection strategy
|
||||
|
||||
### Trend Analysis
|
||||
|
||||
Identifies emerging trends:
|
||||
- **Rising Trends**: Topics gaining search interest
|
||||
- **Seasonal Topics**: Cyclical content opportunities
|
||||
- **Declining Trends**: Topics losing interest
|
||||
- **Timeless Topics**: Evergreen, stable content
|
||||
|
||||
---
|
||||
|
||||
## Content Calendar
|
||||
|
||||
### Planning Your Calendar
|
||||
|
||||
#### Monthly Planning
|
||||
1. Identify high-priority topics
|
||||
2. Assign to weeks
|
||||
3. Include supporting content
|
||||
4. Plan promotions
|
||||
|
||||
#### Quarterly Planning
|
||||
1. Set content themes
|
||||
2. Plan pillar topics
|
||||
3. Map cluster topics
|
||||
4. Set KPIs
|
||||
|
||||
#### Annual Planning
|
||||
1. Define content strategy
|
||||
2. Plan seasonal content
|
||||
3. Set annual goals
|
||||
4. Identify growth areas
|
||||
|
||||
### Example Calendar
|
||||
|
||||
```
|
||||
Month 1: Foundation
|
||||
- Pillar: "Complete SEO Guide" (Week 1)
|
||||
- Cluster: "Keyword Research" (Week 2)
|
||||
- Cluster: "On-Page SEO" (Week 3)
|
||||
- Update: Refresh old posts (Week 4)
|
||||
|
||||
Month 2: Building
|
||||
- Cluster: "Technical SEO" (Week 1)
|
||||
- Cluster: "Link Building" (Week 2)
|
||||
- Supporting: Templates & Tools (Week 3)
|
||||
- Promotion: Webinar, social (Week 4)
|
||||
|
||||
Month 3: Expansion
|
||||
- Cluster: "Content Strategy" (Week 1)
|
||||
- Case Study: Success story (Week 2)
|
||||
- Competitive: Competitor comparison (Week 3)
|
||||
- Review: Monthly analytics (Week 4)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Planning Best Practices
|
||||
1. ✅ Start with high-opportunity topics
|
||||
2. ✅ Balance content types
|
||||
3. ✅ Create content clusters
|
||||
4. ✅ Plan 2-3 months ahead
|
||||
5. ✅ Include supporting content
|
||||
|
||||
### Content Creation Best Practices
|
||||
1. ✅ Research thoroughly before writing
|
||||
2. ✅ Optimize for primary + secondary keywords
|
||||
3. ✅ Build internal links to relevant content
|
||||
4. ✅ Include multimedia (images, videos)
|
||||
5. ✅ Update older content regularly
|
||||
|
||||
### Publishing Best Practices
|
||||
1. ✅ Maintain consistent schedule
|
||||
2. ✅ Promote on social media
|
||||
3. ✅ Build backlinks
|
||||
4. ✅ Monitor rankings
|
||||
5. ✅ Update based on performance
|
||||
|
||||
---
|
||||
|
||||
## Common Mistakes to Avoid
|
||||
|
||||
### Planning Mistakes
|
||||
- ❌ Picking only easy topics (low competition often = low volume)
|
||||
- ❌ Ignoring your audience needs
|
||||
- ❌ Publishing too infrequently
|
||||
- ❌ Creating isolated posts (no strategy)
|
||||
- ❌ Copying competitor content
|
||||
|
||||
### Execution Mistakes
|
||||
- ❌ Publishing without optimization
|
||||
- ❌ Forgetting internal linking
|
||||
- ❌ Neglecting images/multimedia
|
||||
- ❌ Not tracking performance
|
||||
- ❌ Giving up too quickly
|
||||
|
||||
### Strategy Mistakes
|
||||
- ❌ Only pursuing quick wins
|
||||
- ❌ Ignoring competitor moves
|
||||
- ❌ Not updating old content
|
||||
- ❌ Focusing only on rankings
|
||||
- ❌ Missing audience trends
|
||||
|
||||
---
|
||||
|
||||
## Integration with Other Tools
|
||||
|
||||
### Works With:
|
||||
- **Blog Writer** - Create planned content
|
||||
- **Metadata Generator** - Optimize titles/descriptions
|
||||
- **On-Page SEO** - Optimize created content
|
||||
- **Competitive Analysis** - Understand competitor strategy
|
||||
- **AI Copilot** - Get strategic recommendations
|
||||
|
||||
### Typical Workflow:
|
||||
```
|
||||
1. Content Strategy Tool → Identify opportunities
|
||||
2. AI Copilot → Get recommendations
|
||||
3. Blog Writer → Create content
|
||||
4. On-Page SEO → Optimize content
|
||||
5. SEO Dashboard → Track rankings
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Measuring Success
|
||||
|
||||
### Key Metrics to Track
|
||||
|
||||
#### Traffic Metrics
|
||||
- Organic traffic to new content
|
||||
- Traffic by content type
|
||||
- Traffic growth trend
|
||||
- Pages per session
|
||||
|
||||
#### Ranking Metrics
|
||||
- New keyword rankings
|
||||
- Ranking improvements
|
||||
- Top 10 positions
|
||||
- Rank 1 positions
|
||||
|
||||
#### Engagement Metrics
|
||||
- Average time on page
|
||||
- Bounce rate
|
||||
- Click-through rate
|
||||
- Social shares
|
||||
|
||||
#### Conversion Metrics
|
||||
- Leads from content
|
||||
- Sales from content
|
||||
- Cost per acquisition
|
||||
- Content ROI
|
||||
|
||||
### Measuring ROI
|
||||
|
||||
```
|
||||
Content ROI = (Revenue from Content - Content Cost) / Content Cost
|
||||
|
||||
Example:
|
||||
- 10 articles created = $5,000 cost
|
||||
- Generated $25,000 in revenue
|
||||
- ROI = ($25,000 - $5,000) / $5,000 = 400%
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Run Analysis**: Execute Content Strategy Analysis
|
||||
2. **Review Findings**: Understand your opportunities
|
||||
3. **Make Plan**: Create 90-day content calendar
|
||||
4. **Get Help**: Ask AI Copilot for recommendations
|
||||
5. **Create Content**: Use Blog Writer to create planned content
|
||||
6. **Optimize**: Use On-Page SEO to optimize
|
||||
7. **Track**: Monitor rankings and traffic
|
||||
|
||||
---
|
||||
|
||||
## Common Questions
|
||||
|
||||
### Q: How often should I run analysis?
|
||||
**A**: Monthly for active strategies, quarterly minimum
|
||||
|
||||
### Q: How many opportunities should I pursue?
|
||||
**A**: Start with top 5-10, one at a time
|
||||
|
||||
### Q: How long before I see results?
|
||||
**A**: 4-8 weeks for rankings, 8-12 weeks for traffic
|
||||
|
||||
### Q: Should I ignore easy topics?
|
||||
**A**: No! Include 20% easy wins, 80% strategic growth
|
||||
|
||||
### Q: Can I modify recommendations?
|
||||
**A**: Absolutely! Use them as guidance, not requirements
|
||||
|
||||
---
|
||||
|
||||
**Ready to plan your content strategy? Start with [Content Strategy Analyzer](tools-reference.md) or ask [AI Copilot](ai-copilot.md) for help!**
|
||||
Reference in New Issue
Block a user