/seo-aeo-amplifier

name: seo-aeo-amplifier
description: "Use when the user says 'run an seo aeo audit', 'improve my search visibility', 'optimize my site for search engines', or wants the site cited by AI answer engines. Audits on-page SEO and AEO, generates schema markup, and applies fixes on duplicates for review after a snapshot."
license: MIT
metadata:
  author: Respira for WordPress
  author_url: https://respira.press
  version: 1.3.1
  mcp-server: respira-wordpress
  category: performance

SEO & AEO Amplifier

**Version:** 1.3.1 **Updated:** 2026-06-30 **Freshly updated:** v1.3.0 takes a snapshot with respira_get_snapshot before any edit so every change is one-click reversible, switches from full extract/inject to surgical respira_find_element + respira_update_element edits for meta titles, descriptions and H1s, applies schema and meta across many pages in a single safe pass with respira_batch_update, and wires respira_generate_activity_report into the "SEO work done -> client report" handoff. Also leans on the real SEO analysis tools (respira_analyze_seo, respira_analyze_aeo, respira_analyze_rankmath, respira_check_seo_issues, respira_check_structured_data) instead of hand-rolled scoring.

Comprehensive on-page SEO and Answer Engine Optimization (AEO) audit and auto-fix system for WordPress sites. Scans all content, detects issues, generates intelligent schema markup, and creates optimized duplicates for review.

What This Skill Does

**Finds:**

• Missing or weak title tags and meta descriptions
• Poor heading structure (multiple H1s, skipped heading levels, non-descriptive headings)
• Missing image alt text across all media
• Thin content (pages under 300 words)
• Broken internal links
• Orphaned pages (no internal links pointing to them)
• Non-descriptive URL slugs
• Content that could answer questions but lacks FAQ schema
• Missing structured data (Article, HowTo, Product, Event, Video, Review)
• Content not optimized for featured snippets
• Missing table of contents on long-form content
• No clear Q&A structure for "People Also Ask" boxes

**Provides:**

• Comprehensive SEO health score (0-100)
• Page-by-page opportunity analysis
• Automated duplicate creation with all fixes applied
• Intelligent schema markup generation based on content type
• Before/after comparison for every fix
• Plugin-specific guidance (Yoast SEO, Rank Math, or plugin-agnostic)

**Generates Schema Markup:**

• Article schema (blog posts, news)
• FAQ schema (Q&A content detected)
• HowTo schema (tutorial/guide content)
• Product schema (WooCommerce products - requires WooCommerce add-on)
• Event schema (event content detected)
• Video schema (embedded videos detected)
• Review schema (review content detected)
• Breadcrumb schema (site navigation)
• Organization/Website schema (site-wide)

Requirements

• Respira for WordPress plugin installed and connected
• MCP connection active (desktop or WebMCP)
• WooCommerce add-on (optional - for product schema)
• Read access to scan site, write access to create duplicates

Trigger Phrase

• "amplify my seo and aeo"

Alternative Triggers

• "optimize my site for search engines"
• "run seo aeo audit"
• "improve my search visibility"
• "scan for seo opportunities"

Execution Workflow

Phase 1: Comprehensive Audit

1. Verify Respira + MCP connection via `respira_get_site_context`. If unavailable, stop and show setup guidance. 2. Detect SEO plugin setup using `respira_list_plugins`:

• Yoast SEO
• Rank Math
• No SEO plugin

3. Scan all published pages and posts:

• `respira_list_pages`
• `respira_list_posts`

4. For each content item, load content and metadata:

• `respira_read_page` or `respira_read_post`
• `respira_get_builder_info` when needed

5. Analyze on-page SEO. Prefer the real analysis tools over hand-rolled checks:

• `respira_analyze_seo` for the on-page SEO pass (title, meta, headings, content depth, links)
• `respira_check_seo_issues` for the prioritized issue list per page
• `respira_analyze_rankmath` when Rank Math is detected (reads its score and recommendations)
• `respira_check_structured_data` to see which schema types already exist vs are missing
• Supplement with `respira_list_media` + in-content image checks for alt text coverage
• Cross-checks the tools cover: title quality, meta description quality, heading hierarchy (single H1, no level skips), content depth, internal links / orphaned pages, URL slug descriptiveness

6. Analyze AEO opportunities with `respira_analyze_aeo` (answer-engine readiness), plus `respira_check_structured_data`:

• FAQ potential (question patterns)
• HowTo potential (step-by-step patterns)
• Featured snippet opportunities
• Missing table of contents on long-form pages
• Missing structured data per content type

7. Build opportunity scoring:

• Critical / High / Medium / Low
• Per-page opportunity score (0-100)

8. Produce full report with:

• Overall health score
• Priority matrix
• Top opportunity pages
• Plugin-specific integration notes

Phase 2: Ask for Confirmation

After report, ask:

> I found [X] pages with SEO/AEO opportunities. Would you like me to create optimized duplicates for all of them? You will review before publishing.

If user declines, stop after delivering recommendations.

Phase 3: Auto-Fix on Duplicates (Only If Approved)

1. **Snapshot first.** Before touching anything, take a snapshot with `respira_get_snapshot` so the whole pass is one-click reversible via `respira_restore_snapshot` if a fix looks wrong. 2. For each selected page/post:

• Create the review copy with `respira_create_page_duplicate` (pages) or `respira_create_post_duplicate` (posts)

3. Apply fixes on the duplicate only. Use surgical edits, not full extract/inject:

• **Locate the exact node first** with `respira_find_element` (find the meta title, meta description, and the H1 / heading elements), then change only that node with `respira_update_element`.