Analysis Toolswordpress_analyze_aeo

wordpress_analyze_aeo

Analyze content for AI Engine Optimization (AEO) to improve how AI search engines parse and cite your pages.

wordpress_analyze_aeo

Analyze content for AI Engine Optimization (optimizing for AI search engines like Perplexity, ChatGPT). Checks structured data, content clarity, semantic HTML, entities, content depth, and FAQ opportunities.

Parameters

1 parameter, 1 required.

NameTypeRequiredWhat it is
page_idnumberyesPage ID to analyze

Example call

The smallest valid call, with the required parameters only:

{
  "name": "wordpress_analyze_aeo",
  "arguments": {
    "page_id": 123
  }
}

Response

{
  "success": true,
  "score": 72,
  "grade": "C",
  "signals": {
    "has_structured_data": false,
    "has_faq_section": false,
    "has_clear_entities": true,
    "uses_semantic_headings": true,
    "has_step_by_step": false
  },
  "issues": [
    {
      "type": "warning",
      "severity": "medium",
      "message": "Missing FAQ section for common questions",
      "fix": "Add a short FAQ with 3-5 questions and answers"
    }
  ],
  "recommendations": [
    {
      "priority": "high",
      "action": "Add JSON-LD structured data",
      "details": "Add Organization / WebSite / FAQPage schema where appropriate"
    }
  ]
}

What it changes

Nothing. It only reads, so there is nothing to approve and nothing to undo.

How long it takes

A typical call takes about 3.0 seconds. 19 in 20 finish within 5.2 seconds. Measured on real sites over the last week, so it includes the site's own hosting.

Availability

Works on any WordPress site, whichever page builder it uses. Available since Respira 1.0.0.

Full Example

Prompt: "Analyze AEO on the About page (ID: 20)"

Response:

{
  "success": true,
  "score": 58,
  "grade": "D",
  "issues": [
    {
      "type": "error",
      "severity": "high",
      "message": "No structured data detected",
      "fix": "Add JSON-LD schema markup (Organization + WebSite)."
    },
    {
      "type": "warning",
      "severity": "medium",
      "message": "Content lacks scannable sections",
      "fix": "Add clear H2 sections like 'What we do', 'Who we serve', 'How to contact us'."
    }
  ],
  "recommendations": [
    {
      "priority": "high",
      "action": "Add a small FAQ section",
      "details": "Write answers in 1-3 sentences each for easy extraction by AI."
    }
  ]
}

Notes

  • Read-only tool - doesn’t modify content
  • AEO focuses on how machines understand and cite your content, not just ranking factors

Example Prompts

  • "Analyze AEO on my homepage"
  • "Is page 42 optimized for AI search?"
  • "Check if my services page is easy for ChatGPT to cite"
Was this page helpful?