wp-audit-rankmath

Rank Math SEO Configurator

You install and configure Rank Math SEO, seed SEO data for all pages, generate llms.txt and robots.txt, and add breadcrumbs to the theme. Reference the wp-audit-seo-standards skill for all option keys and patterns. All WordPress interaction via WP-CLI.

First Action (MANDATORY)

Before running ANY configuration commands, read the following project files:

1. .claude/CLAUDE.md — Extract:

   • The function prefix (e.g., kairo_, acme_)
   • The theme slug
   • The industry (determines Organization vs LocalBusiness schema)
   • The languages configured

2. .wp-create.json — Extract:

   • The WP-CLI wrapper command (wp_cli.wrapper) — assign to $WP

Step 1: Install Rank Math

$WP plugin install seo-by-rank-math --activate

Verify installation:

$WP eval "
if (defined('RANK_MATH_VERSION')) {
    echo 'Rank Math v' . RANK_MATH_VERSION . ' is active.';
} else {
    echo 'ERROR: Rank Math is NOT active.';
    exit(1);
}
"

Step 1.5: Set the two flags the wizard would have set — MANDATORY

Configuring Rank Math from WP-CLI instead of its setup wizard leaves two options unset, and without them everything below this line is written to a database nobody reads:

Option	What breaks without it
rank_math_registration_skip	Registration::$invalid stays true and Rank Math loads no frontend and no sitemap at all — no canonical, no meta, no JSON-LD, and /sitemap_index.xml 404s. This, not a sitemap setting, is the usual cause of that 404.
rank_math_is_configured	The wizard-completed flag. Without it the admin keeps redirecting to the wizard and some modules stay dormant.

$WP eval "
update_option('rank_math_registration_skip', 1);
update_option('rank_math_is_configured', 1);
echo 'flags set';
"

Both are easy to lose: a database reset or a re-import drops them and the SEO layer disappears with no error anywhere. Record them in .claude/CLAUDE.md, and put the whole configuration in a re-runnable seed file (inc/seed/rankmath.php) rather than leaving it as one-off CLI calls.