kunthawat/ALwrity
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9b3bec698b7429f80a0d6266bd77d1ab85c84faa
ALwrity/docs-site/docs/features/seo-dashboard/tools-reference.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
Raw Blame History

ALwrity SEO Tools Suite - Complete Reference

🎯 Overview

ALwrity provides a comprehensive suite of 21 production-ready SEO tools designed to help content creators, digital marketers, and SEO professionals optimize their web presence. All tools are powered by advanced AI (Gemini LLM) and integrate seamlessly with major search platforms.

📊 Tool Categories

Individual Analysis Tools (9)

These tools provide focused, single-purpose analysis for specific SEO aspects:

1. 📝 Meta Description Generator

  • Purpose: Generate SEO-optimized meta descriptions
  • AI Model: Gemini LLM with keyword analysis
  • Inputs: Keywords, tone, search intent, language
  • Outputs: Multiple meta descriptions with SEO scoring
  • API: POST /api/seo/meta-description
  • Use Case: Quick meta tag creation for new or existing pages

2. ⚡ PageSpeed Analyzer

  • Purpose: Google PageSpeed Insights analysis with AI insights
  • Source: Google PageSpeed API
  • Features: Desktop & mobile analysis, Core Web Vitals, opportunities
  • Outputs: Performance scores, optimization opportunities, business impact analysis
  • API: POST /api/seo/pagespeed-analysis
  • Key Metrics: LCP, FID, CLS, load time

3. 🗺️ Sitemap Analyzer

  • Purpose: Website structure and content trends analysis
  • Capabilities: URL patterns, publishing velocity, content distribution
  • Analysis: Content trends, publishing patterns, SEO recommendations
  • Outputs: Structure quality, content strategy insights, growth recommendations
  • API: POST /api/seo/sitemap-analysis
  • Best For: Content strategy planning and competitive benchmarking

4. 🖼️ Image Alt Text Generator

  • Purpose: Vision-based SEO-optimized alt text
  • AI Model: Vision models + context analysis
  • Input Methods: File upload or URL
  • Outputs: Alt text, keyword analysis, accessibility score
  • API: POST /api/seo/image-alt-text
  • Features: Context-aware, keyword integration, accessibility optimization

5. 📱 OpenGraph Generator

  • Purpose: Social media optimization tags
  • Platforms: Facebook, Twitter, LinkedIn, Pinterest
  • Outputs: Platform-specific og: tags, HTML ready to use
  • API: POST /api/seo/opengraph-tags
  • Enhancement: Increases social sharing and engagement

6. 📄 On-Page SEO Analyzer

  • Purpose: Comprehensive on-page analysis
  • Analyzes: Meta tags, content quality, keyword optimization, internal links
  • Scoring: Overall score (0-100) with component breakdown
  • Outputs: Critical issues, warnings, actionable recommendations
  • API: POST /api/seo/on-page-analysis
  • Best For: Page-level optimization audits

7. 🔧 Technical SEO Analyzer

  • Purpose: Site crawling and technical audit
  • Capabilities: Crawl depth 1-5, external link analysis, performance metrics
  • Issues: Robots.txt, sitemap, canonicalization, redirects, broken links
  • Outputs: Issues by severity, comprehensive recommendations
  • API: POST /api/seo/technical-seo
  • Best For: Technical SEO audits and issue identification

8. 🏢 Enterprise SEO Suite

  • Purpose: Complete website audit workflows
  • Features: End-to-end audits, multi-competitor comparison
  • Outputs: Executive summary, detailed audit report, action plans
  • API: POST /api/seo/workflow/website-audit
  • Best For: Comprehensive audits and executive reporting

9. 📊 Content Strategy Analyzer

  • Purpose: Content gap analysis and strategy planning
  • Features: Competitor analysis, topic opportunities, keyword scoring
  • Outputs: Content gaps, opportunities, competitive positioning
  • API: POST /api/seo/workflow/content-analysis
  • Best For: Content planning and opportunity identification

Dashboard & Integration Tools (12)

