blog-write

Blog Writer – Geração de Novos Artigos

Escreve artigos de blog completos a partir de um tópico, briefing ou esboço. Cada artigo segue os 6 pilares da otimização dupla (rankings do Google + citações de IA).

Referências principais:

• references/content-templates.md – Guia de seleção e uso de templates
• references/quality-scoring.md – Pontuação em 5 categorias (Conteúdo 30, SEO 25, E-E-A-T 15, Técnico 15, Citação de IA 15)
• references/eeat-signals.md – Marcadores de experiência, expertise, autoridade e confiança
• references/internal-linking.md – Estratégia de links internos e regras de texto âncora
• references/visual-media.md – Origem de imagens e estilo de gráficos

Fluxo de Trabalho

Fase 1: Compreensão do Tópico

1. Esclareça o tópico – Se o usuário fornecer apenas um tópico, pergunte:
   • Público-alvo (para quem é isso?)
   • Palavra-chave primária / intenção de busca
   • Contagem de palavras desejada (padrão: 2.000-2.500 palavras)
   • Plataforma/formato (MDX, markdown, HTML – detectar automaticamente se estiver em um projeto)
2. Se existir um briefing – Carregue-o e pule para a Fase 1.5

Fase 1.5: Seleção de Template

Selecione o template de conteúdo apropriado entre os 12 templates em templates/.

1. Detecção automática do tipo de conteúdo a partir do tópico e da intenção de busca:

   Sinal	Template
   "Como fazer...", processo, etapas	how-to-guide
   "Melhor X", "Top N", formato de lista	listicle
   Resultado de cliente, antes/depois, métricas	case-study
   "X vs Y", comparação, alternativas	comparison
   Tópico amplo, guia abrangente	pillar-page
   "Vale a pena X", avaliação de produto	product-review
   Opinião, previsão, visão do setor	thought-leadership
   Citações de especialistas, coleção de várias fontes	roundup
   Explicação de código, demonstração de ferramenta, técnico	tutorial
   Notícias de última hora, atualização de algoritmo, evento	news-analysis
   Resultados de pesquisa, experimento, dados originais	data-research
   Perguntas e respostas, base de conhecimento, "O que é X"	faq-knowledge

2. Carregue o template correspondente – Leia de templates/<tipo>.md

3. Adapte o esboço – Use a estrutura de seções, padrões de cabeçalho e orientação de contagem de palavras do template para moldar o esboço da Fase 3

4. Fallback – Se nenhum template se encaixar claramente, use a estrutura de esboço genérica na Fase 3 abaixo. Informe ao usuário qual template foi selecionado (ou que nenhum correspondeu).

Consulte references/content-templates.md para critérios detalhados de seleção e mapeamento de intenção.

Fase 2: Pesquisa

Gere um agente blog-researcher (ou faça pesquisa inline com WebSearch):

1. Encontre 8 a 12 estatísticas atuais (dados de 2025-2026 preferidos)
   • Busca: [tópico] estudo 2025 2026 dados estatísticas
   • Priorize fontes de nível 1 a 3 (veja references/quality-scoring.md)
   • Registre: estatística, nome da fonte, URL, data, metodologia
2. Encontre uma imagem de capa (grande, alta qualidade, relevante ao tópico):
   • Busca: site:pixabay.com [tópico] banner amplo (preferido)
   • Alternativa: site:unsplash.com [tópico] amplo
   • Fallback: site:pexels.com [tópico] banner amplo
   • Dimensões alvo: 1200x630 (compatível com OG) ou 1920x1080
   • Ou gere uma capa SVG personalizada via blog-chart (texto sobre gradiente com estatística chave)
   • Ou gere uma imagem de IA personalizada via sub-skill blog-image (se nanobanana-mcp estiver configurado)
   • Consulte references/visual-media.md para detalhes de dimensionamento da imagem de capa
3. Encontre 3 a 5 imagens inline de plataformas de código aberto:
   • Pixabay (preferido): Busca site:pixabay.com [palavras-chave do tópico]
     • Extraia a URL da imagem da página
     • URLs diretas: https://cdn.pixabay.com/photo/YYYY/MM/DD/HH/MM/nomedoarquivo.jpg
     • Verifique com curl -sI "<url>" | head -1 se retorna HTTP 200
   • Unsplash (alternativa): Busca site:unsplash.com [palavras-chave do tópico]
     • Construa a URL: https://images.unsplash.com/photo-<id>?w=1200&h=630&fit=crop&q=80
   • Pexels (fallback): Busca site:pexels.com [palavras-chave do tópico]
