claude-plugins/wordpress/skills/rank-math/references/commands.md

Rank Math WP-CLI — Referência Completa de Comandos

Manual Hub: 06-Operacoes/Documentacao/Manuais/Rank-Math-WP-CLI-Manual-Definitivo.md

---

Arquitectura de Dados

Tabelas WordPress Standard

Tabela	Dados Rank Math
wp_postmeta	SEO por post: título, descrição, robots, schema, keywords
wp_termmeta	SEO por taxonomia (categories, tags)
wp_usermeta	SEO de páginas author archive
wp_options	Configurações globais do plugin

Tabelas Custom Rank Math

Tabela	Conteúdo
wp_rank_math_redirections	Regras de redirect (301, 302, 410, etc.)
wp_rank_math_redirections_cache	Cache das regras
wp_rank_math_404_logs	Log de 404s com contadores
wp_rank_math_analytics_objects	Analytics (PRO)
wp_rank_math_analytics_ga	Google Analytics (PRO)
wp_rank_math_analytics_gsc	Search Console (PRO)

---

Meta Keys Completas (wp_postmeta)

SEO Básico

Meta Key	Tipo	Exemplo
rank_math_title	string	%title% %sep% %sitename%
rank_math_description	string	Máx 160 chars
rank_math_focus_keyword	string CSV	kw1,kw2,kw3
rank_math_pillar_content	string	on / off
rank_math_canonical_url	string URL	https://site.pt/url/
rank_math_seo_score	int	0-100 (calculado no editor)

Robots e Indexação

Meta Key	Tipo	Valores
rank_math_robots	array JSON	["noindex"], ["nofollow"], ["noindex","nofollow"]

# CORRECTO
wp post meta update ID rank_math_robots '["noindex"]' --format=json --allow-root

# ERRADO (string, não aplicará)
wp post meta update ID rank_math_robots "noindex" --allow-root

Open Graph / Social

Meta Key	Tipo	Notas
rank_math_facebook_image	string URL	Imagem OG
rank_math_facebook_title	string	Título Facebook
rank_math_facebook_description	string	Descrição Facebook
rank_math_twitter_card_type	string	summary_large_image
rank_math_twitter_title	string
rank_math_twitter_description	string
rank_math_twitter_image	string URL

Schema

Meta Key	Tipo	Notas
rank_math_schema_Article	serialized PHP array	wp eval obrigatório
rank_math_schema_FAQPage	serialized PHP array
rank_math_schema_HowTo	serialized PHP array
rank_math_schema_Product	serialized PHP array	WooCommerce
rank_math_schema_Recipe	serialized PHP array
rank_math_schema_Review	serialized PHP array
rank_math_schema_Event	serialized PHP array
rank_math_schema_LocalBusiness	serialized PHP array
rank_math_schema_VideoObject	serialized PHP array

WooCommerce

Meta Key	Tipo	Notas
rank_math_primary_category	string (Term ID)	"15"
rank_math_schema_Product	serialized PHP array	Produto WC

---

Options Globais (wp_options)

Options Principais

Option Name	Tipo	Conteúdo
rank-math-options-general	serialized array	Config geral
rank-math-options-titles	serialized array	Títulos e meta por post-type
rank-math-options-sitemap	serialized array	Configuração sitemap
rank_math_modules	serialized array	Módulos activos/inactivos
rank_math_schema_types	serialized array	Tipos schema habilitados

Sub-keys rank-math-options-general

wp option pluck rank-math-options-general strip_category_base    # on/off
wp option pluck rank-math-options-general breadcrumbs            # on/off
wp option pluck rank-math-options-general knowledgegraph_type    # person/company
wp option pluck rank-math-options-general url                    # URL empresa
wp option pluck rank-math-options-general name                   # Nome empresa/pessoa

Sub-keys rank-math-options-titles

wp option pluck rank-math-options-titles title_separator          # - / | • …
wp option pluck rank-math-options-titles homepage_title           # Título homepage
wp option pluck rank-math-options-titles homepage_description     # Desc homepage
wp option pluck rank-math-options-titles pt_post_title            # Título padrão posts
wp option pluck rank-math-options-titles pt_page_title            # Título padrão pages
wp option pluck rank-math-options-titles pt_product_title         # Título padrão products