These tools provide real-time monitoring, analytics integration, and AI-powered insights:

10. 🎨 SEO Dashboard

  • Core Component: Main SEO monitoring interface
  • Features: Health score, real-time metrics, platform integrations
  • Updates: Real-time data sync with platforms
  • Integrations: GSC, GA4, Bing Webmaster
  • Best For: Daily SEO monitoring and performance tracking

11. 🔗 Google Search Console Integration

  • Data Source: Real GSC data
  • Metrics: Queries, clicks, impressions, rankings
  • OAuth: Secure Google OAuth 2.0 authentication
  • Features: Real-time data sync, performance tracking
  • API: GET /api/seo-dashboard/gsc/raw

12. 🔍 Bing Webmaster Integration

  • Data Source: Real Bing data
  • Metrics: Bing-specific rankings, crawl information
  • OAuth: Microsoft OAuth 2.0 authentication
  • Features: Bing-specific insights and recommendations
  • API: GET /api/seo-dashboard/bing/raw

13. 📈 Google Analytics 4 Integration

  • Component: PlatformAnalytics
  • Metrics: Traffic, behavior, conversions, custom events
  • OAuth: Secure GA4 authentication
  • Real-Time: Real-time traffic monitoring
  • Best For: Understanding traffic sources and user behavior

14. 🎯 Health Score System

  • Scoring: 0-100 scale (0 = poor, 100 = excellent)
  • Breakdown: Technical, content, performance, mobile scores
  • Trends: Daily/weekly/monthly tracking
  • Recommendations: AI-generated improvement suggestions
  • API: GET /api/seo-dashboard/health-score

15. 💡 AI Copilot Assistant

  • Interface: Conversational AI recommendations
  • Power: CopilotKit + Gemini LLM
  • Features: Context-aware, multi-tool orchestration
  • Action Buttons: Direct access to relevant tools
  • Best For: Getting smart SEO guidance naturally

16-21. Competitive & Strategic Tools

See next section...

Competitive & Strategic Tools (6)

16. 🏆 Competitive Analysis

  • Source: Exa API semantic search
  • Features: Competitor discovery, content comparison
  • Metrics: Trust score, content volume, publishing frequency
  • Outputs: Competitor insights, market positioning
  • API: GET /api/seo-dashboard/competitive-insights

17. 📊 Sitemap Benchmarking

  • Features: Content structure comparison across competitors
  • Metrics: Structure quality, content volume, publishing velocity
  • Time: Runs in background (async processing)
  • Outputs: Competitive benchmarking report
  • API: POST/GET /api/seo/competitive-sitemap-benchmarking

18. 🎭 Deep Competitor Analysis

  • Depth: In-depth competitive intelligence
  • Features: Market positioning, advantages, content strategy
  • Outputs: Competitive advantages, market opportunities
  • API: GET /api/seo-dashboard/deep-competitor-analysis

19. 💬 Strategic Insights

  • Frequency: Weekly strategy briefs
  • Features: AI-powered recommendations
  • Tracking: Historical insights and patterns
  • Outputs: Weekly strategy recommendations
  • API: GET /api/seo-dashboard/strategic-insights/history

20. 🧠 Semantic Health Monitoring (Phase 2B)

  • Real-Time: Continuous semantic analysis
  • Features: Entity recognition, relevance tracking
  • Outputs: Health metrics, relevance scores
  • Best For: Advanced SEO professionals

21. ✍️ Blog SEO Integration

  • Location: In-editor assistance
  • Features: Live SEO suggestions while writing
  • Interface: SEO Mini Panel in blog editor
  • Best For: Writers optimizing content in real-time

🔌 Platform Integrations

Search Engines

  • ✅ Google Search Console - Real-time search performance
  • ✅ Google Analytics 4 - Traffic and behavior analytics
  • ✅ Bing Webmaster Tools - Bing-specific insights

External APIs

  • ✅ Google PageSpeed Insights - Performance analysis
  • ✅ Exa API - Semantic search and competitor discovery
  • ✅ Vision APIs - Image analysis for alt text generation