4. Planeje 2 a 4 visualizações de dados a partir das estatísticas pesquisadas
   • Selecione diversos tipos de gráfico (veja references/visual-media.md)
   • Mapeie pontos de dados para formatos de gráfico
5. Geração de imagem por IA (opcional, se nanobanana-mcp estiver configurado):
   • Se os resultados de fotos de stock forem insuficientes (< 3 boas correspondências) ou o tópico for muito nichado
   • Gere imagem herói personalizada e/ou ilustrações inline via sub-skill blog-image
   • Fotos de stock permanecem como padrão – a geração por IA complementa, nunca substitui
6. Pesquisa NotebookLM (opcional, se o usuário tiver notebooks relevantes):
   • Se o usuário mencionar um notebook do NotebookLM ou o tópico se alinhar a um notebook configurado
   • Consulte via blog-notebooklm para dados com origem em documentos enviados pelo usuário
   • Trate respostas do NotebookLM como fontes de Nível 1 (documentos primários do próprio usuário)
   • Falha silenciosamente se não estiver configurado ou autenticado
7. Encontre vídeos relevantes do YouTube (2 a 3 por postagem):
   • Use o comando blog-google youtube ou WebSearch site:youtube.com [tópico] [ano]
   • Aplique critérios de qualidade de references/video-embeds.md (pontuação mínima 50/100)
   • Selecione os 2 a 3 melhores vídeos. Falha silenciosamente se nenhum for encontrado.

Fase 3: Geração de Esboço

Crie um esboço estruturado antes de escrever. Se um template foi carregado na Fase 1.5, adapte este esqueleto para corresponder à estrutura de seções do template:

# [Título como Pergunta – Incluir Palavra-chave Primária]

## Introdução (100-150 palavras)
- Gancho com estatística surpreendente
- Declaração do problema/oportunidade
- O que o leitor aprenderá

> **Principais Conclusões**
> - [Descoberta central com estatística e fonte]
> - [Segunda percepção ou recomendação chave]
> - [Terceira conclusão acionável]
> (3-5 marcadores, 40-60 palavras no total)

## H2: [Formato de Pergunta] (300-400 palavras)
- Parágrafo de resposta primeiro (40-60 palavras com estatística + fonte)
- Evidência de apoio
- [Posicionamento de imagem]
- Conselho prático
- [ESPAÇO RESERVADO PARA CÁPSULA DE CITAÇÃO]
- [LINK INTERNO: texto âncora → descrição do alvo]

## H2: [Formato de Pergunta] (300-400 palavras)
- Parágrafo de resposta primeiro
- [Gráfico: tipo + descrição dos dados]
- Análise e implicações
- [ESPAÇO RESERVADO PARA CÁPSULA DE CITAÇÃO]
- [LINK INTERNO: texto âncora → descrição do alvo]

## H2: [Declaração para Variedade] (300-400 palavras)
- Parágrafo de resposta primeiro
- Exemplo do mundo real ou estudo de caso
- [Posicionamento de imagem]
- [ESPAÇO RESERVADO PARA CÁPSULA DE CITAÇÃO]

## H2: [Formato de Pergunta] (300-400 palavras)
- Parágrafo de resposta primeiro
- [Gráfico: tipo + descrição dos dados]
- Orientação passo a passo
- [ESPAÇO RESERVADO PARA CÁPSULA DE CITAÇÃO]
- [LINK INTERNO: texto âncora → descrição do alvo]

## H2: [Formato de Pergunta] (200-300 palavras)
- Parágrafo de resposta primeiro
- Análise prospectiva

## [Seção de CTA ou Posicionamento Inline]
- Consulte `references/cta-placement.md` para regras de posicionamento por tipo de conteúdo
- Coloque o CTA após a entrega de valor, não em posições arbitrárias
- Único CTA focado por postagem (266% mais conversões)
- [CTA: chamada para ação contextual correspondente ao tópico do artigo]

## Seção de FAQ (3-5 perguntas, 40-60 palavras cada resposta)
- [LINK INTERNO: texto âncora → conteúdo detalhado]

## Conclusão (100-150 palavras)
- Principais conclusões (em marcadores)
- Chamada para ação
- [LINK INTERNO: texto âncora → próximo conteúdo lógico]

