kunthawat/ALwrity
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Brainstorm Topics with GSC + Issue #518 fixes + Blog Editor enhancements

Browse Source 
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
2026-05-20 22:34:37 +05:30
parent 68190dedb3
commit 644e72d289
98 changed files with 16137 additions and 2501 deletions
Download Patch File Download Diff File Expand all files Collapse all files

288
docs-site/docs/features/seo-dashboard/overview.md
View File

@@ -1,74 +1,143 @@
# SEO Dashboard Overview
The ALwrity SEO Dashboard provides comprehensive SEO analysis and optimization tools to help you improve your website's search engine visibility and performance. It's designed for users with medium to low technical knowledge, making SEO optimization accessible to everyone.
The ALwrity SEO Dashboard is a comprehensive, AI-powered platform providing **21 production-ready SEO tools** for content creators, digital marketers, and SEO professionals. Designed for users of all technical levels, it combines advanced AI analysis with real-time platform integrations for actionable SEO insights.
## Key Features
## 🎯 What You Can Do
### 🔍 Real-Time SEO Analysis
- **URL Analysis**: Analyze any website URL for comprehensive SEO performance
- **Progressive Analysis**: Real-time analysis with smart timeout handling
- **Health Scoring**: Get an overall SEO health score (0-100) with detailed breakdown
- **AI Insights**: Receive personalized recommendations based on your analysis
The SEO Dashboard enables you to:
- **Analyze Individual Pages** - Get detailed on-page SEO analysis
- **Generate Metadata** - Create optimized titles and descriptions
- **Audit Technical SEO** - Identify and fix technical issues
- **Monitor Performance** - Track real search rankings and traffic
- **Analyze Competitors** - Identify market opportunities
- **Plan Content Strategy** - Find content gaps and opportunities
- **Optimize Images** - Generate SEO-friendly alt text
- **Track Progress** - Monitor improvements over time
### 📊 Performance Dashboard
- **Mock Data Display**: Currently shows sample performance metrics (traffic, rankings, mobile speed)
- **Google Search Console Integration**: Connect your GSC account for real search data
- **Authentication Required**: Sign in with Google to access all features
- **Freshness Tracking**: Monitor when your data was last updated
## 🔑 Key Features
### 🎯 Comprehensive Analysis Categories
- **Technical SEO**: Site structure, sitemaps, robots.txt, and technical elements
- **Content Analysis**: Content quality, relevance, and optimization
- **Performance Metrics**: Page speed, loading times, and Core Web Vitals
- **Accessibility**: How accessible your site is to all users
- **User Experience**: Site usability and navigation
- **Security**: HTTPS implementation and security headers
### 📊 **9 Individual Analysis Tools**
- Meta Description Generator
- PageSpeed Analyzer
- Sitemap Analyzer
- Image Alt Text Generator
- OpenGraph Generator
- On-Page SEO Analyzer
- Technical SEO Analyzer
- Enterprise SEO Suite
- Content Strategy Analyzer
### 📈 **Real-Time Integrations**
- **Google Search Console** - Real search performance data
- **Google Analytics 4** - Traffic and behavior analytics
- **Bing Webmaster Tools** - Bing-specific insights
- **PageSpeed Insights** - Performance analysis
- **Exa API** - Competitor discovery
### 🤖 **AI-Powered Insights**
- **Health Score** (0-100) - Overall SEO assessment
- **AI Copilot** - Conversational recommendations
- **Smart Recommendations** - Priority-based suggestions
- **Competitive Analysis** - Market positioning insights
- **Strategic Insights** - Weekly strategy briefs
### 🎨 **Comprehensive Analysis**
- **Technical SEO**: Site structure, crawlability, indexability
- **On-Page SEO**: Meta tags, content quality, optimization
- **Content Analysis**: Quality, relevance, strategy alignment
- **Performance**: Core Web Vitals, page speed, load times
- **Competitive Positioning**: Benchmarking, market gaps
- **Accessibility**: WCAG compliance, user experience
## Dashboard Components
### 1. Performance Overview Cards
The dashboard displays key metrics in easy-to-read cards:
- **Organic Traffic**: 12,500 visitors (+15% growth) - Shows your monthly organic traffic
- **Average Ranking**: 8.5 position (+2.3 improvement) - Your average position in search results
- **Mobile Speed**: 92 score (-3 decline) - Mobile performance score
- **Keywords Tracked**: 150 keywords (+12 new) - Number of keywords you're monitoring
The dashboard displays key metrics at a glance:
- **Organic Traffic**: Monthly organic search traffic with growth trends
- **Average Ranking**: Average keyword position in search results
- **Mobile Speed**: Mobile performance score and Core Web Vitals
- **Keywords Tracked**: Number of keywords you're monitoring
### 2. SEO Analyzer Panel
- **URL Input Field**: Enter any website URL to analyze
- **Analysis Button**: Start comprehensive SEO analysis
- **Real-time Progress**: Watch analysis progress with live updates
- **Results Display**: Get detailed breakdown of SEO performance
### 2. SEO Analysis Tools
Choose from **9 specialized tools** for specific analysis needs:
| Tool | Purpose | Best For |
|------|---------|----------|
| 📝 Meta Description Generator | Create SEO meta tags | Quick metadata creation |
| ⚡ PageSpeed Analyzer | Google PageSpeed analysis | Performance optimization |
| 🗺️ Sitemap Analyzer | Content structure review | Strategy planning |
| 🖼️ Image Alt Text Generator | Vision-based image optimization | Accessibility & SEO |
| 📱 OpenGraph Generator | Social media tags | Social sharing |
| 📄 On-Page SEO Analyzer | Complete page analysis | Page optimization |
| 🔧 Technical SEO Analyzer | Site crawling & audit | Technical fixes |
| 🏢 Enterprise SEO Suite | Full website audit | Comprehensive assessment |
| 📊 Content Strategy Analyzer | Content gap analysis | Content planning |
### 3. AI Insights Panel
Receive intelligent recommendations organized by priority:
Get intelligent, priority-ranked recommendations:
- **High Priority**: Critical issues requiring immediate action
- **Medium Priority**: Important improvements for better performance
- **Low Priority**: Nice-to-have optimizations
- **Low Priority**: Nice-to-have optimizations for refinement
### 4. Platform Integration Dashboard
View connection status for all platforms:
- **Google Search Console** - Real search performance data
- **Google Analytics 4** - Traffic and user behavior
- **Bing Webmaster Tools** - Bing-specific insights
- **Status Indicators** - Connected, disconnected, or error states
## SEO Analysis Features
### What You Get When You Analyze a URL
When you run an SEO analysis, you receive:
### Individual Tools Analysis
When you run an SEO analysis using any of the 9 tools, you receive:
#### Overall Assessment
- **Health Score**: A single number (0-100) representing your SEO health
- **Health Status**: Excellent, Good, Needs Improvement, or Poor
- **Health Status**: Excellent (90-100), Good (80-89), Needs Improvement (70-79), Poor (<70)
- **Analysis Timestamp**: When the analysis was performed
- **Execution Time**: How long the analysis took
#### Detailed Breakdown by Category
- **URL Structure Score**: How well-organized your URLs are
- **Meta Data Score**: Title tags, descriptions, and headers optimization
- **Content Analysis Score**: Content quality, relevance, and optimization
- **Technical SEO Score**: Site structure, sitemaps, robots.txt
- **Performance Score**: Page speed and loading times
- **Accessibility Score**: How accessible your site is to all users
- **User Experience Score**: Site usability and navigation
- **Security Score**: HTTPS implementation and security headers
- **Meta Data Score**: Title, description, header optimization
- **Content Quality Score**: Readability, relevance, optimization
- **Technical SEO Score**: Site structure, crawlability, indexability
- **Performance Score**: Page speed and Core Web Vitals
- **Mobile Optimization**: Mobile-specific performance
- **Accessibility Score**: WCAG compliance and accessibility
- **Security Score**: HTTPS and security implementation
#### Actionable Insights
- **Critical Issues**: Problems that hurt your rankings (must fix)
- **Warnings**: Issues that could become problems (should fix)
- **Recommendations**: Specific steps to improve your SEO (nice to fix)
- **Priority Actions**: Top 3 things to focus on
### Workflow Analysis
#### Website Audit Workflow
Complete analysis combining:
- On-page SEO analysis
- Technical SEO crawling
- Performance optimization
- Competitive intelligence
- Executive summary with action plan
#### Content Strategy Workflow
Content planning analysis including:
- Content gap identification
- Opportunity scoring
- Competitive positioning
- Topic recommendations
- Publishing strategy
#### Competitive Analysis Workflow
Market intelligence including:
- Competitor discovery
- Content benchmarking
- Keyword comparison
- Market positioning
- Growth opportunities
## Google Search Console Integration
@@ -94,61 +163,120 @@ When you run an SEO analysis, you receive:
### Getting Started
1. **Sign In**: Use your Google account to access the dashboard
2. **Connect GSC**: Link your Google Search Console for real data (optional)
3. **Enter Website URL**: Add your website URL to the analyzer
4. **Run Analysis**: Click analyze to get comprehensive SEO insights
2. **Connect Platforms**: Link GSC, GA4, and Bing for real data (optional but recommended)
3. **Choose Your Tool**: Select from 9 individual analysis tools or workflow options
4. **Run Analysis**: Input your URL and start the analysis
### Daily Workflow
1. **Check Performance Overview**: Monitor your key metrics cards
2. **Review AI Insights**: Look for new recommendations and priority alerts
3. **Run URL Analysis**: Analyze specific pages that need attention
4. **Track Progress**: Use the refresh button to get updated analysis
1. **Check Health Score**: Monitor your overall SEO health
2. **Review AI Insights**: Look for new recommendations and alerts
3. **Run Targeted Analysis**: Use specific tools for pages needing attention
4. **Track Progress**: Monitor improvements over time
### Monthly Workflow
1. **Run Full Audit**: Use Enterprise SEO Suite for comprehensive assessment
2. **Competitive Analysis**: Run sitemap benchmarking against competitors
3. **Review Strategic Insights**: Get AI-powered weekly strategy recommendations
4. **Content Planning**: Use content strategy analyzer to plan next month's content
### Understanding Your Results
- **Health Score 90-100**: Excellent SEO performance
- **Health Score 80-89**: Good performance with minor improvements needed
- **Health Score 70-79**: Average performance requiring attention
- **Health Score Below 70**: Poor performance needing immediate action
#### Health Score Interpretation
- **90-100 (Excellent)**: Your site has excellent SEO health
- **80-89 (Good)**: Good performance with minor improvements
- **70-79 (Needs Improvement)**: Average performance requiring attention
- **Below 70 (Poor)**: Significant issues requiring immediate action
#### When to Use Each Tool
**For Content Creators**:
- Use **On-Page SEO Analyzer** before publishing
- Use **Meta Description Generator** for quick tags
- Use **Image Alt Text Generator** for images
- Use **OpenGraph Generator** for social sharing
**For Technical Teams**:
- Use **Technical SEO Analyzer** for crawl/index issues
- Use **PageSpeed Analyzer** for performance optimization
- Use **Sitemap Analyzer** for structure review
- Use **Enterprise SEO Suite** for comprehensive audits
**For Marketers**:
- Use **Content Strategy Analyzer** for planning
- Use **Competitive Analysis** for market insights
- Use **Health Score** for progress tracking
- Use **Strategic Insights** for weekly briefings
### Making Improvements
1. **Focus on Critical Issues**: Address problems that hurt your rankings first
2. **Implement Recommendations**: Follow the step-by-step suggestions
1. **Focus on Critical Issues**: Address problems that hurt rankings first
2. **Implement Recommendations**: Follow the AI suggestions step by step
3. **Monitor Progress**: Re-run analysis to see improvements
4. **Track Changes**: Use the freshness indicator to know when to refresh
4. **Track Changes**: Use weekly or monthly reviews to measure progress
## Best Practices for Non-Technical Users
## Best Practices for All Users
### Start Simple
1. **Focus on Critical Issues**: Address problems that hurt your rankings first
2. **One Thing at a Time**: Don't try to fix everything at once
3. **Use the Recommendations**: Follow the AI suggestions step by step
4. **Track Your Progress**: Re-run analysis monthly to see improvements
1. **Check Your Health Score**: Get your overall assessment
2. **Review Critical Issues**: Fix high-priority problems first
3. **Implement Top Recommendations**: Focus on quick wins
4. **Track Your Progress**: Re-check after 2-4 weeks
### What to Prioritize
1. **Page Speed**: Fast-loading pages rank better
2. **Mobile-Friendly**: Make sure your site works on phones
3. **Content Quality**: Write helpful, original content
4. **Technical Issues**: Fix broken links and errors
1. **Core Web Vitals**: Fast-loading pages rank better
2. **Mobile Optimization**: Over 60% of searches are mobile
3. **Content Quality**: Helpful, original content wins
4. **Technical Fixes**: Fix broken links and errors
### Don't Worry About
- Complex technical SEO (leave that to developers if needed)
- Perfect scores (aim for improvement, not perfection)
- Every single recommendation (focus on high-priority items)
- Frequent changes (monthly analysis is usually enough)
### Monthly Best Practices
1. **Run Full Audit**: Use Enterprise SEO Suite monthly
2. **Check Competitors**: Run competitive analysis quarterly
3. **Review Analytics**: Check real traffic from GSC/GA4 monthly
4. **Plan Content**: Use content strategy tool for next month
## Getting Started
### Advanced Features
1. **[GSC Integration](gsc-integration.md)** - Connect Google Search Console for real data
2. **[Analysis Guide](metadata.md)** - Learn how to read your SEO analysis results
3. **[Best Practices](../../guides/best-practices.md)** - Simple SEO optimization tips
#### For Power Users
- **AI Copilot**: Get conversational SEO guidance
- **Semantic Health Monitoring**: Phase 2B real-time analysis
- **Deep Competitor Analysis**: In-depth market intelligence
- **Strategic Insights**: Weekly AI-powered briefings
## Related Features
#### Integration with Other Tools
- **Blog Writer**: SEO optimization while writing
- **Content Strategy**: Strategic planning and gap analysis
- **YouTube Creator**: SEO keywords for video optimization
- **Podcast Dashboard**: Content distribution optimization
- **[Blog Writer](../blog-writer/overview.md)** - Content creation with SEO
- **[Content Strategy](../content-strategy/overview.md)** - Strategic planning
- **[AI Features](../ai/grounding-ui.md)** - Advanced AI capabilities
- **[API Reference](../../api/overview.md)** - Technical integration
## SEO Tools Overview
### Quick Reference
The SEO Dashboard includes 21 production-ready tools organized into three categories:
**Individual Tools** (9) - Focused analysis for specific SEO aspects
**Dashboard Tools** (12) - Real-time monitoring, AI insights, integrations
**Workflows** (Included) - Multi-step analysis for comprehensive assessment
For detailed information about each tool, see [Tools Reference](tools-reference.md).
---
*Ready to optimize your SEO? Check out our [GSC Integration Guide](gsc-integration.md) to get started!*
## Getting Started
1. **[Tools Reference](tools-reference.md)** - Overview of all 21 SEO tools
2. **[GSC Integration](gsc-integration.md)** - Connect Google Search Console
3. **[Metadata Guide](metadata.md)** - Learn about metadata generation
4. **[AI Copilot Guide](ai-copilot.md)** - Use the AI assistant effectively
5. **[Best Practices](../../guides/best-practices.md)** - SEO optimization tips
## Related Features
- **[Blog Writer](../blog-writer/overview.md)** - Content creation with integrated SEO
- **[Content Strategy](../content-strategy/overview.md)** - Strategic planning and gaps
- **[AI Features](../ai/overview.md)** - Advanced AI capabilities
- **[Persona System](../persona/overview.md)** - Personalized writing assistants
- **[API Reference](../../api/seo-tools.md)** - Technical integration details
---
*Ready to optimize your SEO? Start with [Tools Reference](tools-reference.md) to explore all 21 tools, or check out our [GSC Integration Guide](gsc-integration.md) to connect your search data!*