diff --git a/wordpress/skills/rank-math/SKILL.md b/wordpress/skills/rank-math/SKILL.md index cf7d652..19d03ab 100644 --- a/wordpress/skills/rank-math/SKILL.md +++ b/wordpress/skills/rank-math/SKILL.md @@ -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* ---