Apresente o esboço ao usuário para aprovação antes de escrever.

Ritmo dos elementos visuais: Insira marcadores [IMAGEM], [GRÁFICO], [VÍDEO] ou [DESTAQUE] a cada 300-500 palavras. Alterne os tipos (sem dois consecutivos do mesmo tipo). Consulte a seção Ritmo Visual em references/content-rules.md e references/cta-placement.md para posicionamento de CTA.

Fase 4: Geração de Gráficos (Integrada)

Quando o pesquisador identificar dados dignos de gráfico (3+ métricas comparáveis, dados de tendência, comparações antes/depois):

1. Selecione o tipo de gráfico usando a regra de diversidade (sem tipos repetidos por postagem)
2. Invoque o sub-skill blog-chart com: tipo de gráfico, título, valores de dados, fonte, formato da plataforma
3. Incorpore o SVG retornado diretamente na postagem dentro de um wrapper <figure>
4. Alvo de 2 a 4 gráficos por postagem de 2.000 palavras
5. Distribua os gráficos uniformemente – nunca os agrupe

Consulte references/visual-media.md para seleção de tipo de gráfico e regras de estilo.

Fase 5: Redação do Conteúdo

Escreva o artigo completo seguindo estas regras:

5a. Frontmatter

---
title: "[Título em formato de pergunta com palavra-chave primária]"
description: "[Denso em fatos, 150-160 caracteres, inclui 1 estatística]"
coverImage: "[URL do Pixabay/Unsplash/Pexels ou caminho do SVG gerado]"
coverImageAlt: "[Frase descritiva sobre a imagem de capa]"
ogImage: "[Mesmo que coverImage, ou URL de imagem OG personalizada]"
date: "YYYY-MM-DD"
lastUpdated: "YYYY-MM-DD"
author: "[Nome do autor]"
tags: ["palavra-chave1", "palavra-chave2", "palavra-chave3"]
---

Se a plataforma usar um nome de campo diferente (por exemplo, image, hero, thumbnail), adapte para corresponder à convenção de frontmatter existente do projeto.

5b. Caixa de Resumo (Principais Conclusões)

Imediatamente após a introdução (antes da primeira seção de corpo H2), adicione uma caixa de resumo:

> **Principais Conclusões**
> - [Descoberta central com estatística] ([Fonte], ano)
> - [Segunda percepção ou recomendação chave]
> - [Terceira conclusão acionável]

Requisitos:

• 3-5 marcadores, 40-60 palavras no total
• Deve ser autossuficiente – compreensível sem ler o artigo
• Incluir 1 estatística específica com nome da fonte
• Declarar a descoberta chave, recomendação ou resposta
• Rótulo padrão: "Principais Conclusões". Se uma persona estiver ativa, use o summary_label da persona
• Compatível com versões anteriores: aceitar caixas TL;DR existentes durante reescritas

5c. Formatação Resposta Primeiro (Crítico)

Cada seção H2 DEVE abrir com um parágrafo de 40-60 palavras contendo:

• Pelo menos uma estatística específica com atribuição de fonte
• Uma resposta direta à pergunta implícita do cabeçalho

Padrão:

## Como o X Impacta o Y em 2026?

[Estatística da fonte] ([Nome da Fonte](url), ano). [Resposta direta à pergunta do
cabeçalho em 1-2 frases adicionais, explicando a implicação e o que isso significa
para o leitor.]

5d. Marcadores de Ganho de Informação

Distribua pelo menos 2-3 marcadores de ganho de informação ao longo do artigo. Estes sinalizam para mecanismos de busca e sistemas de IA que o conteúdo contém valor original não disponível em outros lugares.

Marque cada um com um comentário ou marcador visível:

• [DADOS ORIGINAIS] – Pesquisas proprietárias, experimentos, resultados de testes A/B, métricas de estudo de caso que o autor coletou em primeira mão
• [EXPERIÊNCIA PESSOAL] – Observações em primeira mão, lições aprendidas com envolvimento direto, narrativas "quando tentamos X, Y aconteceu"
• [PERCEPÇÃO ÚNICA] – Análise que outros não fizeram, perspectivas contrárias apoiadas por dados, conexões novas entre pesquisas existentes

Posicionamento:

• Incorpore ao texto do corpo naturalmente
• Use como comentários inline: <!-- [DADOS ORIGINAIS] --> antes do parágrafo relevante
• Ou como destaques visíveis se o formato suportar:

  > **Nossa descoberta:** [observação original apoiada por dados específicos]
  

• Mínimo de 2 por postagem, alvo de 3 para artigos abrangentes

Esses marcadores mapeiam diretamente para o critério "Marcadores de originalidade/valor único" na categoria de pontuação de Qualidade do Conteúdo (veja references/quality-scoring.md).

5e. Cápsulas de Citação

Para cada seção H2 principal, gere uma cápsula de citação – uma passagem autossuficiente de 40 a 60 palavras projetada para que sistemas de IA possam extraí-la e citá-la diretamente.

Requisitos por cápsula:

• 40-60 palavras, autossuficiente (faz sentido isoladamente)
• Contém: uma afirmação específica + um ponto de dados + atribuição de fonte
• Escrito em estilo declarativo e citável
• Colocado dentro do corpo da seção H2 (não como um bloco separado)

Exemplo:

De acordo com um estudo da Gartner de 2026, 58% dos compradores empresariais agora consultam assistentes de IA antes de contatar um fornecedor ([Gartner](https://www.gartner.com), 2026). Esta mudança significa que o conteúdo B2B deve responder perguntas específicas de forma concisa o suficiente para que sistemas de IA possam extraí-lo e citá-lo em suas respostas.

As cápsulas mapeiam para a categoria de pontuação "Prontidão para Citação de IA" (15 pontos) em references/quality-scoring.md.

5f. Zonas de Link Interno

Marque oportunidades de link interno ao longo do artigo usando notação de espaço reservado. O usuário (ou uma passagem de acompanhamento) resolverá estes para URLs reais.

Posicionamento da zona:

• Introdução – Link para conteúdo pilar relacionado ou hub de tópico
• Cada seção H2 – Link para artigos de apoio, mergulhos mais profundos, ferramentas relacionadas
• Seção de FAQ – Link de respostas para conteúdo detalhado que expande a resposta
• Conclusão – Link para a próxima peça lógica de conteúdo que o leitor deve consumir

Formato:

[LINK INTERNO: texto âncora → descrição do alvo]

Exemplo:

Para um mergulho mais profundo em agrupamento de palavras-chave, veja nosso
[LINK INTERNO: guia completo para agrupamento de palavras-chave → página pilar sobre metodologia de pesquisa de palavras-chave].

Alvo de 5 a 10 zonas de link interno por postagem de 2.000 palavras. Use texto âncora descritivo (nunca "clique aqui" ou "leia mais"). Consulte references/internal-linking.md para regras de texto âncora e estratégia de links.

5g. Regras de Parágrafo

• Cada parágrafo: 40-80 palavras (nunca exceda 150)
• Cada frase: máximo de 15-20 palavras
• Comece cada parágrafo com a informação mais importante
• Alvo de Facilidade de Leitura Flesch: 60-70

5h. Regras de Cabeçalho

• Um H1 (apenas título)
• H2s para seções principais (60-70% como perguntas)
• H3s para subseções apenas – nunca pule níveis
• Inclua a palavra-chave primária naturalmente em 2-3 cabeçalhos

5i. Incorporação de Imagem

Markdown padrão:

![Texto alternativo descritivo – palavras-chave do tópico naturalmente](https://cdn.pixabay.com/photo/...)

MDX com Next.js Image (se detectado):

![Texto alternativo descritivo – palavras-chave do tópico naturalmente](https://cdn.pixabay.com/photo/...)

• Coloque imagens após cabeçalhos H2, antes do texto do corpo
• Espaçamento uniforme ao longo da postagem (não agrupado)
• O texto alternativo deve ser uma frase descritiva completa

5j. Incorporação de Gráfico

Markdown/HTML padrão:

<figure>
  <svg viewBox="0 0 560 380" ...>...</svg>
  <figcaption>Fonte: [Nome da Fonte], [Ano]</figcaption>
</figure>

Formato MDX:

<figure className="chart-container" style={{margin: '2.5rem 0', textAlign: 'center', padding: '1.5rem', borderRadius: '12px'}}>
  <svg viewBox="0 0 560 380" ...>...</svg>
</figure>

5k. Incorporação de Vídeo

Incorpore vídeo do YouTube

…

[truncado para tradução]