wordpress_analyze_images

Analyze image optimization opportunities including missing alt text, large files, and unoptimized formats.

Parameters

1 parameter, 1 required.

Example call

The smallest valid call, with the required parameters only:

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

Response

{
  "success": true,
  "summary": {
    "images_total": 10,
    "missing_alt": 2,
    "largest_image_kb": 820
  },
  "issues": [
    {
      "type": "warning",
      "severity": "medium",
      "message": "2 images missing alt text",
      "fix": "Add descriptive alt text to improve accessibility and SEO"
    }
  ],
  "recommendations": [
    "Compress large images",
    "Use WebP/AVIF where possible",
    "Add width/height to prevent layout shift"
  ]
}

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 2.3 seconds. 19 in 20 finish within 4.1 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.

Notes

• Read-only tool - doesn’t modify content
• Pair with wordpress_update_media to fix alt text/title/captions

Example Prompts

• "Analyze images on my homepage"
• "Which images on page 42 are too large?"
• "Do any images on the services page miss alt text?"

Related Tools

• wordpress_analyze_seo
• wordpress_analyze_performance