Sub-keys rank-math-options-sitemap

wp option pluck rank-math-options-sitemap items_per_page         # Default: 200
wp option pluck rank-math-options-sitemap pt_post_sitemap        # on/off
wp option pluck rank-math-options-sitemap pt_page_sitemap        # on/off
wp option pluck rank-math-options-sitemap pt_product_sitemap     # on/off
wp option pluck rank-math-options-sitemap pt_attachment_sitemap  # on/off (default: off)

---

Módulos Rank Math

rank_math_modules e um array indexado de slugs activos (nao um map slug=>bool). Lista completa verificada ao vivo em descomplicar.pt (Pro) + filesystem — ver SKILL.md §15 para a tabela completa Free vs PRO.

# Ver todos os módulos activos
wp option get rank_math_modules --format=json --allow-root

# Activar módulo (wp eval — wp option patch NAO funciona aqui, nao ha chave por slug)
wp eval '
$modules = get_option("rank_math_modules", []);
if (!in_array("MODULE_SLUG", $modules)) { $modules[] = "MODULE_SLUG"; update_option("rank_math_modules", $modules); }
' --allow-root

# Desactivar módulo
wp eval '
$modules = get_option("rank_math_modules", []);
$modules = array_values(array_diff($modules, ["MODULE_SLUG"]));
update_option("rank_math_modules", $modules);
' --allow-root

Módulo	Slug	Função	Tier
SEO Analysis	seo-analysis	Score SEO no editor	Free
Link Counter	link-counter	Contagem links internos/externos	Free
Redirections	redirections	Sistema de redirects	Free
404 Monitor (dedicado, tabela própria)	404-monitor	Log de 404s	Free (opção básica) / PRO (módulo completo)
Schema	rich-snippet	Schema markup	Free (1/página) / PRO (ilimitado + Builder)
Sitemap	sitemap	XML Sitemap	Free
Instant Indexing	instant-indexing	IndexNow; Google Indexing API é PRO	Free
WooCommerce	woocommerce	SEO WooCommerce	Free
ACF	acf	Integração Advanced Custom Fields	Free
Analytics	analytics	GSC/GA no wp-admin	Free (básico) / PRO (avançado)
Role Manager	role-manager	Capabilities por role	Free
BuddyPress	buddypress	Integração BuddyPress	Free
bbPress	bbpress	Integração bbPress	Free
Web Stories	web-stories	SEO para Web Stories	Free
AI Visibility	ai-visibility	Monitoriza citações em AI Overviews/LLMs (achado 16-08-2026)	Free
Content AI	content-ai	Assistente de conteúdo (requer conta ligada)	Free (limitado) / PRO (ilimitado)
Image SEO	image-seo	Alt/title automático em imagens	PRO exclusivo
Local SEO	local-seo	Schema LocalBusiness multi-localização	PRO exclusivo
LLMs.txt	llms-txt	Gera /llms.txt automaticamente	PRO exclusivo
News Sitemap	news-sitemap	Sitemap Google News	PRO exclusivo
Video Sitemap	video-sitemap	Sitemap de vídeos	PRO exclusivo
Marketplace	marketplace	Addons Rank Math	PRO exclusivo
Link Genius	link-genius	Sugestões de link interno automáticas	PRO exclusivo
Podcast	podcast	SEO para podcasts	PRO exclusivo

---

Leitura de Meta

# Todos os meta do post
wp post meta list 42 --format=table --allow-root | grep rank_math

# Meta específico
wp post meta get 42 rank_math_title --allow-root
wp post meta get 42 rank_math_description --allow-root
wp post meta get 42 rank_math_robots --allow-root

# Meta de term
wp term meta get 15 rank_math_title --allow-root
wp term meta get 15 rank_math_description --allow-root

---

Operações em Massa

Script de auditoria completo

