111 lines
5.7 KiB
Markdown
111 lines
5.7 KiB
Markdown
---
|
|
name: wp-content-seo-gate
|
|
description: "Regras e padrões obrigatórios para geração de conteúdo WordPress com RankMath Pro. INVOCAR AUTOMATICAMENTE quando: (1) escrevendo ou revendo prompts que gerem artigos, posts, descrições de podcast ou qualquer texto para publicar em WordPress, (2) criando, modificando ou auditando sistemas/pipelines/scripts que publicam conteúdo automaticamente em WordPress (publishers, crons, geradores), (3) gerando directamente conteúdo para posts WP. Previne os erros RankMath mais comuns: slug sem focus keyword, título sem número, keyword density baixa, meta description fora do limite."
|
|
---
|
|
|
|
# WP Content SEO Gate
|
|
|
|
Aplicar ANTES de escrever prompts de geração e ANTES de implementar qualquer sistema que publique em WordPress.
|
|
|
|
## Regras Obrigatórias para Prompts de Geração
|
|
|
|
Todo o prompt que instruir um LLM a gerar conteúdo WP DEVE incluir estas regras literais:
|
|
|
|
| Campo | Regra a incluir no prompt |
|
|
|-------|--------------------------|
|
|
| `focus_keyword` | 2-5 palavras, foco no benefício/problema, não no nome da ferramenta |
|
|
| `slug` | Começar com palavras da focus_keyword (hifenado, sem acentos, ≤75 chars) |
|
|
| `rank_math_title` | 50-60 chars, contém focus_keyword E um número (ano corrente ou dado concreto: "47%", "3x") |
|
|
| `rank_math_description` | 140-160 chars, focus_keyword nos primeiros 120 chars |
|
|
| `content` | focus_keyword nos primeiros 200 chars + ≥2x no corpo + ≥1 H2/H3 com a keyword |
|
|
| `image_alt` | 40-100 chars descritivo, contém focus_keyword |
|
|
| `secondary_keywords` | 3-5 keywords complementares, cada uma ≥1x no content |
|
|
|
|
**Checklist mental no prompt (incluir literalmente):**
|
|
- [ ] focus_keyword aparece em: title, rank_math_title, rank_math_description, slug, primeiros 200 chars, ≥1 H2, ≥2x no corpo
|
|
- [ ] rank_math_title contém um número (ano ou dado concreto)
|
|
- [ ] slug começa com as palavras da focus_keyword
|
|
- [ ] ≥600 palavras (RankMath penaliza abaixo deste limite)
|
|
|
|
## Padrões Obrigatórios em Publishers/Pipelines
|
|
|
|
Todo o sistema que publica em WP via código DEVE implementar estes dois auto-fixes **depois** de receber o JSON do LLM e **antes** de publicar:
|
|
|
|
### Auto-fix 1 — Slug sem focus keyword
|
|
|
|
```python
|
|
def slugify(text: str) -> str:
|
|
text = unicodedata.normalize("NFD", text.lower())
|
|
text = "".join(c for c in text if unicodedata.category(c) != "Mn")
|
|
text = re.sub(r'[^a-z0-9\s-]', '', text)
|
|
return re.sub(r'[-\s]+', '-', text.strip()).rstrip('-')
|
|
|
|
def has_keyword_in_slug(slug: str, fk: str) -> bool:
|
|
# Match sem stopwords e sem acentos
|
|
stopwords = {"a","o","as","os","de","da","do","das","dos","e","em","no","na","nos","nas","para","por","pelo","pela"}
|
|
norm = lambda s: " ".join(t for t in slugify(s).replace("-"," ").split() if t not in stopwords)
|
|
return norm(fk) in norm(slug)
|
|
|
|
# Aplicar após generate_article():
|
|
if not has_keyword_in_slug(article['slug'], article['focus_keyword']):
|
|
fk_slug = slugify(article['focus_keyword'])
|
|
orig_words = [w for w in article['slug'].split('-') if w not in fk_slug.split('-') and len(w) > 3][:2]
|
|
article['slug'] = (fk_slug + ('-' + '-'.join(orig_words) if orig_words else ''))[:75].rstrip('-')
|
|
```
|
|
|
|
### Auto-fix 2 — Título sem número (RankMath Title Readability)
|
|
|
|
```python
|
|
import time, re
|
|
|
|
if not re.search(r'\d', article.get('rank_math_title', '')):
|
|
year = time.strftime('%Y')
|
|
t = article['rank_math_title'].rstrip()
|
|
article['rank_math_title'] = (t[:55].rstrip() + f' {year}') if len(t) > 55 else f'{t} {year}'
|
|
```
|
|
|
|
## Checklist de Validação Pré-publicação
|
|
|
|
Verificar em qualquer publisher antes do `wp post create`:
|
|
|
|
- [ ] slug contém focus_keyword (sem acentos, hifenado)
|
|
- [ ] rank_math_title tem ≥1 dígito e ≤60 chars
|
|
- [ ] rank_math_description entre 140-160 chars e com focus_keyword
|
|
- [ ] image_alt contém focus_keyword
|
|
- [ ] content ≥600 palavras
|
|
- [ ] focus_keyword nos primeiros 200 chars do content
|
|
- [ ] ≥1 H2 com a focus_keyword
|
|
- [ ] Link externo à fonte (`rel="noopener"`)
|
|
- [ ] 1-3 links internos descomplicar.pt no corpo
|
|
|
|
## Erros RankMath mais comuns
|
|
|
|
| Erro no painel | Causa | Fix |
|
|
|----------------|-------|-----|
|
|
| "Focus Keyword not found in URL" | LLM gera slug sem a FK | Auto-fix 1 obrigatório |
|
|
| "Title doesn't contain a number" | Título sem ano/dado | Auto-fix 2 + instruir LLM |
|
|
| "FK not in first 10%" | Lead não inclui a FK | Regra de prompt: FK nos primeiros 200 chars |
|
|
| "Keyword density too low/high" | <1% ou >3% | Verificar count antes de publicar |
|
|
| SEO Score N/A no dashboard | Post criado via CLI sem Gutenberg | Usar cálculo server-side de `/seo-post` Passo 6 |
|
|
| Schema ausente no HTML | Falta `rank_math_schema_*` | Ver `/seo-post` Modo aplicar Passo 3 |
|
|
|
|
## PROC Canónico
|
|
|
|
**Ler antes de agir:** `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/WordPress/PROC-Conteudo-RankMath.md` (D7-WP-RM-001)
|
|
|
|
Este PROC é a fonte única de verdade para:
|
|
- Estrutura obrigatória do conteúdo (headings, distribuição FK, elementos por tipo)
|
|
- Tabela completa de campos RankMath com valores aceitáveis
|
|
- Comandos WP-CLI exactos para aplicar meta, schema e calcular score
|
|
- Checklist de validação final (9 pontos)
|
|
- Tabela de erros comuns e resolução
|
|
|
|
Quando o detalhe de uma regra não está nesta skill, está no PROC.
|
|
|
|
## Referências Adicionais
|
|
|
|
- `/seo-post` — auditar e corrigir posts **já publicados** via WP-CLI (schema, score, OG, robots)
|
|
- `Dev/claude_automations_dev/intelligence-publisher/publisher.py` — implementação de referência dos auto-fixes
|
|
- `Dev/claude_automations_dev/intelligence-publisher/prompts/article.md` — prompt de referência para artigos de notícias
|
|
- `Hub/05-Projectos/Podcast-Descomplicar-Digital/prompts/generate-wp-description.md` — prompt de referência para posts de podcast
|