Skip to content

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

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

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

✅ Implementation Alignment (May 2026)

The following endpoints are currently mounted and used by the active SEO Dashboard implementation:

Analysis Execution

  • POST /api/seo-dashboard/analyze-comprehensive
  • POST /api/seo-dashboard/analyze-full
  • POST /api/seo-dashboard/batch-analyze
  • POST /api/seo-dashboard/analyze-urls-ai

Dashboard Data & Reporting

  • GET /api/seo-dashboard/data
  • GET /api/seo-dashboard/overview
  • GET /api/seo-dashboard/metrics
  • GET /api/seo-dashboard/metrics-detailed
  • GET /api/seo-dashboard/analysis-summary
  • GET /api/seo-dashboard/health-score
  • GET /api/seo-dashboard/insights

Integrations

  • GET /api/seo-dashboard/platforms
  • GET /api/seo-dashboard/gsc/raw
  • GET /api/seo-dashboard/bing/raw
  • POST /api/seo-dashboard/refresh

Competitive & Strategic Intelligence

  • GET /api/seo-dashboard/competitive-insights
  • GET /api/seo-dashboard/deep-competitor-analysis
  • POST /api/seo-dashboard/strategic-insights/run
  • GET /api/seo-dashboard/strategic-insights/history

Operations & Health

  • GET /api/seo-dashboard/health
  • GET /api/seo-dashboard/semantic-health
  • GET /api/seo-dashboard/sif-health
  • GET /api/seo-dashboard/cache-stats
  • GET /api/seo-dashboard/onboarding-task-health

Source-of-Truth Code Paths

  • Frontend dashboard: frontend/src/components/SEODashboard/
  • Frontend API clients: frontend/src/api/seoDashboard.ts, frontend/src/api/seoAnalysis.ts
  • Backend API router: backend/api/seo_dashboard.py
  • Backend SEO service: backend/services/seo/dashboard_service.py

🆕 Recent SEO Enhancements (Reviewed: May 25, 2026)

The SEO stack has expanded beyond core URL analysis. Based on the current frontend/backend code and latest SEO docs, these additions should be considered part of the current docs-site surface:

Dashboard + API enhancements

  • Strategic insights execution and history (/api/seo-dashboard/strategic-insights/run, /api/seo-dashboard/strategic-insights/history)
  • Deep competitor analysis endpoint (/api/seo-dashboard/deep-competitor-analysis)
  • Onboarding task health visibility (/api/seo-dashboard/onboarding-task-health)
  • Operational diagnostics (/api/seo-dashboard/semantic-health, /api/seo-dashboard/sif-health, /api/seo-dashboard/cache-stats)
  • Route aliases active in app routing: /seo and /seo-dashboard

Workflow enhancements connected to SEO

  • Blog Writer now includes GSC-powered brainstorming flows (frontend/src/components/BlogWriter/GSCBrainstormModal.tsx, backend/services/gsc_brainstorm_service.py)
  • SEO guidance is available both in dashboard workflows and in-editor Blog Writer SEO modules (e.g., SEOMiniPanel, SEOAnalysisModal, SEOMetadataModal)

Source docs reviewed for enhancement tracking

  • docs/SEO/COMPLETE_SEO_TOOLS_INVENTORY.md
  • docs/SEO/API_REFERENCE.md
  • docs/SEO/PHASE2A_IMPLEMENTATION.md
  • docs/SEO/MIGRATION_STATUS_ANALYSIS.md
  • docs/SEO/MIGRATION_DETAILED_GAPS.md
  • docs/SEO/MIGRATION_EXECUTIVE_SUMMARY.md