Authentication

  • ✅ Google OAuth 2.0 - GSC and GA4
  • ✅ Microsoft OAuth 2.0 - Bing integration
  • ✅ Clerk Authentication - User management

📚 Documentation

Getting Started

Tool-Specific Guides

Advanced Guides

🚀 Quick Start by Use Case

For Content Creators

  1. Use Meta Description Generator for quick SEO tags
  2. Run On-Page SEO Analyzer before publishing
  3. Monitor Blog SEO Integration while writing
  4. Track performance in SEO Dashboard

For Digital Marketers

  1. Set up SEO Dashboard with GSC/GA4
  2. Run Competitive Analysis to identify opportunities
  3. Use Content Strategy Analyzer for planning
  4. Use AI Copilot for strategic recommendations

For SEO Professionals

  1. Perform Complete Website Audit for full assessment
  2. Use Technical SEO Analyzer for technical issues
  3. Run Competitive Sitemap Benchmarking for positioning
  4. Monitor Strategic Insights weekly
  5. Use Semantic Health Monitoring for advanced tracking

For E-commerce Businesses

  1. Analyze Product Page SEO with On-Page tool
  2. Use Image Alt Text Generator for product images
  3. Monitor Core Web Vitals with PageSpeed Analyzer
  4. Track Keyword Rankings in Dashboard
  5. Compare with Competitive Analysis

📊 API Statistics

  • Total Endpoints: 22+
  • Individual Tools: 9 endpoints
  • Dashboard: 8+ endpoints
  • Workflows: 3 endpoints
  • Response Time: 2-30 seconds depending on tool
  • Async Support: Background processing for long-running tasks

🎯 Key Features Across All Tools

AI-Powered

  • Gemini LLM integration
  • Vision model support
  • Natural language processing
  • Semantic analysis

Enterprise-Ready

  • Comprehensive error handling
  • Intelligent logging
  • Rate limiting
  • Scalable architecture

User-Friendly

  • Clear, actionable recommendations
  • Priority-based insights
  • Real-time analysis
  • Mobile-responsive interface

Secure

  • OAuth 2.0 authentication
  • Encrypted token storage
  • Request validation
  • CORS protection

📈 Performance Benchmarks

Tool Response Time Async Typical Use
Meta Description 2-3s No Quick SEO tag creation
PageSpeed 5-8s No Performance analysis
Sitemap Analysis 10-15s No Content structure review
On-Page SEO 8-12s No Page optimization
Technical SEO 15-30s No Full site crawl
Website Audit 30-60s No Comprehensive audit
Sitemap Benchmarking 2-5s Yes Background processing
Dashboard <1s N/A Cached data display

🎓 Learning Resources

  • Guides: Step-by-step tutorials for each tool
  • API Docs: Complete endpoint documentation
  • Best Practices: Optimization tips and strategies
  • Case Studies: Real-world application examples
  • Video Tutorials: Visual learning resources (planned)

🔮 Roadmap

Near-Term (Q3 2026)

  • Complete Phase 2B semantic monitoring
  • Add Screaming Frog integration
  • Enhance mobile responsiveness

Medium-Term (Q4 2026)

  • Machine learning-based predictions
  • Advanced anomaly detection
  • Automated content recommendations

Long-Term (2027)

  • Mobile app development
  • White-label solutions
  • API marketplace

💡 Tips & Best Practices

  1. Start with Health Score - Get overall assessment first
  2. Focus on High-Priority Issues - Address critical problems first
  3. Use AI Copilot - Get smart, contextual recommendations
  4. Monitor Regularly - Weekly checks keep you on track
  5. Benchmark Competitors - Use competitive analysis to find opportunities
  6. Track Changes - Use trends to measure progress

🔗 Related Resources

Last Updated: May 18, 2026
Version: 1.0
Status: Production Ready ✅

For support, visit our documentation or contact support@alwrity.com

Reference in New Issue View Git Blame Copy Permalink