923fa671fe
ContentGuardianAgent consolidation:
- Merge 3 duplicate classes into single source in specialized/content_guardian.py
- Watchdog audit_committee() with heuristic scoring, coverage gaps, overlaps, alerts
- Remove misleading rejection_rate() helper; use acceptance_rate directly
- Integrate audit + alerts + trend signals into today_workflow_service.py
Team Activity page:
- QualityAuditPanel: health ring, per-agent critiques, coverage gaps, overlaps
- TrendSignalsPanel: opportunity cards with urgency/impact/coverage bars
- AlertBanner: persistent dismiss via POST /alerts/{id}/mark-read
- AgentHelpModal: dialog showing all 8 agents with descriptions, tools, schedule
- QualityAuditPanel action buttons: Fill gap -> /content-planning, Resolve overlap, View CTA on alerts/issues
- TrendSignalsPanel action buttons: Create content from this trend -> /blog-writer with trend context state
Onboarding system:
- Step 4 validation: no auto-pass via basic_ready; requires persona data or explicit progression
- Step 5 validation: logs warning on auto-pass without integration data
- OnboardingCompletionService: single DB session, transactional task creation, upsert pattern
- Business-without-website: nullable website_url on SIFIndexingTask and MarketTrendsTask
- DeepCompetitorAnalysisExecutor: 5-min timeout, 10-competitor cap, asyncio.wait_for
- Persona generation: async with 30s timeout, falls back to scheduler
- OnboardingProgressService.reset_onboarding(): resets session + pauses all DB tasks
- OnboardingControlService.reset_onboarding(): also cancels APScheduler jobs
- FinalStep TaskSchedulingPanel: shows scheduled/failed tasks after completion, 8s auto-redirect
- onboarding_completed agent activity event logged to feed
Documentation:
- docs-site/features/onboarding/: overview, steps, scheduler-tasks, technical-reference (4 pages)
- docs-site/mkdocs.yml: added Onboarding System nav section
- docs-site/features/sif-agents/: overview, agent-directory, committee-system, content-guardian (4 pages)
- docs-site/features/team-activity/: overview, quality-audit, trend-signals, alert-system (4 pages)
- docs-site/features/todays-workflow/: updated overview, technical-architecture, workflow-guide, api-reference
AI SEO Tools Services
Overview
Professional-grade AI-powered SEO analysis tools converted from Streamlit apps to FastAPI services. Designed for content creators, digital marketers, and solopreneurs.
Available Services
🎯 Meta Description Generator
- Service:
MetaDescriptionService - Purpose: Generate compelling, SEO-optimized meta descriptions
- AI Features: Context-aware generation, keyword optimization, tone adaptation
⚡ PageSpeed Analyzer
- Service:
PageSpeedService - Purpose: Google PageSpeed Insights analysis with AI insights
- AI Features: Performance optimization recommendations, business impact analysis
🗺️ Sitemap Analyzer
- Service:
SitemapService - Purpose: Website structure and content trend analysis
- AI Features: Content strategy insights, publishing pattern analysis
🖼️ Image Alt Text Generator
- Service:
ImageAltService - Purpose: AI-powered alt text generation for images
- AI Features: Vision-based analysis, SEO-optimized descriptions
📱 OpenGraph Generator
- Service:
OpenGraphService - Purpose: Social media optimization tags
- AI Features: Platform-specific optimization, content analysis
📄 On-Page SEO Analyzer
- Service:
OnPageSEOService - Purpose: Comprehensive on-page SEO analysis
- AI Features: Content quality analysis, keyword optimization insights
🔧 Technical SEO Analyzer
- Service:
TechnicalSEOService - Purpose: Website crawling and technical analysis
- AI Features: Issue prioritization, fix recommendations
🏢 Enterprise SEO Suite
- Service:
EnterpriseSEOService - Purpose: Complete SEO audit workflows
- AI Features: Competitive analysis, strategic recommendations
📊 Content Strategy Analyzer
- Service:
ContentStrategyService - Purpose: Content gap analysis and strategy planning
- AI Features: Topic opportunities, competitive positioning
Key Features
- ✅ AI-enhanced analysis using Gemini
- ✅ Structured JSON responses
- ✅ Comprehensive error handling
- ✅ Intelligent logging and monitoring
- ✅ Business-focused insights
- ✅ Async/await support
- ✅ Health check endpoints
Quick Start
from services.seo_tools import MetaDescriptionService
# Initialize service
service = MetaDescriptionService()
# Generate meta descriptions
result = await service.generate_meta_description(
keywords=["SEO", "content marketing"],
tone="Professional",
search_intent="Informational Intent"
)
print(result["meta_descriptions"])
API Integration
All services are exposed via FastAPI endpoints at /api/seo/*. See the main documentation for complete API reference.
Logging
All operations are logged with structured data to:
logs/seo_tools/operations.jsonl- Successful operationslogs/seo_tools/errors.jsonl- Error logslogs/seo_tools/ai_analysis.jsonl- AI interactions
Health Monitoring
Each service includes a health_check() method for monitoring:
status = await service.health_check()
print(status["status"]) # "operational" or "error"
Business Focus
All AI analysis is optimized for:
- Content Creators: User-friendly insights and actionable recommendations
- Digital Marketers: Performance metrics and ROI-focused suggestions
- Solopreneurs: Cost-effective, comprehensive SEO analysis
For complete documentation, see /backend/docs/SEO_TOOLS_MIGRATION.md