Epic: Add SEO Enhancement Tools using Abilities API

[chubes4]

Epic: Add SEO Enhancement Tools using Abilities API

This epic adds comprehensive SEO tools for audit fixes and AI-powered content optimization using WordPress 6.9 Abilities API.

Overview

Enhance the extrachill-seo plugin with three major capabilities:

1. Broken Links Audit & Fixing - Automated detection and repair of broken internal/external links
2. AI Meta Description Generation - Automatic generation of SEO-optimized meta descriptions from post content
3. AI Vision Alt Tag Generation - AI-powered alt text creation for images using vision models

All features will use the WordPress Abilities API for automation and REST API integration.

Current State

• Plugin has basic SEO auditing but no broken link tools
• No AI-powered content generation capabilities
• Manual processes for meta descriptions and alt text

AI Integration Architecture

Leverage existing Extra Chill AI ecosystem for seamless integration:

Primary Integration: extrachill-ai-client

• Centralized AI provider management (OpenAI, Anthropic, Google Gemini, Grok, OpenRouter)
• Network-wide API key configuration
• Filter-based AI request processing

Integration Options:

1. Direct Plugin Integration: Create dedicated AI pipeline within SEO plugin using extrachill-ai-client
2. Chat Agent Integration: Add SEO-focused agent to extrachill-chat for network-wide access
3. Data Machine Pipeline: Leverage existing Data Machine capabilities for content processing and updates

Recommended Approach: Start with direct plugin integration using extrachill-ai-client for simplicity, with hooks for future Data Machine/Chat integration.

Subtasks

🔗 Broken Links Audit & Fixing

• Register Abilities: extrachill/seo-scan-broken-links, extrachill/seo-fix-broken-link
• Link Scanner: HTTP-based crawling with rate limiting and timeout handling
• Database Schema: Custom table for link status, sources, and fix history
• Admin UI: Results display with bulk/link-by-link fixing options
• Automation: Scheduled scans and broken link notifications

📝 AI Meta Description Generation

• AI Integration: Use extrachill-ai-client for content analysis and generation
• Register Abilities: extrachill/seo-generate-meta-description, extrachill/seo-bulk-generate-meta-descriptions
• Content Analysis: Extract key phrases and topics from post content
• Prompt Engineering: Craft SEO-optimized prompts (150-160 chars, keyword-focused)
• Quality Validation: Length limits, readability, keyword presence
• Admin UI: Bulk generation with review/approval workflow

🖼️ AI Vision Alt Tag Generation

• Vision API Integration: Use extrachill-ai-client with vision-capable providers (GPT-4 Vision, Claude Vision)
• Register Abilities: extrachill/seo-generate-alt-text, extrachill/seo-bulk-generate-alt-text
• Image Processing: Secure handling of media library images
• Context Enhancement: Include post content for better descriptions
• Bulk Processing: Handle multiple images with progress tracking
• Review Workflow: Admin UI for approving/rejecting generated alt text

Future Integration Hooks

• Chat Agent: Add SEO tools as chat commands accessible network-wide
• Data Machine: Create SEO-specific pipeline for automated content optimization
• Cross-Plugin Communication: Use existing filter/action system for AI provider switching

Dependencies

• WordPress 6.9+ (Abilities API)
• extrachill-ai-client plugin (primary AI integration)
• Optional: extrachill-chat (for agent integration)
• Optional: data-machine (for pipeline integration)
• AI providers with vision capabilities (for alt text)

Files to Modify/Create

• inc/abilities/seo-enhancements-abilities.php - All new abilities
• inc/audit/broken-links-scanner.php - Link scanning logic
• inc/ai/meta-description-generator.php - Meta description AI
• inc/ai/alt-text-generator.php - Alt text vision AI
• inc/database/seo-enhancements-tables.php - Database schemas
• inc/admin/seo-enhancements-ui.php - Admin interfaces

Acceptance Criteria

• All abilities registered and functional via REST API
• Broken links can be scanned and fixed through admin UI
• Meta descriptions generated automatically from post content
• Alt text generated for images using AI vision
• Admin interfaces for bulk operations and reviews
• Proper error handling and user feedback
• Performance optimized for large sites
• Integration with extrachill-ai-client working

Impact

• Comprehensive SEO toolkit for maintaining site health
• AI-powered content optimization reducing manual work
• Better accessibility and search rankings
• Modern automation using WordPress core APIs
• Seamless integration with existing AI ecosystem

Related

• WordPress Abilities API documentation
• extrachill-ai-client integration patterns
• SEO best practices for meta descriptions and alt text
• Data Machine pipeline capabilities
• extrachill-chat agent system