#!/bin/bash
PATH_WP="/home/USER/public_html"
WP="/opt/alt/php-fpm83/usr/bin/php /usr/local/bin/wp --allow-root --path=$PATH_WP"

echo "=== AUDITORIA RANK MATH SEO ==="
echo "Site: $PATH_WP"
echo "Data: $(date)"

echo -e "\n--- Posts sem título SEO ---"
$WP db query "SELECT p.ID, LEFT(p.post_title,50) as titulo FROM wp_posts p
LEFT JOIN wp_postmeta pm ON p.ID=pm.post_id AND pm.meta_key='rank_math_title'
WHERE p.post_type='post' AND p.post_status='publish'
AND (pm.meta_value IS NULL OR pm.meta_value='')
LIMIT 20;"

echo -e "\n--- Posts sem descrição SEO ---"
$WP db query "SELECT p.ID, LEFT(p.post_title,50) as titulo FROM wp_posts p
LEFT JOIN wp_postmeta pm ON p.ID=pm.post_id AND pm.meta_key='rank_math_description'
WHERE p.post_type='post' AND p.post_status='publish'
AND (pm.meta_value IS NULL OR pm.meta_value='')
LIMIT 20;"

echo -e "\n--- Top 10 404s ---"
$WP db query "SELECT uri, SUM(times_accessed) as total FROM wp_rank_math_404_logs
GROUP BY uri ORDER BY total DESC LIMIT 10;"

echo -e "\n--- Módulos activos ---"
$WP option get rank_math_modules --format=json

echo -e "\n--- Tamanho options ---"
$WP db query "SELECT option_name, LENGTH(option_value) as bytes FROM wp_options
WHERE option_name LIKE 'rank%' AND autoload='yes' ORDER BY bytes DESC;"

echo "=== FIM AUDITORIA ==="

Bulk: Aplicar título padrão a posts sem título

wp eval '
$posts = get_posts(["post_type"=>"post","numberposts"=>-1,"post_status"=>"publish"]);
$updated = 0;
foreach ($posts as $p) {
    if (!get_post_meta($p->ID, "rank_math_title", true)) {
        update_post_meta($p->ID, "rank_math_title", "%title% %sep% %sitename%");
        $updated++;
    }
}
echo "$updated posts actualizados\n";
' --allow-root --path=$PATH_WP

Bulk: Aplicar descrição a partir do excerpt

wp eval '
$posts = get_posts(["post_type"=>"post","numberposts"=>-1,"post_status"=>"publish"]);
$updated = 0;
foreach ($posts as $p) {
    if (!get_post_meta($p->ID, "rank_math_description", true) && $p->post_excerpt) {
        $desc = wp_trim_words($p->post_excerpt, 20, "...");
        update_post_meta($p->ID, "rank_math_description", $desc);
        $updated++;
    }
}
echo "$updated posts actualizados\n";
' --allow-root --path=$PATH_WP

---

Schema — Exemplos Completos

Article (blog post)

wp eval '
$post_id = ID;
update_post_meta($post_id, "rank_math_schema_Article", [
    "metadata" => [
        "title"=>"Article",
        "type"=>"custom",
        "shortcode"=>"s-".uniqid(),
        "isPrimary"=>"1"
    ],
    "@type"=>"Article",
    "headline"=>"%seo_title%",
    "description"=>"%seo_description%",
    "url"=>"%url%",
    "author"=>["@type"=>"Person","name"=>"%name%"],
    "publisher"=>["@type"=>"Organization","name"=>"%sitename%","logo"=>""],
    "datePublished"=>"%date(Y-m-dTH:i:sP)%",
    "dateModified"=>"%modified(Y-m-dTH:i:sP)%",
    "image"=>"%post_thumbnail%"
]);
echo "Article schema criado no post $post_id\n";
' --user=1 --allow-root --path=$PATH_WP

LocalBusiness (página contacto)

