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
2026-05-20 22:34:37 +05:30
parent 68190dedb3
commit 644e72d289
98 changed files with 16137 additions and 2501 deletions
--- a/docs-site/docs/features/seo-dashboard/workflows-guide.md
+++ b/docs-site/docs/features/seo-dashboard/workflows-guide.md
@@ -0,0 +1,564 @@
+# SEO Workflows & Automation Guide
+
+## 🔄 Overview
+
+This guide shows you how to use ALwrity's SEO tools together to create efficient workflows for different use cases. Learn proven workflows from planning to execution.
+
+---
+
+## Core Workflows
+
+### Workflow 1: Content Creation Pipeline
+
+Complete workflow from planning to optimization:
+
+```
+Step 1: Content Gap Analysis
+└─ Use: Content Strategy Analyzer
+└─ Output: Top 10 opportunities, keyword recommendations
+└─ Time: 10 minutes
+
+Step 2: Research & Planning
+└─ Use: AI Copilot (get recommendations)
+└─ Output: Content outline, target keywords
+└─ Time: 15 minutes
+
+Step 3: Content Creation
+└─ Use: Blog Writer
+└─ Output: Draft content with SEO optimization
+└─ Time: 30-60 minutes
+
+Step 4: Meta Optimization
+└─ Use: Meta Description Generator + OpenGraph Generator
+└─ Output: Meta tags, social sharing ready
+└─ Time: 5-10 minutes
+
+Step 5: Image Optimization
+└─ Use: Image Alt Text Generator
+└─ Output: Alt text for all images
+└─ Time: 5 minutes
+
+Step 6: Final Optimization
+└─ Use: On-Page SEO Analyzer
+└─ Output: Score 80+, optimization checklist
+└─ Time: 10-15 minutes
+
+Step 7: Publishing
+└─ Output: Fully optimized page, ready to publish
+└─ Time: 5 minutes
+
+Total Time: 1.5-2 hours per article
+```
+
+### Workflow 2: Website Audit & Improvement
+
+Complete technical and content audit:
+
+```
+Step 1: Technical Audit
+└─ Use: Technical SEO Analyzer
+└─ Output: Technical issues by severity
+└─ Time: 15-30 minutes
+
+Step 2: Comprehensive Audit
+└─ Use: Enterprise SEO Suite
+└─ Output: Full audit report with recommendations
+└─ Time: 30-60 minutes
+
+Step 3: Gap Analysis
+└─ Use: Content Strategy Analyzer
+└─ Output: Content opportunities, recommendations
+└─ Time: 10-15 minutes
+
+Step 4: Prioritization
+└─ Use: AI Copilot (prioritize recommendations)
+└─ Output: Prioritized action plan
+└─ Time: 10 minutes
+
+Step 5: Implementation Planning
+└─ Output: Sprint plan, timeline, ownership
+└─ Time: 15 minutes
+
+Total Time: 1.5-2.5 hours for complete audit
+```
+
+### Workflow 3: Performance Optimization
+
+Optimize existing content for better rankings:
+
+```
+Step 1: Identify Underperforming Pages
+└─ Use: GA4 Dashboard integration
+└─ Output: Pages with ranking potential but low traffic
+└─ Time: 10 minutes
+
+Step 2: On-Page Analysis
+└─ Use: On-Page SEO Analyzer (batch analysis)
+└─ Output: Issues and improvement opportunities
+└─ Time: 5-10 minutes per page
+
+Step 3: Content Improvement
+└─ Use: AI Copilot (recommendations)
+└─ Output: Content improvement strategy
+└─ Time: 15-20 minutes
+
+Step 4: Meta Tag Update
+└─ Use: Meta Description Generator
+└─ Output: Improved meta descriptions
+└─ Time: 5 minutes
+
+Step 5: Performance Check
+└─ Use: PageSpeed Analyzer
+└─ Output: Performance baseline
+└─ Time: 10 minutes
+
+Step 6: Monitor & Adjust
+└─ Use: SEO Dashboard
+└─ Output: Track ranking changes
+└─ Time: Ongoing
+
+Total Time: 45-60 minutes per page
+```
+
+### Workflow 4: Monthly SEO Maintenance
+
+Regular maintenance for ongoing optimization:
+
+```
+Week 1: Technical Health
+└─ Task: Run Technical SEO Analyzer
+└─ Task: Check for new critical issues
+└─ Task: Fix issues reported
+└─ Time: 30-45 minutes
+
+Week 2: Performance Tracking
+└─ Task: Run PageSpeed Analyzer (key pages)
+└─ Task: Monitor Core Web Vitals
+└─ Task: Optimize top pages
+└─ Time: 30-45 minutes
+
+Week 3: Content Strategy
+└─ Task: Run Content Strategy Analyzer
+└─ Task: Identify new opportunities
+└─ Task: Update content calendar
+└─ Time: 30-45 minutes
+
+Week 4: Full Review
+└─ Task: Run Enterprise SEO Suite (selective)
+└─ Task: Compare metrics with previous month
+└─ Task: Plan next month strategy
+└─ Time: 60-90 minutes
+
+Total Monthly Time: 3-3.5 hours
+```
+
+---
+
+## Industry-Specific Workflows
+
+### E-Commerce SEO Workflow
+
+```
+1. Product Page Optimization
+   ├─ Upload product images
+   ├─ Generate alt text with product keywords
+   ├─ Create optimized meta descriptions with price mentions
+   ├─ Generate OpenGraph tags for social sharing
+   └─ Use On-Page SEO to optimize product pages
+
+2. Category Page Strategy
+   ├─ Analyze category page content
+   ├─ Check internal linking structure
+   ├─ Generate category-level meta descriptions
+   └─ Optimize for category keywords
+
+3. Competitive Pricing Analysis
+   ├─ Use Competitive Analysis tool
+   ├─ Compare product strategies
+   ├─ Identify market gaps
+   └─ Plan product expansion content
+
+4. Content Strategy
+   ├─ Use Content Strategy Analyzer
+   ├─ Identify buying guide opportunities
+   ├─ Plan comparison article strategy
+   └─ Create content calendar for seasonal products
+```
+
+### B2B SaaS Workflow
+
+```
+1. Service Page Optimization
+   ├─ Analyze existing service pages
+   ├─ Use On-Page SEO Analyzer for each page
+   ├─ Optimize meta descriptions for search intent
+   ├─ Generate OpenGraph tags for LinkedIn sharing
+   └─ Create internal linking strategy
+
+2. Blog Strategy
+   ├─ Use Content Strategy Analyzer
+   ├─ Identify industry trends
+   ├─ Plan thought leadership content
+   ├─ Create content pillar structure
+   └─ Use Blog Writer for content creation
+
+3. Integration & Case Studies
+   ├─ Document integration tutorials
+   ├─ Create case study content
+   ├─ Optimize images with alt text
+   ├─ Generate social sharing cards
+   └─ Use On-Page SEO for final optimization
+
+4. Technical Content
+   ├─ Document API usage
+   ├─ Create implementation guides
+   ├─ Optimize code snippet pages
+   └─ Use Technical SEO Analyzer for documentation site
+```
+
+### Content Publishing Workflow
+
+```
+1. Idea Generation & Planning
+   ├─ Run Content Strategy Analyzer
+   ├─ Identify top opportunities
+   ├─ Consult AI Copilot for ideas
+   ├─ Create content outline
+   └─ Research competitor content
+
+2. Content Creation
+   ├─ Write content using Blog Writer
+   ├─ Incorporate keywords naturally
+   ├─ Add high-quality images
+   ├─ Create internal linking plan
+   └─ Write call-to-action
+
+3. Pre-Publication Checks
+   ├─ Use On-Page SEO Analyzer
+   ├─ Fix issues identified
+   ├─ Ensure score is 80+
+   ├─ Check for keyword usage
+   └─ Verify internal links work
+
+4. Meta & Social Preparation
+   ├─ Generate meta description
+   ├─ Create OpenGraph tags (platform-specific)
+   ├─ Generate alt text for images
+   ├─ Create social media snippets
+   └─ Plan social promotion
+
+5. Publishing & Promotion
+   ├─ Schedule social media posts
+   ├─ Set up Google Search Console monitoring
+   ├─ Plan email announcement
+   ├─ Secure backlinks if applicable
+   └─ Monitor initial performance
+
+6. Post-Publication Monitoring
+   ├─ Check PageSpeed on published page
+   ├─ Monitor search console for queries
+   ├─ Track user metrics (engagement, bounce rate)
+   ├─ Wait 2-4 weeks for ranking
+   └─ Optimize based on performance
+```
+
+---
+
+## Quick Wins Workflow
+
+Fast SEO improvements with quick impact:
+
+### Day 1: Meta Description Optimization
+- Time: 30-45 minutes
+- Tool: Meta Description Generator
+- Target: 10-20 high-traffic pages
+- Expected Impact: 5-15% CTR improvement
+
+### Day 2: Image Optimization
+- Time: 30-45 minutes
+- Tool: Image Alt Text Generator
+- Target: All pages with images
+- Expected Impact: Image search traffic, accessibility boost
+
+### Day 3: Performance Optimization
+- Time: 45-60 minutes
+- Tool: PageSpeed Analyzer
+- Focus: Top 10-20 traffic pages
+- Expected Impact: Better rankings, improved UX
+
+### Day 4: Technical Cleanup
+- Time: 60-90 minutes
+- Tool: Technical SEO Analyzer
+- Focus: Fix critical and high issues
+- Expected Impact: Better crawlability, fewer errors
+
+### Day 5: On-Page Optimization
+- Time: 60-90 minutes
+- Tool: On-Page SEO Analyzer
+- Target: Target keyword pages
+- Expected Impact: Ranking improvements on target pages
+
+**Total Time: 4-5 hours**
+**Expected Impact: 20-40% organic traffic increase**
+
+---
+
+## Collaborative Workflows
+
+### Team of 2-3 People
+
+```
+Developer/DevOps
+├─ Technical SEO Analysis
+├─ PageSpeed Optimization
+├─ Site Performance Monitoring
+└─ Technical Implementation
+
+Content Team
+├─ Content Strategy Planning
+├─ Content Creation
+├─ Meta Optimization
+└─ Alt Text Generation
+
+Marketing Lead
+├─ Strategy & Planning
+├─ Competitive Analysis
+├─ Social Optimization
+└─ Performance Monitoring
+```
+
+### Team of 5+ People
+
+```
+SEO Manager
+├─ Strategy & Planning
+├─ Competitive Analysis
+├─ Tool Coordination
+└─ Performance Review
+
+Content Creators (2-3)
+├─ Content Creation
+├─ Research
+├─ Blog Writing
+└─ Image Sourcing
+
+Technical SEO Specialist
+├─ Technical Audits
+├─ Site Health Monitoring
+├─ Performance Optimization
+└─ Implementation
+
+Metadata Specialist
+├─ Meta Descriptions
+├─ Alt Text Generation
+├─ OpenGraph Tags
+└─ Schema Markup
+
+Analytics & Reporting
+├─ Performance Tracking
+├─ Reporting
+├─ Insights & Recommendations
+└─ Dashboard Management
+```
+
+---
+
+## Time-Based Workflows
+
+### 15-Minute Quick Check
+```
+1. Run PageSpeed Analyzer on homepage (5 min)
+2. Check for critical issues in Google Search Console (5 min)
+3. Run quick On-Page SEO check on top page (5 min)
+→ Time: 15 minutes
+```
+
+### 30-Minute Daily SEO Task
+```
+1. Create 2-3 optimized meta descriptions (10 min)
+2. Generate alt text for 5-10 images (10 min)
+3. Check PageSpeed on 2-3 pages (10 min)
+→ Time: 30 minutes
+→ Output: 2-3 pages optimized
+```
+
+### 60-Minute SEO Sprint
+```
+1. Run Technical SEO Analyzer (20 min)
+2. Fix 3-5 identified issues (20 min)
+3. Create content strategy plan for next sprint (20 min)
+→ Time: 60 minutes
+→ Output: Healthier site, content roadmap
+```
+
+### 2-Hour Deep Dive
+```
+1. Run Enterprise SEO Suite (30 min)
+2. Prioritize top 10 action items (15 min)
+3. Start implementation of top 3 items (45 min)
+4. Plan next steps (10 min)
+→ Time: 100 minutes
+→ Output: Clear action plan, started improvements
+```
+
+---
+
+## Common Challenges & Solutions
+
+### Challenge 1: Too Many Tools, Don't Know Where to Start
+**Solution:**
+1. Start with Enterprise SEO Suite for overview
+2. Identify top 5 issues from report
+3. Use specific tools to address each issue
+4. Create 90-day improvement plan
+
+### Challenge 2: Not Seeing Results Quickly
+**Solution:**
+1. Focus on high-impact improvements first
+2. Target quick wins in first month
+3. Implement fixes consistently
+4. Monitor progress weekly
+5. Give ranking changes 4-8 weeks
+
+### Challenge 3: Team Doesn't Know How to Use Tools
+**Solution:**
+1. Create team training session (30-60 min)
+2. Walk through each tool with examples
+3. Create workflow documentation
+4. Start with one tool per team member
+5. Gradually expand tool usage
+
+### Challenge 4: Content Strategy Unclear
+**Solution:**
+1. Run Content Strategy Analyzer monthly
+2. Consult AI Copilot for recommendations
+3. Create content calendar from findings
+4. Track performance of content created
+5. Adjust strategy based on results
+
+### Challenge 5: Continuous Monitoring
+**Solution:**
+1. Set monthly check schedule
+2. Assign ownership for each tool
+3. Create dashboard for tracking
+4. Weekly 30-minute check-in
+5. Monthly full review and planning
+
+---
+
+## Automation & Integration Tips
+
+### Use Google Sheets Integration
+```
+1. Use On-Page SEO Analyzer to get page scores
+2. Export results to Google Sheets
+3. Sort by score (low first)
+4. Create action items from sheet
+5. Track progress in sheet
+```
+
+### Create Task Management Integration
+```
+1. Run Technical SEO Analyzer
+2. Export critical issues
+3. Create tasks in project management tool
+4. Assign to team members
+5. Track completion rate
+```
+
+### Schedule Recurring Analysis
+```
+1. PageSpeed Analyzer: Weekly (top 10 pages)
+2. Content Strategy: Monthly (full)
+3. Technical SEO: Biweekly (key areas)
+4. Enterprise Suite: Quarterly (full site)
+5. Performance Review: Monthly
+```
+
+### Build Reporting Dashboard
+```
+1. Use GA4 Dashboard for traffic
+2. Use GSC Integration for search data
+3. Use tool results for SEO metrics
+4. Create monthly SEO report
+5. Share with stakeholders
+```
+
+---
+
+## Success Metrics by Workflow
+
+### Content Creation
+- Average ranking: Target top 10
+- Average traffic per article: 500+ views/month
+- Article publication rate: 4-8 per month
+- Content strategy alignment: 100%
+
+### Technical Improvement
+- Pages with issues: < 50 critical, < 200 medium
+- Site crawl errors: < 10
+- 404 redirects: < 5% of pages
+- Mobile usability issues: 0
+
+### Performance Optimization
+- Core Web Vitals: All green
+- Page load time: < 2.5 seconds
+- Mobile PageSpeed score: > 80
+- Desktop PageSpeed score: > 90
+
+### Content Strategy
+- Content gap coverage: 80%+ of opportunities
+- Publishing consistency: 4+ per month
+- Content topic distribution: Even
+- Competitor differentiation: Clear
+
+---
+
+## Workflow Troubleshooting
+
+### Tools Taking Too Long
+**Solution:**
+- Use smaller crawl depth for Technical SEO
+- Analyze fewer competitors initially
+- Run analyses during off-peak hours
+- Upgrade to premium for faster processing
+
+### Recommendations Not Relevant
+**Solution:**
+- Provide more context to AI Copilot
+- Use specific target keywords
+- Review your industry/niche setting
+- Consult recommendations, don't follow blindly
+
+### Difficulty Implementing Changes
+**Solution:**
+- Prioritize by impact score
+- Start with quick wins
+- Get developer help for technical items
+- Create implementation checklist
+- Track progress weekly
+
+### Team Not Adopting Workflows
+**Solution:**
+- Show clear ROI from tool usage
+- Provide training and documentation
+- Start with one team member
+- Celebrate early wins
+- Iterate workflows based on feedback
+
+---
+
+## Next Steps
+
+1. **Choose Your Workflow**: Pick a workflow from above
+2. **Schedule Time**: Block calendar for SEO tasks
+3. **Gather Team**: Assign responsibilities
+4. **Create Checklist**: Document your process
+5. **Start Implementation**: Take first step
+6. **Monitor Progress**: Track metrics weekly
+7. **Optimize**: Adjust workflow based on results
+8. **Scale**: Add more tools and tasks as comfortable
+
+---
+
+**Ready to implement a workflow? Start with [Content Creation Pipeline](#workflow-1-content-creation-pipeline) or see [Individual Tools Guide](individual-tools-guide.md) for tool details!**