feat: sync all plugins, skills, agents updates
New plugins: core-tools New skills: auto-expense, ticket-triage, design, security-check, aiktop-tasks, daily-digest, imap-triage, index-update, mindmap, notebooklm, proc-creator, tasks-overview, validate-component, perfex-module, report, calendar-manager New agents: design-critic, design-generator, design-lead, design-prompt-architect, design-researcher, compliance-auditor, metabase-analyst, gitea-integration-specialist Updated: all plugin configs, knowledge datasets, existing skills Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
295
wordpress/skills/rank-math/SKILL.md
Normal file
295
wordpress/skills/rank-math/SKILL.md
Normal file
@@ -0,0 +1,295 @@
|
||||
---
|
||||
name: rank-math
|
||||
description: This skill should be used when the user asks to "optimizar SEO wordpress",
|
||||
"rank math wp-cli", "configurar rank math", "audit rank math", "update meta SEO",
|
||||
"schema markup wordpress", "redirects rank math", "sitemap wordpress", "bulk SEO update",
|
||||
"rank math CWP", "titles meta descriptions wp-cli", "configurar sitemap wordpress",
|
||||
"noindex wordpress", "rank math robots". Manages Rank Math SEO plugin via WP-CLI
|
||||
on CWP servers.
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 1.0.0
|
||||
quality_score: 80
|
||||
user_invocable: true
|
||||
---
|
||||
|
||||
# /rank-math - Gestão Rank Math SEO via WP-CLI
|
||||
|
||||
Operações de SEO WordPress via WP-CLI no servidor CWP (server.descomplicar.pt). Cobre auditoria, configuração em massa, schema markup, redirects e sitemap.
|
||||
|
||||
**Manual completo:** `Hub/06-Operacoes/Documentacao/Manuais/Rank-Math-WP-CLI-Manual-Definitivo.md`
|
||||
**Quick Reference:** `Hub/06-Operacoes/Documentacao/Quick-Reference/QR-RankMath-WP-CLI.md`
|
||||
**NotebookLM:** [WordPress Config CLI](https://notebooklm.google.com/notebook/fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d)
|
||||
|
||||
---
|
||||
|
||||
## Uso
|
||||
|
||||
```
|
||||
/rank-math audit https://site.pt
|
||||
/rank-math update-meta /home/USER/public_html
|
||||
/rank-math sitemap /home/USER/public_html
|
||||
/rank-math redirects /home/USER/public_html
|
||||
/rank-math schema post ID /home/USER/public_html
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Contexto CWP — Sempre Obrigatório
|
||||
|
||||
**PHP 8.3 no CWP:**
|
||||
```bash
|
||||
# Formato base
|
||||
/opt/alt/php-fpm83/usr/bin/php /usr/local/bin/wp <comando> --allow-root --path=/home/USER/public_html
|
||||
|
||||
# Alias ~/.bashrc (se configurado)
|
||||
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
|
||||
```
|
||||
|
||||
**Único comando nativo Rank Math:**
|
||||
```bash
|
||||
wp rankmath sitemap generate --allow-root --path=/home/USER/public_html
|
||||
```
|
||||
Tudo o resto usa `wp post meta`, `wp option patch`, `wp eval` ou `wp db query`.
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Auditoria SEO (/rank-math audit)
|
||||
|
||||
### Passo 1 — Diagnóstico rápido
|
||||
|
||||
```bash
|
||||
PATH=/home/USER/public_html
|
||||
|
||||
# Posts sem título SEO
|
||||
wp db query "SELECT p.ID, p.post_title 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='');" --allow-root --path=$PATH
|
||||
|
||||
# Posts sem descrição SEO
|
||||
wp db query "SELECT p.ID, p.post_title 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='');" --allow-root --path=$PATH
|
||||
|
||||
# Top 404s (últimos 30 dias)
|
||||
wp db query "SELECT uri, SUM(times_accessed) as total FROM wp_rank_math_404_logs
|
||||
GROUP BY uri ORDER BY total DESC LIMIT 20;" --allow-root --path=$PATH
|
||||
|
||||
# Tamanho options (detetar bloat WooCommerce)
|
||||
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;" --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
### Passo 2 — Estado módulos
|
||||
|
||||
```bash
|
||||
wp option pluck rank_math_modules --allow-root --path=$PATH
|
||||
wp option pluck rank-math-options-general strip_category_base --allow-root --path=$PATH
|
||||
wp option pluck rank-math-options-titles title_separator --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Actualizar Meta SEO (/rank-math update-meta)
|
||||
|
||||
### Meta key individual
|
||||
|
||||
```bash
|
||||
# Título SEO
|
||||
wp post meta update ID rank_math_title "%title% %sep% %sitename%" --allow-root --path=$PATH
|
||||
|
||||
# Descrição SEO (<160 chars)
|
||||
wp post meta update ID rank_math_description "Texto conciso da página." --allow-root --path=$PATH
|
||||
|
||||
# Focus keyword
|
||||
wp post meta update ID rank_math_focus_keyword "keyword1,keyword2" --allow-root --path=$PATH
|
||||
|
||||
# Robots (ARRAY JSON — obrigatório --format=json)
|
||||
wp post meta update ID rank_math_robots '["noindex"]' --format=json --allow-root --path=$PATH
|
||||
|
||||
# Canonical URL
|
||||
wp post meta update ID rank_math_canonical_url "https://site.pt/url/" --allow-root --path=$PATH
|
||||
|
||||
# Pillar content
|
||||
wp post meta update ID rank_math_pillar_content "on" --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
### Bulk update (wp eval)
|
||||
|
||||
```bash
|
||||
# Aplicar título padrão a todos os posts sem título
|
||||
wp eval '
|
||||
$posts = get_posts(["numberposts"=>-1,"post_status"=>"publish"]);
|
||||
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%");
|
||||
}
|
||||
}
|
||||
echo count($posts)." posts processados\n";
|
||||
' --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Options Globais (/rank-math options)
|
||||
|
||||
**Regra crítica:** SEMPRE usar `wp option patch`, NUNCA `wp option update` em options serializadas.
|
||||
|
||||
```bash
|
||||
# Separador de título
|
||||
wp option patch update rank-math-options-titles title_separator "-" --allow-root --path=$PATH
|
||||
|
||||
# Remover base de categoria do URL
|
||||
wp option patch update rank-math-options-general strip_category_base "on" --allow-root --path=$PATH
|
||||
|
||||
# Verificar sub-key
|
||||
wp option pluck rank-math-options-titles title_separator --allow-root --path=$PATH
|
||||
|
||||
# LER option completa (diagnóstico)
|
||||
wp option get rank-math-options-general --format=json --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Schema Markup (/rank-math schema)
|
||||
|
||||
Schema é armazenado como array PHP em `rank_math_schema_{Type}`. Usar `wp eval` (não JSON directo).
|
||||
|
||||
```bash
|
||||
# Criar schema Article num post
|
||||
wp eval '
|
||||
update_post_meta(ID, "rank_math_schema_Article", [
|
||||
"metadata" => ["title"=>"Article","type"=>"custom","shortcode"=>"s-".uniqid(),"isPrimary"=>"1"],
|
||||
"@type"=>"Article",
|
||||
"headline"=>"%seo_title%",
|
||||
"description"=>"%seo_description%",
|
||||
"author"=>["@type"=>"Person","name"=>"%name%"],
|
||||
"datePublished"=>"%date(Y-m-dTH:i:sP)%",
|
||||
"dateModified"=>"%modified(Y-m-dTH:i:sP)%"
|
||||
]);
|
||||
echo "Schema criado\n";
|
||||
' --user=1 --allow-root --path=$PATH
|
||||
|
||||
# Criar schema FAQ
|
||||
wp eval '
|
||||
update_post_meta(ID, "rank_math_schema_FAQPage", [
|
||||
"metadata" => ["title"=>"FAQ","type"=>"custom","shortcode"=>"s-".uniqid(),"isPrimary"=>"1"],
|
||||
"@type"=>"FAQPage",
|
||||
"mainEntity"=>[
|
||||
["@type"=>"Question","name"=>"Pergunta 1","acceptedAnswer"=>["@type"=>"Answer","text"=>"Resposta 1"]],
|
||||
["@type"=>"Question","name"=>"Pergunta 2","acceptedAnswer"=>["@type"=>"Answer","text"=>"Resposta 2"]]
|
||||
]
|
||||
]);
|
||||
echo "FAQ Schema criado\n";
|
||||
' --user=1 --allow-root --path=$PATH
|
||||
|
||||
# Apagar schema corrompido
|
||||
wp post meta delete ID rank_math_schema_Article --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Redirects (/rank-math redirects)
|
||||
|
||||
```bash
|
||||
# Criar redirect 301
|
||||
wp eval '
|
||||
\RankMath\Redirections\DB::add([
|
||||
"id"=>"",
|
||||
"sources"=>[["pattern"=>"/url-antiga/","comparison"=>"exact"]],
|
||||
"url_to"=>"/url-nova/",
|
||||
"header_code"=>301,
|
||||
"status"=>"active",
|
||||
]);
|
||||
echo "Redirect criado\n";
|
||||
' --allow-root --path=$PATH
|
||||
|
||||
# Redirect com wildcard
|
||||
wp eval '
|
||||
\RankMath\Redirections\DB::add([
|
||||
"id"=>"",
|
||||
"sources"=>[["pattern"=>"/blog/","comparison"=>"contain"]],
|
||||
"url_to"=>"/artigos/",
|
||||
"header_code"=>301,
|
||||
"status"=>"active",
|
||||
]);
|
||||
echo "Redirect wildcard criado\n";
|
||||
' --allow-root --path=$PATH
|
||||
|
||||
# Apagar redirect por ID
|
||||
wp eval '\RankMath\Redirections\DB::delete(42); echo "Redirect apagado\n";' --allow-root --path=$PATH
|
||||
|
||||
# Limpar logs 404 (após resolver)
|
||||
wp db query "TRUNCATE TABLE wp_rank_math_404_logs;" --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Sitemap (/rank-math sitemap)
|
||||
|
||||
```bash
|
||||
# Regenerar sitemap
|
||||
wp rankmath sitemap generate --allow-root --path=$PATH
|
||||
|
||||
# Excluir post-type do sitemap
|
||||
wp option patch update rank-math-options-sitemap pt_attachment_sitemap "off" --allow-root --path=$PATH
|
||||
|
||||
# Verificar setting
|
||||
wp option pluck rank-math-options-sitemap pt_post_sitemap --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Sequência de Cache (Sempre Após Alterações)
|
||||
|
||||
```bash
|
||||
wp cache flush --allow-root --path=$PATH
|
||||
wp transient delete --all --allow-root --path=$PATH
|
||||
wp rewrite flush --allow-root --path=$PATH
|
||||
wp rankmath sitemap generate --allow-root --path=$PATH
|
||||
```
|
||||
|
||||
> Alterações via `wp db query` não invalidam Redis/Memcached. Sempre executar `wp cache flush`.
|
||||
|
||||
---
|
||||
|
||||
## Gotchas Críticos
|
||||
|
||||
| Problema | Causa | Solução |
|
||||
|----------|-------|---------|
|
||||
| Robots não aplicam | Injectado como string, não array | `'["noindex"]' --format=json` |
|
||||
| Options corrompidas | `wp option update` em option serializada | Sempre `wp option patch` |
|
||||
| Alteração não visível | Object cache (Redis) em memória | `wp cache flush` |
|
||||
| Schema quebra editor | JSON inválido em `rank_math_schema_*` | `wp post meta delete ID rank_math_schema_*` |
|
||||
| Sitemap 404 no Nginx | Faltam rewrite rules | Adicionar regras ao server block |
|
||||
|
||||
---
|
||||
|
||||
## Variáveis Dinâmicas Frequentes
|
||||
|
||||
`%title%` · `%sitename%` · `%sep%` · `%excerpt%` · `%category%` · `%currentyear%` · `%seo_title%` · `%seo_description%` · `%post_thumbnail%` · `%url%` · `%name%`
|
||||
|
||||
---
|
||||
|
||||
## Recursos Adicionais
|
||||
|
||||
### Referências
|
||||
|
||||
- **`references/commands.md`** — Referência completa de todos os comandos, meta keys, options e módulos
|
||||
|
||||
### Documentação Hub
|
||||
|
||||
- **Manual:** `Hub/06-Operacoes/Documentacao/Manuais/Rank-Math-WP-CLI-Manual-Definitivo.md` (17 secções)
|
||||
- **QR:** `Hub/06-Operacoes/Documentacao/Quick-Reference/QR-RankMath-WP-CLI.md`
|
||||
- **NotebookLM:** [WordPress Config CLI](https://notebooklm.google.com/notebook/fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d) (4 fontes)
|
||||
|
||||
---
|
||||
|
||||
*Rank Math SEO via WP-CLI | Descomplicar® | v1.0.0 | 18-02-2026*
|
||||
Reference in New Issue
Block a user