seo-wordpress

WordPress SEO Analysis

Invocation

/seo-wordpress <url>

Prerequisites

1. WordPress site with REST API enabled (default since WP 4.7+)
2. Application Password for authenticated access (Settings > Users > Application Passwords)
3. Credentials stored at ~/.config/claude-seo/wordpress.json:

{
  "sites": {
    "example.com": {
      "url": "https://example.com",
      "username": "admin",
      "app_password": "xxxx xxxx xxxx xxxx"
    }
  }
}

Workflow

Step 1: WordPress Detection

Run: python scripts/wordpress_api.py <url> --check --json

Verify:

• WordPress is detected (is_wordpress: true)
• REST API is available (api_available: true)
• Identify SEO plugin (Yoast, RankMath, AIOSEO, or none)

If no SEO plugin detected, flag as Critical issue.

Step 2: Credential Loading

Check for stored credentials:

python scripts/wordpress_api.py <url> --user <user> --password <pass> --command info --json

If no credentials provided, ask the user:

1. WordPress username
2. Application Password (Settings > Users > Application Passwords in WP admin)

Step 3: Full Content Audit

Run: python scripts/wordpress_api.py <url> --user <user> --password <pass> --command seo-audit --json

This analyzes:

• All published posts: word count, headings, images, links, meta
• All published pages: same analysis
• Categories: descriptions, hierarchy, post counts
• Tags: usage, relevance
• Media: alt text, file sizes
• Internal linking: orphan detection, link matrix

Step 4: SEO Plugin Meta Analysis

Run: python scripts/wordpress_api.py <url> --user <user> --password <pass> --command seo-meta --json

Extracts:

• SEO titles and meta descriptions
• Canonical URLs
• Open Graph data
• Schema markup per post
• Focus keywords (RankMath)
• Robots directives

Step 5: Internal Linking Analysis

Run: python scripts/wordpress_api.py <url> --user <user> --password <pass> --command linking-matrix --json

Identifies:

• Orphan pages (no incoming links)
• Dead-end pages (no outgoing links)
• Link distribution imbalance
• Cluster connectivity gaps