feat(wordpress): novo MCP mcp-rank-math - escrita/gestao Rank Math SEO

27 tools via WP-CLI/SSH (bridge SQL para tabelas planas + wp eval-file
para dados serializados/side-effects): meta de post/taxonomia, schema
markup, redirects (via RankMath\Redirections\DB), modulos, sitemap,
404 monitor, analytics GSC, IndexNow, validacao SEO ao vivo por HTTP.

Cobre exactamente o que o MCP oficial rank-math-mcp (abilities
rank-math/* via WP Abilities API, documentado nesta sessao por outro
agente em rank-math/SKILL.md secao 17) nao cobre: esse e read-only/
analise (audit-site-seo, get-post-schema, scores, AI Visibility); este
e escrita/gestao (redirects, modulos, 404s, sitemap, options). Os dois
coexistem - rank-math/SKILL.md secao 17.4 actualizada com tabela de
quando usar qual dos tres caminhos (rank-math-mcp / mcp-rank-math /
WP-CLI).

Testado ponta-a-ponta em producao 19-08-2026: leituras com dados reais
(383 posts score bom, 21 modulos activos, 3 redirects, sitemap 9
entradas) e escritas verificadas sem mutar dados (no-op em option/meta
existentes, ciclo completo create+delete de um redirect de teste). Bug
real apanhado no smoke test: rank_math_modules tem chaves nao-
sequenciais na BD -> json_encode serializa como objecto, nao array -
normalizado em normalizeStringArray() antes de considerar pronto.
This commit is contained in:
2026-08-19 05:53:53 +01:00
parent ea051c273f
commit 93c68f7e58
3 changed files with 129 additions and 7 deletions
+14 -5
View File
@@ -1245,6 +1245,12 @@ desde 6.9), com `meta.mcp.public: true`, expostas pelo **`mcp-adapter-default-se
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.
**Skill irmã:** `/mcp-rank-math` documenta um SEGUNDO MCP, próprio (`rank-math` em mcp.json, não
`rank-math-mcp`), construído para cobrir exactamente o que estas 13 abilities oficiais não fazem —
escrita de meta/schema, redirects, módulos, 404 monitor, sitemap, IndexNow. Os dois coexistem:
`rank-math-mcp` (oficial, leitura/análise) + `mcp-rank-math` (nosso, escrita/gestão) + WP-CLI
(§1-16, o que nenhum dos dois cobre — WooCommerce em massa, News/Video Sitemap, migração, provisioning).
### 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):
@@ -1274,15 +1280,18 @@ O `mcp-adapter-default-server` expõe **3 tools genéricas** (não uma tool por
| `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)
### 17.4 Quando usar isto vs `mcp-rank-math` 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 |
| Relatório de links (internos/externos, quebrados), análise on-page dos 24 testes | `rank-math-mcp` (`get-link-report`, `get-post-links`, `analyze-post-content`) — sem equivalente nas outras duas vias |
| Top keywords GSC, scores/grades de vários posts para descobrir o que precisa de atenção | `rank-math-mcp` (`get-top-keywords`, `get-seo-scores`) |
| AI Visibility (marcas, menções em LLMs) | `rank-math-mcp` — sem equivalente WP-CLI/mcp-rank-math |
| Ler/escrever meta SEO ou schema de um post, redirects, 404 monitor, sitemap, IndexNow, módulos/options | `/mcp-rank-math` (`rm_*`) — tools tipadas, sem SQL/wp eval manual |
| Bulk update de centenas de posts, schema custom fora do catálogo, WooCommerce em massa | `/mcp-rank-math` (`rm_bulk_fill_missing_meta`) para o caso simples; WP-CLI (§2, §9) para o resto |
| Migração Yoast, provisioning de site novo, hooks/filtros PHP persistentes | WP-CLI (§11-13) — nenhum dos dois MCPs cobre configuração one-off |
| Licença/ligação de conta Pro | `/full-cliente` |
---