AI SEO Optimizer

What it does

Adds AI-powered SEO optimization capabilities to Drupal content creation workflows.

With this recipe, your Drupal site gains intelligent SEO assistance: when you create or edit content, the system can generate:

• SEO-optimized titles via the "Generate SEO Title" action
• Meta descriptions tailored for search engines and click-through rates
• Page titles (H1 headings) that balance keywords with readability
• Comprehensive SEO analysis reports with actionable, Drupal-specific recommendations
• SEO scoring (1-10 scale) to quickly assess content quality

All of this is wired into your content types through Field Widget Actions, so it works out-of-the-box once the recipe is applied.

Why it matters

Drupal currently lacks built-in AI-based SEO optimization, forcing content creators to manually craft meta tags, analyze content quality, and implement SEO best practices. This recipe helps close that gap by:

• Saving time for content editors and SEO specialists by automating repetitive SEO tasks
• Improving search visibility through AI-generated meta tags, descriptions, and content analysis aligned with modern search engine expectations
• Enhancing content quality with detailed analysis covering 12+ on-page SEO factors (topic authority, keyword integration, heading structure, image optimization, schema markup, accessibility, and more)
• Reducing the learning curve for SEO by providing actionable, Drupal-specific recommendations

It's a foundational building block for content teams who want to optimize for both traditional search engines and emerging AI-powered search experiences.

How it works (internals)

When applied, the recipe configures:

• AI SEO Analysis field added to all content types, storing detailed audit reports and numeric scores
• AI Automators for each content bundle that generate SEO titles, descriptions, and page titles using intelligent prompts
• Field Widget Actions on content edit forms to trigger AI generation on-demand
• Structured field groups organizing all SEO fields (title, description, image, analysis) in a dedicated "Search Engine Optimization" section
• Token-based prompts that analyze your content and generate SEO recommendations following E-E-A-T principles, WCAG accessibility standards, and Drupal-specific best practices

When editing content, you can click generation buttons to create SEO titles and descriptions. The "Generate SEO report and score" action provides a comprehensive 12-point audit covering content depth, meta tags, heading structure, keyword integration, natural language, image optimization, internal/external links, URL structure, performance, accessibility, schema markup, and canonicalization.

Requirements & compatibility

• Drupal core: ^10.4 or ^11
• AI module ^1.2
• Token module (for token_entity_render support)
• Extends the Drupal CMS SEO Tools recipe (applies it automatically)
• Requires at least one content type to be installed

How to get started

1. Install this recipe into your recipes/ directory using Composer
2. Configure an AI provider that supports Chat operations (e.g., OpenAI, Anthropic, local models)
3. Run drush recipe ../recipes/ai_recipe_seo_optimizer
4. Create or edit content, use the "Generate" buttons in the SEO field group, and save

After saving, you'll have AI-optimized meta tags and a detailed SEO analysis report to guide your content improvements.