feat(wordpress): adiciona plugin wordpress (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:09:51 +00:00
parent a32752df8a
commit 63b1d79095
58 changed files with 7380 additions and 0 deletions
@@ -0,0 +1,135 @@
+---
+name: rank-math
+description: Gestão programática do Rank Math SEO (Free e PRO) via WP-CLI em servidores CWP. Cobre auditoria SEO, meta em massa, schema markup, redirects, sitemaps, Instant Indexing, Analytics PRO, hooks/filtros, taxonomias WooCommerce, News/Video Sitemap, validação e rollback. Usar quando "rank math", "seo cli", "schema markup", "redirects seo", "instant indexing", "indexnow", "seo bulk", "rankmath pro".
+layer: wiki
+---
+
+# /rank-math — Gestão Programática Rank Math SEO via WP-CLI
+
+Operações SEO WordPress completas via WP-CLI no servidor CWP. Free + PRO.
+
+**Manual completo:** `Hub/06-Operacoes/Documentacao/Manuais/WP-CLI/Rank-Math-WP-CLI-Manual-Definitivo.md`
+**Quick Reference:** `Hub/06-Operacoes/Documentacao/Quick-Reference/QR-RankMath-WP-CLI.md`
+**Pesquisa Claude:** `Hub/06-Operacoes/Documentacao/Manuais/WP-CLI/Rank-Math-SEO-WP-CLI-Skils-Pesquisa-Claude.md`
+**Pesquisa Gemini:** `Hub/06-Operacoes/Documentacao/Manuais/WP-CLI/Rank-Math-SEO-WP-CLI-Skills-Pesquisa-Gemini.md`
+**NotebookLM:** [WordPress Config CLI](https://notebooklm.google.com/notebook/fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d)
+**Skill relacionada:** `/seo-post` — optimizar posts individuais com pipeline completo
+
+---
+
+## Contexto NotebookLM
+
+ANTES de executar, consultar notebooks para contexto especializado:
+
+| Notebook | ID | Consultar quando |
+|----------|-----|-----------------|
+| WordPress e Elementor | 5be0d1a6 | Sempre |
+| Marketing Digital PT | 4c595973 | Para contexto SEO |
+
+```
+mcp__notebooklm__notebook_query({
+  notebook_id: "5be0d1a6-00f2-4cd9-b835-978cb7721601",
+  query: "<adaptar ao contexto do pedido do utilizador>"
+})
+```
+
+---
+
+## Uso
+
+```
+/rank-math audit SITE_PATH
+/rank-math update-meta SITE_PATH
+/rank-math sitemap SITE_PATH
+/rank-math redirects SITE_PATH
+/rank-math schema post ID SITE_PATH
+/rank-math indexing SITE_PATH [URL|bulk]
+/rank-math analytics SITE_PATH
+/rank-math taxonomy SITE_PATH
+/rank-math hooks SITE_PATH
+/rank-math backup SITE_PATH
+/rank-math provision SITE_PATH
+```
+
+---
+
+## Contexto CWP — sempre obrigatorio
+
+```bash
+# Formato base (PHP 8.3)
+/opt/alt/php-fpm83/usr/bin/php /usr/local/bin/wp <comando> --allow-root --path=/home/USER/public_html
+
+# Alias
+wp83 <comando> --allow-root --path=/home/USER/public_html
+```
+
+**Acesso via MCP SSH:**
+```
+servidor: server.descomplicar.pt (176.9.3.158) | porta: 9443 | user: root
+```
+
+**Prefixo de tabelas:** Sites podem ter prefixo custom (ex: `wpah_` em vez de `wp_`). Detectar primeiro:
+```bash
+PREFIX=$(wp db prefix --allow-root --path=$PATH)
+# Usar $PREFIX em todas as queries SQL: ${PREFIX}posts, ${PREFIX}postmeta, etc.
+```
+
+**Unico comando nativo Rank Math:**
+```bash
+wp rankmath sitemap generate --allow-root --path=$PATH
+```
+
+Tudo o resto usa `wp post meta`, `wp option patch`, `wp eval` ou `wp db query`.
+
+**Options com defaults:** Muitas sub-keys (title_separator, strip_category_base, homepage_title, knowledgegraph_type) podem nao existir na BD se nunca foram alteradas — o Rank Math usa valores por defeito internos. `wp option pluck` retorna exit code 1 neste caso. Nao e erro — significa valor default.
+
+---
+
+## Decision tree — qual comando usar
+
+| Operacao | Comando |
+|----------|---------|
+| Alterar meta de 1 post | `wp post meta update` |
+| Alterar sub-key em option serializada | `wp option patch update` |
+| Ler sub-key de option | `wp option pluck` |
+| Schema complexo | `wp eval` com PHP |
+| Redirects | `wp eval` com `\RankMath\Redirections\DB` |
+| Bulk simples | shell loop com `wp post list \| while read` |
+| Bulk complexo | `wp eval-file` com script PHP |
+| SQL directo | apenas auditorias (seguido de `wp cache flush`) |
+| Regenerar sitemap | `wp rankmath sitemap generate` |
+| Instant Indexing | `wp eval` com IndexNow API ou classes RM |
+| Side-effects RM | `wp eval` com `update_option()` (dispara hooks) |
+
+---
+
+## 1. Auditoria SEO (/rank-math audit)
+
+### Passo 1 — diagnostico rapido
+
+```bash
+PATH=/home/USER/public_html
+PREFIX=$(wp db prefix --allow-root --path=$PATH)
+
+# Posts sem titulo SEO
+wp db query "SELECT p.ID, p.post_title FROM ${PREFIX}posts p
+LEFT JOIN ${PREFIX}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='');" --allow-root --path=$PATH
+
+# Posts sem descricao SEO
+wp db query "SELECT p.ID, p.post_title FROM ${PREFIX}posts p
+LEFT JOIN ${PREFIX}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='');" --allow-root --path=$PATH
+
+# Distribuicao de SEO scores
+wp db query "SELECT
+  CASE WHEN CAST(meta_value AS UNSIGNED) >= 80 THEN 'Bom (80-100)'
+       WHEN CAST(meta_value AS UNSIGNED) >= 50 THEN 'OK (50-79)'
+       ELSE 'Fraco (0-49)' END AS faixa,
+  COUNT(*) AS total
+FROM ${PREFIX}postmeta WHERE meta_key = 'rank_math_seo_score' GROUP BY faixa;" --allow-root --path=$PATH
+
+# Top 404s (ultimos 30 dias)
+wp db query "SELECT uri, SUM(times_acce
@@ -0,0 +1,379 @@
+# 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"]` |
+
+```bash
+# 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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+# Ver todos os módulos
+wp option get rank_math_modules --format=json --allow-root
+
+# Activar módulo
+wp option patch update rank_math_modules MODULE_NAME "1" --allow-root
+
+# Desactivar módulo
+wp option patch update rank_math_modules MODULE_NAME "0" --allow-root
+```
+
+| Módulo | Slug | Função |
+|--------|------|--------|
+| SEO Analysis | `seo-analysis` | Score SEO no editor |
+| Link Counter | `link-counter` | Contagem links internos/externos |
+| Redirections | `redirections` | Sistema de redirects |
+| 404 Monitor | `404-monitor` | Log de 404s |
+| Schema | `rich-snippet` | Schema markup |
+| Sitemap | `sitemap` | XML Sitemap |
+| Instant Indexing | `instant-indexing` | Google Indexing API (PRO) |
+| Local SEO | `local-seo` | Schema LocalBusiness |
+| WooCommerce | `woocommerce` | SEO WooCommerce |
+
+---
+
+## Leitura de Meta
+
+```bash
+# 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
+
+```bash
+#!/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
+
+```bash
+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
+
+```bash
+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)
+
+```bash
+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)
+
+```bash
+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)
+
+```bash
+# 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
+
+```bash
+# 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 | ✅ | ✅ | `wp eval` |
+| Redirections | ✅ | ✅ | `\RankMath\Redirections\DB` |
+| 404 Monitor | ✅ | ✅ | `wp_rank_math_404_logs` |
+| Instant Indexing | ❌ | ✅ | `\RankMath\Instant_Indexing\Api` |
+| Analytics GSC | ❌ | ✅ | Tabelas analytics_gsc |
+| Analytics GA | ❌ | ✅ | Tabelas analytics_ga |
+
+---
+
+*Referência Rank Math WP-CLI | Descomplicar® | v1.0.0 | 18-02-2026*