wordpress/rank-math: documenta MCP oficial Rank Math (secao 17)

- rank-math-mcp via mcp-adapter-default-server, mesma infra wp mcp-adapter ja vendored no EMCP Tools, sem instalacao nova - 13 abilities rank-math/* catalogadas com descricoes reais, testadas ao vivo em descomplicar.pt (get-seo-scores devolveu dados reais) - tabela quando usar MCP vs WP-CLI
2026-08-19 04:55:56 +01:00
parent 67f6d6e6e1
commit 5647b558cd
1 changed files with 61 additions and 2 deletions
@@ -1,6 +1,6 @@
 ---
 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, módulos Free vs PRO completos (image-seo, local-seo, 404-monitor, llms-txt, news-sitemap, marketplace, ai-visibility), validação e rollback. Licenciamento/ligação de conta PRO → ver `/full-cliente`. Usar quando "rank math", "seo cli", "schema markup", "redirects seo", "instant indexing", "indexnow", "seo bulk", "rankmath pro", "llms.txt", "módulos rank math".
+description: Gestão programática do Rank Math SEO (Free e PRO) via WP-CLI em servidores CWP e via o MCP oficial do Rank Math (abilities `rank-math/*` na WP Abilities API, ligação `rank-math-mcp`). Cobre auditoria SEO, fix automático de testes, meta em massa, schema markup, redirects, sitemaps, Instant Indexing, Analytics PRO, AI Visibility, hooks/filtros, taxonomias WooCommerce, News/Video Sitemap, módulos Free vs PRO completos (image-seo, local-seo, 404-monitor, llms-txt, news-sitemap, marketplace, ai-visibility), validação e rollback. Licenciamento/ligação de conta PRO → ver `/full-cliente`. Usar quando "rank math", "seo cli", "schema markup", "redirects seo", "instant indexing", "indexnow", "seo bulk", "rankmath pro", "llms.txt", "módulos rank math", "rank math mcp", "audit-site-seo", "ai visibility".
 ---

 # /rank-math — Gestão Programática Rank Math SEO via WP-CLI
@@ -1225,6 +1225,65 @@ curl -sI "https://SITE.pt/llms.txt" | head -1

 A gestao de licenca/ligacao de conta Rank Math Pro faz parte do broker de licencas **FULL.Cliente** (`api.full.services`), que suporta `rankMath` como product key numa chamada unica (sem steps de OTP, ao contrario de `essentialAddons`). Para ligar/reactivar a licenca Rank Math Pro em qualquer site do bundle, usar a skill `/full-cliente` em vez de replicar aqui os comandos do broker — esta skill (`/rank-math`) fica focada em WP-CLI/dados do plugin ja licenciado.

+
+## 17. Rank Math MCP oficial (`rank-math-mcp`) — descomplicar.pt, 19-08-2026
+
+Rank Math regista abilities próprias via **WordPress Abilities API** (`wp_register_ability`, core
+desde 6.9), com `meta.mcp.public: true`, expostas pelo **`mcp-adapter-default-server`** — o mesmo
+`wp mcp-adapter` (WordPress/mcp-adapter) que já vem vendored dentro do EMCP Tools (ver skill
+`emcp-tools-descomplicar` §1.4 de `ECOSSISTEMA-WORDPRESS.md`). **Não precisa de instalação nova**:
+é a mesma infra-estrutura MCP que já existe no site, só um `--server` diferente.
+
+**Confirmado ao vivo em descomplicar.pt, 19-08-2026:** 13 abilities `rank-math/*` registadas com
+`mcp.public: true`; testado ponta-a-ponta (`rank-math/audit-site-seo` schema completo lido,
+`rank-math/get-seo-scores` devolveu 10 posts reais com scores/keywords/labels correctos).
+
+### 17.1 Ligação
+
+`~/.omp/agent/mcp.json` → `rank-math-mcp` (stdio, `ssh server "wp mcp-adapter serve
+--server=mcp-adapter-default-server ..."`). **Não** é o caminho oficial da RankMath (que documenta
+Application Password + `npx` a partir de Claude Desktop/ChatGPT/Copilot via REST) — usa-se aqui a
+mesma via SSH+wp-cli que já temos configurada para o EMCP, sem precisar de credenciais novas.
+
+### 17.2 Padrão de uso — dispatcher genérico, não tools individuais
+
+O `mcp-adapter-default-server` expõe **3 tools genéricas** (não uma tool por ability):
+
+1. `mcp-adapter-discover-abilities` — lista todas as abilities públicas no sistema (hoje 29 no
+   total: 13 `rank-math/*`, `wpforms/*`, `marketplace-*`, `rankmath-marketplace-*`).
+2. `mcp-adapter-get-ability-info({ability_name})` — schema de input/output completo de UMA
+   ability. **Chamar sempre antes de executar** uma ability nova.
+3. `mcp-adapter-execute-ability({ability_name, parameters})` — executa. `parameters` obrigatório
+   mesmo vazio (`{}`).
+
+### 17.3 Abilities `rank-math/*` disponíveis (13)
+
+| `ability_name` | O que faz |
+|---|---|
+| `rank-math/audit-site-seo` | Auditoria SEO site-wide (score, grade, findings com fix hints); combina testes locais + API remota rankmath.com. `refresh:true` por omissão. |
+| `rank-math/fix-site-seo` | Aplica fix automático a 1 teste falhado (por `test_id` de um finding). Alguns fixes pedem input extra (ex. `site_description`). Bulk fixes aceitam `post_limit`. |
+| `rank-math/get-link-report` | Relatório de saúde de links do site: internos/externos, posts sem links; PRO acrescenta links quebrados, redirects, nofollow, distribuição de status HTTP (Link Genius). |
+| `rank-math/get-post-links` | Links (internos+externos) de um post, paginado, com URL/tipo/destino. |
+| `rank-math/get-post-seo-meta` | Metadata SEO completa de um post: título, descrição, focus keyword, robots, canonical, OG/Twitter, score actual. |
+| `rank-math/get-post-schema` | Schema aplicado a um post + tipos disponíveis no site. Se o tipo recomendado não estiver em `available_types.types` e houver `upgrade_message`, mostrar verbatim — não sugerir adicionar directamente (gate PRO). |
+| `rank-math/get-top-keywords` | Top keywords por clicks (Google Search Console) — impressões, CTR, posição média. |
+| `rank-math/get-seo-scores` | Scores/grades de posts — usar para descobrir quais precisam de atenção sem saber IDs à partida. **Testado:** devolveu 10 posts reais com score/grade/label correctos. |
+| `rank-math/analyze-post-content` | Conteúdo bruto + metadata + lista dos 24 testes on-page de um post, para o próprio agente correr a análise (o motor de scoring só corre client-side no editor). |
+| `rank-math/get-ai-visibility-overview` | Resumo AI Visibility ao nível do site + lista de marcas monitorizadas. |
+| `rank-math/get-ai-visibility-brand-insights` | Análise completa de uma marca: score, rank, sentimento, menções/citações, concorrentes, respostas brutas dos modelos de IA. |
+| `rank-math/get-ai-visibility-brand-queries` | Queries monitorizadas para uma marca (activas vs baseline auto-gerada). |
+| `rank-math/create-ai-visibility-brand` | Regista nova marca para monitorização AI Visibility. |
+
+### 17.4 Quando usar isto vs WP-CLI (§1-16 desta skill)
+
+| Precisa de | Usar |
+|---|---|
+| Auditoria SEO estruturada com findings + fix hints, ou fix automático de 1 teste | `rank-math-mcp` (`audit-site-seo`/`fix-site-seo`) — mais rápido, sem escrever SQL/wp eval |
+| Ver schema/scores/links de UM post específico já conhecido | `rank-math-mcp` (`get-post-*`) |
+| AI Visibility (marcas, menções em LLMs) | `rank-math-mcp` — não há equivalente WP-CLI documentado nesta skill |
+| Bulk update de centenas de posts, schema custom fora do catálogo, redirects em massa, migração Yoast, provisioning de site novo | WP-CLI (§2-13) — o MCP não cobre escrita em massa nem schema arbitrário |
+| Módulos, licença, análise de infra-estrutura (§15-16) | WP-CLI/SSH — fora do âmbito das abilities MCP |
+
 ---

 ## Recursos
@@ -1243,7 +1302,7 @@ A gestao de licenca/ligacao de conta Rank Math Pro faz parte do broker de licenc

 **Fonte:** manual completo `Rank-Math-WP-CLI-Manual-Definitivo.md` (17 seccoes, lido na integra), codigo-fonte `includes/modules/` de `seo-by-rank-math` e `seo-by-rank-math-pro` lido ao vivo via SSH em `descomplicar.pt`, `wp option get rank_math_modules` verificado em produção, achados da auditoria de seguranca/infra 16-08-2026 (`CONFIG-Plugins-Referencia.md` §7, `BUNDLE-Excelencia-WP.md`).

-*Rank Math SEO via WP-CLI | Descomplicar | v2.1.0 | 16-08-2026*
+*Rank Math SEO via WP-CLI + MCP oficial | Descomplicar | v2.2.0 | 19-08-2026*

 ---