Files
ALwrity/docs-site/docs/features/seo-dashboard/overview.md
ajaysi 644e72d289 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:44:15 +05:30

12 KiB

SEO Dashboard Overview

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.

🎯 What You Can Do

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

🔑 Key Features

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

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

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

  • 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

Current Implementation

  • GSC Login Button: Connect your Google Search Console account
  • Authentication Required: Must sign in with Google to access GSC features
  • Real Data Integration: When connected, shows actual search performance data
  • Platform Status: Dashboard shows connection status for Google, Bing, and other platforms

Available Features

  • Connection Status: See if GSC is connected and syncing
  • Data Points: Track number of data points imported
  • Last Sync: Monitor when data was last updated
  • Performance Data: Real search queries, clicks, and impressions (when connected)

Setup Process

  1. Sign In: Use your Google account to authenticate
  2. Connect GSC: Click the "Connect Google Search Console" button
  3. Authorize Access: Grant permissions for data access
  4. Data Sync: System automatically imports your search data

How to Use the SEO Dashboard

Getting Started

  1. Sign In: Use your Google account to access the dashboard
  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 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 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 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 weekly or monthly reviews to measure progress

Best Practices for All Users

Start Simple

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

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

Advanced Features

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

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

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.


Getting Started

  1. Tools Reference - Overview of all 21 SEO tools
  2. GSC Integration - Connect Google Search Console
  3. Metadata Guide - Learn about metadata generation
  4. AI Copilot Guide - Use the AI assistant effectively
  5. Best Practices - SEO optimization tips

Ready to optimize your SEO? Start with Tools Reference to explore all 21 tools, or check out our GSC Integration Guide to connect your search data!