wp eval '
update_post_meta(ID, "rank_math_schema_LocalBusiness", [
    "metadata" => ["title"=>"LocalBusiness","type"=>"custom","shortcode"=>"s-".uniqid(),"isPrimary"=>"1"],
    "@type"=>"LocalBusiness",
    "name"=>"Nome Empresa",
    "description"=>"%seo_description%",
    "url"=>"%url%",
    "email"=>"email@empresa.pt",
    "telephone"=>"+351 XXX XXX XXX",
    "address"=>["@type"=>"PostalAddress","streetAddress"=>"Rua X","addressLocality"=>"Cidade","postalCode"=>"XXXX-XXX","addressCountry"=>"PT"],
    "geo"=>["@type"=>"GeoCoordinates","latitude"=>"38.7","longitude"=>"-9.1"],
    "openingHoursSpecification"=>[
        ["@type"=>"OpeningHoursSpecification","dayOfWeek"=>["Monday","Tuesday","Wednesday","Thursday","Friday"],"opens"=>"09:00","closes"=>"18:00"]
    ],
    "image"=>"%post_thumbnail%"
]);
echo "LocalBusiness schema criado\n";
' --user=1 --allow-root --path=$PATH_WP

---

Instant Indexing (Google Indexing API - PRO)

# Submeter URL individual
wp eval '\RankMath\Instant_Indexing\Api::submit("https://site.pt/url/", "URL_UPDATED"); echo "OK\n";' --allow-root --path=$PATH_WP

# Verificar estado da API
wp option pluck rank-math-options-instant-indexing bing_api_key --allow-root --path=$PATH_WP

---

Redirects — Referência Completa

Tipos de Comparação

comparison	Comportamento
exact	Match exacto do URL
contains	URL contém o pattern
starts_with	URL começa com o pattern
ends_with	URL termina com o pattern
regex	Regular expression

Códigos HTTP

Código	Tipo	Uso
301	Moved Permanently	Redirect definitivo
302	Found	Redirect temporário
307	Temporary Redirect	Temporário (preserva método HTTP)
410	Gone	Conteúdo removido permanentemente
451	Unavailable For Legal	Removido por razões legais

---

Tabelas Rank Math — Verificação

# Ver tabelas custom
wp db query "SHOW TABLES LIKE '%rank_math%';" --allow-root --path=$PATH_WP

# Estrutura tabela redirections
wp db query "DESCRIBE wp_rank_math_redirections;" --allow-root --path=$PATH_WP

# Ver todos os redirects activos
wp db query "SELECT id, sources, url_to, header_code FROM wp_rank_math_redirections WHERE status='active';" --allow-root --path=$PATH_WP

---

Free vs PRO — Funcionalidades WP-CLI

Funcionalidade	Free	PRO	Notas
wp rankmath sitemap generate	✅	✅	Único comando nativo
Meta por post	✅	✅	wp post meta
Options globais	✅	✅	wp option patch
Schema markup	✅ (1/página)	✅ (ilimitado + Schema Builder)	wp eval
Redirections	✅	✅	\RankMath\Redirections\DB
404 Monitor (opção básica, 404_monitor_mode)	✅	✅	Sem tabela própria em Free
404 Monitor (módulo dedicado, wp_rank_math_404_logs)	❌	✅	Verificado ao vivo 16-08-2026 — só existe com Pro licenciado
Instant Indexing — IndexNow	✅	✅	Módulo instant-indexing, ambos free e PRO
Instant Indexing — Google Indexing API	❌	✅	\RankMath\Instant_Indexing\Api
Analytics (básico, wp-admin)	✅	✅	Módulo analytics presente em ambos
Analytics GSC/GA (histórico alargado)	❌	✅	Tabelas analytics_gsc/analytics_ga
Image SEO	❌	✅	Módulo image-seo — confirmado PRO exclusivo
Local SEO	❌	✅	Módulo local-seo — confirmado PRO exclusivo
LLMs.txt (/llms.txt automático)	❌	✅	Módulo llms-txt — confirmado PRO exclusivo (achado 16-08-2026)
News/Video Sitemap	❌	✅	Módulos news-sitemap/video-sitemap
Marketplace / Link Genius / Podcast	❌	✅	Só existem no filesystem seo-by-rank-math-pro

---

Referência Rank Math WP-CLI | Descomplicar® | v1.1.0 | 16-08-2026