Usage Guide

Using Respira for WordPress

Respira for WordPress transforms how you interact with your WordPress site by providing a secure bridge between AI coding assistants and your website. This guide covers the core workflows and best practices for maximizing productivity while maintaining site security.

Core Workflow

Working with Page Builders

Respira supports 10 page builders. Each builder stores content differently, but Respira handles the translation automatically.

Supported Builders

Module-Level Editing

For precise control, you can update specific modules without modifying the entire page:

Update the module with admin_label "Hero Section" on page ID 123.
Change the heading text to "Welcome to Our Site".

This is especially useful for Divi and Elementor where pages have many modules.

Analysis Tools

Respira includes built-in analysis tools to help you optimize your site.

SEO Analysis

Analyze the SEO of my homepage

Returns:

• Meta tags and descriptions
• Heading structure (H1, H2, etc.)
• Image alt text coverage
• Internal linking
• Content quality metrics

Performance Analysis

Analyze the performance of my homepage

Returns:

• Load time estimates
• Image optimization opportunities
• CSS/JS optimization suggestions
• Caching recommendations

Core Web Vitals

Get Core Web Vitals for my homepage

Returns:

• LCP (Largest Contentful Paint)
• FID (First Input Delay)
• CLS (Cumulative Layout Shift)

AEO (AI Engine Optimization)

Analyze my homepage for AI search engines

Returns:

• Structured data coverage
• Content clarity score
• FAQ opportunities
• Entity recognition

Common Workflows

Best Practices

Multi-Site Management

If you manage multiple WordPress sites, you can switch between them:

Switch to the staging site

Or use the CLI to list configured sites:

npx @respira/wordpress-mcp-server --list

Configure multiple sites in ~/.respira/config.json:

{
  "sites": [
    {
      "id": "production",
      "name": "Production Site",
      "url": "https://mysite.com",
      "apiKey": "respira_prod_key",
      "default": true
    },
    {
      "id": "staging",
      "name": "Staging Site",
      "url": "https://staging.mysite.com",
      "apiKey": "respira_staging_key"
    }
  ]
}

Troubleshooting

Connection Issues

Run the connection test:

npx @respira/wordpress-mcp-server --test

Changes Not Appearing

1. Check if you're editing a duplicate (intended behavior)
2. Go to Respira → Approve Edits to approve changes
3. Clear any caching plugins after approval

Page Builder Not Detected

1. Ensure the builder plugin is active
2. Verify the page was created with that builder
3. Check the audit log for detection errors

For more help, see the Troubleshooting guide.

Next Steps