| name | gestao-de-frontmatter |
| description | Use quando a tarefa envolve definir ou revisar metadados de posts (título, descrição, slug, palavras-chave) antes da escrita do conteúdo. |
Gestão de Frontmatter
Visão geral
Frontmatter é a base SEO e editorial do post. Sem frontmatter, não existe conteúdo.
Quando usar cada ferramenta
| Campo | Ferramenta | Quando chamar |
|---|
| Título | editTitle | Após pesquisa, antes de escrever |
| Descrição (meta) | editDescription | Após pesquisa, antes de escrever |
| Slug | editSlug | Após definir o título |
| Palavras-chave | editKeywords | Após pesquisa de keywords |
Nunca escreva frontmatter como texto ou YAML na resposta. Chame sempre as ferramentas acima.
Regra nº 1 — Frontmatter após pesquisa, antes de escrever
Após a pesquisa (webSearch / serpAnalysis), defina nesta ordem antes de qualquer parágrafo: título → descrição → slug → palavras‑chave.
Fluxo de palavras‑chave (obrigatório)
- Definir keywords via
editKeywords: até 10, com a 1ª como primária.
- Aplicar a primária no conteúdo:
- aparece no título (via
editTitle);
- aparece nos 100 primeiros termos do corpo;
- aparece em pelo menos um H2;
- densidade total entre 1–2%.
- Distribuir secundárias naturalmente (H2/H3 e corpo), sem forçar.
Regras por campo (com exemplos)
Título — editTitle
✅ Curto, claro, inclui a palavra‑chave primária e gera clique. 50–60 chars, keyword no início.
❌ Vago, longo demais, sem foco ou sem palavra‑chave.
Exemplos
✅ "Marketing de Conteúdo B2B: guia prático para gerar leads"
❌ "Tudo o que você precisa saber sobre muitas coisas de marketing e conteúdo"
Descrição (meta) — editDescription
✅ 150–160 caracteres, resume o benefício e inclui a primária naturalmente.
❌ Genérica, longa demais, sem ação ou sem palavra‑chave.
Exemplos
✅ "Aprenda marketing de conteúdo B2B com etapas claras, exemplos reais e boas práticas para atrair leads qualificados."
❌ "Um artigo incrível sobre marketing de conteúdo que você vai amar ler agora mesmo!"
Slug — editSlug
✅ Minúsculo, curto, com hifens, sem stop words e com a primária.
❌ Longo, com termos inúteis, caracteres especiais ou maiúsculas.
Exemplos
✅ "marketing-conteudo-b2b"
❌ "O-Marketing de Conteúdo B2B!!"
Palavras‑chave — editKeywords
✅ Até 10 termos, mistura amplo + específico, inclui long‑tail.
❌ Lista excessiva, irrelevante ou sem hierarquia.
Exemplos
✅ marketing de conteúdo b2b; geração de leads b2b; estratégia de conteúdo; funil b2b
❌ marketing; conteúdo; internet; negócios; blog; seo; vendas; empresa; digital; tráfego; anúncio
Checklist mínimo antes de escrever o corpo
Validação após escrever
- Verificar densidade da palavra‑chave primária (1–2%) via
analyzeContent
- Verificar presença da primária no 1º parágrafo
- Garantir pontuação de SEO ≥ 70
Erros comuns (evitar)
- Escrever frontmatter como YAML na resposta em vez de chamar as ferramentas
- Usar título sem palavra‑chave primária
- Inserir palavras‑chave de forma artificial
- Slug longo com stop words
- Descrição curta demais ou sem benefício claro
