🌟 Introdução

O BLOGGENAI é uma plataforma de automação de blogs com inteligência artificial. Ele integra o Claude AI (Anthropic) para gerar posts completos, otimizados para SEO, e os publica automaticamente no Blogger — com controle total de tom, frequência e distribuição.

Tudo é configurável: a identidade do autor, o vocabulário preferido, a quantidade de posts por semana, as integrações com redes sociais. Cada Projeto funciona de forma independente, com seu próprio blog, prompt de linguagem e fila de tópicos.

Plataformas de publicação suportadas

• ✅ Blogger — via Google OAuth 2.0
• ✅ WordPress — via REST API + Application Password
• ✅ Ghost — via Admin API com JWT

Distribuição de conteúdo

• 𝕏 Twitter / X — threads automáticas com hashtags
• 💼 LinkedIn — posts e artigos nativos
• 📰 Substack — newsletter por e-mail
• ✉️ Email — via Resend API ou SMTP (Gmail, Outlook...)

Conceitos fundamentais

• Projeto — Um blog independente. Cada projeto tem seu próprio Blogger ID, prompt de linguagem e fila de tópicos.
• Tópico — Um assunto na fila de publicação. Pode ter prioridade, palavras-chave, mood de imagem e comentários.
• Prompt de Linguagem — O "DNA do autor": define tom, vocabulário, estrutura e identidade do conteúdo gerado.
• Geração — O processo de 7 etapas que transforma um tópico em post completo com imagem e SEO.
• Rascunho — Posts gerados ficam como rascunho no Blogger até aprovação manual (quando Requer Aprovação está ativo).

🚀 Início Rápido

Para publicar seu primeiro post em menos de 5 minutos:

Escolha sua plataforma de blog

O BLOGGENAI suporta três plataformas. Configure pelo menos uma:

• Blogger: Configurações → Conexões → Blogger → Conectar com Google
• WordPress: Configurações → Conexões → WordPress → preencha URL, usuário e Application Password
• Ghost: Configurações → Conexões → Ghost → preencha URL e Admin API Key

1. Configure a plataforma — Em Projetos → Configurações → Conexões, configure o Blogger (OAuth), WordPress (Application Password) ou Ghost (Admin API Key). Use o botão "Testar conexão" para confirmar.
2. Crie um Tópico — Vá em Tópicos e clique em + Novo Tópico. Preencha título e categoria. Palavras-chave e prioridade são opcionais mas melhoram o resultado.
3. Gere o Post — No Dashboard, selecione o tópico no menu suspenso e clique em Gerar Post Agora. Acompanhe o progresso em tempo real.
4. Revise e Publique — O post vai para rascunho na plataforma configurada. Revise e publique quando estiver satisfeito.
5. Ative o Sistema — Ligue o toggle Sistema Ativo no Dashboard para que posts sejam gerados automaticamente no horário configurado.

🗣️ Prompt de Linguagem

O Prompt de Linguagem é o coração do sistema. Ele define quem escreve, como escreve e para quem escreve. Todo post gerado começa lendo este arquivo.

O que colocar no prompt

• Identidade do autor: nome, formação, área de atuação, credenciais relevantes
• Tom e voz: formal/informal, acadêmico/coloquial, entusiasta/sóbrio
• Vocabulário: termos que devem aparecer, gírias da área, palavras a evitar
• Estrutura preferida: tipo de abertura, uso de listas, tamanho dos parágrafos
• Público-alvo: leitor iniciante, especialista, gestor, etc.
• Posicionamento: ponto de vista, valores, causas defendidas

Boas práticas

• Escreva em primeira pessoa como se fosse o próprio autor instruindo um ghostwriter
• Inclua exemplos de frases no estilo desejado
• Liste termos do nicho que devem aparecer naturalmente
• Mencione o que não fazer: clichês do nicho, frases corporativas, etc.
• Atualize o prompt conforme o blog evolui

Checker de humanização

Após gerar o texto, o sistema aplica um score de humanização (0-100). Se o score for menor que 70, o post é reescrito automaticamente. O checker penaliza:

• Léxico corporativo-IA ("nesse sentido", "vale destacar", "é fundamental ressaltar"...)
• Ritmo monocórdio — frases com tamanho muito similar
• Estrutura repetitiva de parágrafos
• Fingerprints típicos do Claude

📝 Tópicos

A fila de tópicos é onde você organiza o que será publicado. Cada tópico tem status que controla seu ciclo de vida.

Status dos tópicos

• pending — Aguardando geração. Aparece no menu do Dashboard.
• generating — Sendo processado agora.
• done — Post gerado com sucesso.
• error — Falha na geração. Pode ser tentado novamente.

Campos do tópico

• Título — O assunto principal. Pode ser refinado pelo Claude durante a geração.
• Categoria — Organiza por área temática. Usada nas tags do Blogger.
• Palavras-chave — Termos SEO separados por vírgula. Influenciam o texto e os meta-dados.
• Prioridade — Alta, Média ou Baixa. O sistema gera primeiro os de maior prioridade quando usando geração automática sequencial.
• Mood da imagem — Orientação visual para a imagem gerada (ex: "abstrato, cores quentes", "minimalista, azul escuro").
• Comentários — Notas internas visíveis só no painel. Não influenciam o conteúdo gerado.

Geração por IA

O botão ✨ Gerar Tópicos usa Claude para criar uma lista de sugestões de tópicos baseada no prompt de linguagem e nos posts já publicados, evitando repetição de assuntos.

⚡ Geração de Posts

A geração é um pipeline de 7 etapas executadas em sequência. Você pode acompanhar o progresso no Dashboard em tempo real.

1. Carregar Prompt de Linguagem — Lê o language-prompt.md do projeto ativo.
2. Gerar Texto — Claude API (claude-sonnet-4-6) gera o post completo com até 8.192 tokens de resposta.
3. Verificar Qualidade — Aplica o checker de humanização. Score abaixo de 70 dispara reescrita.
4. Otimizar SEO, GEO e AEO — Gera meta-dados, slug, FAQ e Schema.org. Calcula scores 0-100 para cada dimensão.
5. Inserir Links Internos — Busca posts publicados relacionados e insere até 3 links internos naturais.
6. Gerar Imagem — Claude cria conceito visual simbólico → Pollinations.AI gera imagem 613×322 → URL embutida no <img src>.
7. Publicar no Blogger — Envia o post como rascunho (ou publicado, conforme configuração de aprovação).

Geração manual vs. automática

• Manual: Botão "Gerar Post Agora" no Dashboard. Você escolhe o tópico.
• Automática: Sistema ativo + agendamento configurado. Gera no horário programado, processando o primeiro tópico pendente de maior prioridade.

🗓️ Agendamento

O agendamento controla quando posts são gerados automaticamente. O sistema usa cron interno e verifica o horário a cada minuto.

Configurações

• Posts por semana — Quantos posts gerar por semana (1-7). O sistema distribui automaticamente pelos dias configurados.
• Dias da semana — Quais dias estão habilitados. Desmarcando sábado e domingo, por exemplo, o sistema só publica em dias úteis.
• Horário preferencial — Hora do dia para geração (ex: 08:00). O sistema dispara neste horário se o dia estiver habilitado e houver tópicos pendentes.
• Requer Aprovação — Quando ativo, posts vão para rascunho no Blogger. Quando inativo, são publicados diretamente.

Executar agora

O botão ▶ Executar Agora dispara uma geração imediata ignorando o horário agendado — útil para testes ou quando você quer publicar fora do horário normal.

📈 SEO / GEO / AEO

O BLOGGENAI otimiza cada post em três dimensões complementares de visibilidade:

O que cada score mede

• SEO (Search Engine Optimization): Título otimizado, meta-description, palavras-chave no texto, contagem de palavras adequada, uso de headings H2/H3.
• GEO (Generative Engine Optimization): Definições claras, dados e números no texto, citações e fontes, listas estruturadas, termos em negrito para facilitar extração por LLMs.
• AEO (Answer Engine Optimization): Seção FAQ com microdata, Schema.org JSON-LD, perguntas explícitas no texto, respostas diretas e concisas.

O que é gerado automaticamente

• Meta-description — 150-160 caracteres otimizados para CTR
• Meta-keywords — Lista de termos relevantes
• Slug — URL amigável gerada do título
• FAQ — 3-5 perguntas e respostas com microdata itemscope
• Schema.org JSON-LD — Markup estruturado para rich results
• Tempo de leitura — Calculado em minutos

Metadados enviados para cada plataforma

• Blogger: Conteúdo HTML completo com Schema.org JSON-LD, FAQ com microdata e tags inferidas das palavras-chave
• WordPress: Meta description via campo Yoast SEO (_yoast_wpseo_metadesc), slug otimizado, tags criadas automaticamente
• Ghost: Meta description, slug, excerpt (resumo) e tags — todos gerados pela otimização SEO/GEO/AEO

Página de análise

Em SEO/GEO/AEO você vê os scores de todos os posts publicados, pode filtrar por nível de otimização e reotimizar posts existentes individualmente.

📝 Blogger

O Blogger é a plataforma de publicação. A integração usa OAuth 2.0 do Google para autorizar operações na API do Blogger.

Como conectar

1. Crie credenciais OAuth no Google Cloud Console (tipo: Web application). Adicione https://bloggenai.com.br/api/auth/google/callback como URI de redirecionamento autorizado.
2. Configure as variáveis GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET e BLOGGER_BLOG_ID no arquivo .env.
3. Autorize em Projetos → Configurações → Integrações → Conectar Blogger. Uma janela do Google abrirá para você autorizar.
4. Teste usando o botão "Testar conexão". O painel mostrará o título do blog confirmando o acesso.

Publicação como rascunho

Com Requer Aprovação ativo em Agendamento, os posts vão para rascunho. Você revisa no Blogger e clica em Publicar quando estiver satisfeito. Isso é recomendado especialmente no início, até ter confiança na qualidade gerada.

🔷 WordPress

Publique posts automaticamente no WordPress via REST API usando Application Passwords — sem precisar de plugins adicionais.

O que você precisa

• URL do site: Endereço raiz do WordPress (ex: https://meusite.com)
• Usuário: Nome de usuário administrador do WP
• Application Password: Senha de aplicativo gerada no perfil do usuário

Como obter o Application Password

1. Acesse o painel Admin do WordPress
2. Vá em Usuários → Perfil
3. Role até a seção Application Passwords
4. Digite um nome para identificar (ex: "BLOGGENAI")
5. Clique em Adicionar nova senha de aplicativo
6. Copie a senha gerada — formato: xxxx xxxx xxxx xxxx xxxx xxxx

Pré-requisitos do WordPress

• Permalinks configurados: WP Admin → Configurações → Links Permanentes → selecione qualquer opção exceto "Simples"
• REST API ativa: Ativada por padrão no WP 4.7+. Alguns plugins de segurança podem desativá-la
• HTTPS recomendado: Application Passwords exigem HTTPS em produção

Status padrão ao publicar

• Rascunho: Post salvo mas não visível — recomendado para revisão antes de publicar
• Publicado: Post vai direto ao ar — use com cuidado

Categoria padrão

Configure uma categoria padrão opcional para todos os posts. Para encontrar o ID:

1. WP Admin → Posts → Categorias
2. Clique em Editar na categoria desejada
3. O ID aparece na URL da página de edição: term_id=5

Publicação manual vs automática

• Manual: No dashboard, clique no botão 🔷 WordPress em qualquer post gerado
• Automática: Ative o toggle "Auto-publicar com Blogger" nas configurações. O sistema publica automaticamente se a conexão estiver com status "ok"

👻 Ghost

Publique posts no Ghost via Admin API — compatível com Ghost.io (hospedagem oficial) e instalações self-hosted.

O que você precisa

• URL do site: Endereço raiz do Ghost (ex: https://meusite.ghost.io)
• Admin API Key: Chave gerada nas integrações do Ghost Admin (formato: id:secret_hex)

Como obter a Admin API Key

1. Acesse o painel Ghost Admin
2. Vá em Settings → Integrations
3. Clique em Add custom integration
4. Digite um nome para identificar (ex: "BLOGGENAI")
5. Copie a Admin API Key — formato: id:secret

Ghost.io vs Self-hosted

• Ghost.io: Hospedagem oficial. URL no formato meusite.ghost.io. Plano gratuito disponível para desenvolvimento
• Self-hosted: Ghost instalado no seu próprio servidor. Mais controle, sem limites de posts. Requer Ghost v2.0 ou superior

Status padrão ao publicar

• Rascunho (draft): Salvo mas não visível para leitores — recomendado para revisão
• Publicado (published): Visível imediatamente para todos os leitores

Tags e SEO enviados automaticamente

• Tags do tópico como tags do Ghost (criadas automaticamente se não existirem)
• Meta description gerada pela otimização SEO/GEO/AEO
• Slug otimizado para SEO
• Excerpt (resumo) gerado a partir da meta description

Publicação manual vs automática

• Manual: No dashboard, clique em 👻 Ghost em qualquer post
• Automática: Ative o toggle "Auto-publicar com Blogger" nas configurações. O sistema publica automaticamente se a conexão estiver com status "ok"

🐦 Twitter / X

Integração para divulgação automática de posts publicados no Twitter/X.

Configuração

Requer credenciais da Twitter Developer API v2 (OAuth 1.0a ou OAuth 2.0 com PKCE):

• TWITTER_API_KEY / TWITTER_API_SECRET
• TWITTER_ACCESS_TOKEN / TWITTER_ACCESS_SECRET

Configure em Projetos → Configurações → Integrações → Twitter.

Comportamento

• Thread opcional com resumo do post + link
• Imagem do post anexada ao tweet principal
• Hashtags geradas automaticamente das tags do post
• Agendamento independente do horário de publicação no Blogger

💼 LinkedIn

Publicação automática de artigos e posts no LinkedIn após publicação no Blogger.

Configuração

Requer uma aplicação LinkedIn com permissões w_member_social e r_liteprofile:

• LINKEDIN_CLIENT_ID / LINKEDIN_CLIENT_SECRET
• Autorização OAuth via painel em Projetos → Configurações → Integrações → LinkedIn

Formatos suportados

• Post simples: Texto + link para o post no Blogger
• Artigo nativo: Conteúdo completo publicado como artigo LinkedIn (requer w_member_social com escopo de artigo)

📰 Substack

Distribuição de posts via newsletter no Substack — ideal para construir audiência com e-mail.

Configuração

O Substack não tem API pública oficial. A integração usa automação de formulário ou a API não documentada com cookie de sessão:

• SUBSTACK_PUBLICATION_URL — URL da sua publicação (ex: seublog.substack.com)
• SUBSTACK_SESSION_COOKIE — Cookie substack.sid obtido após login manual

Fluxo de publicação

Após publicação no Blogger, o conteúdo é adaptado para o formato Substack (ajuste de formatação HTML) e enviado como rascunho de newsletter. Você decide quando enviar para os assinantes.

✉️ Newsletter & Email

O BLOGGENAI envia e-mails automaticamente para seus inscritos quando um novo post é publicado. Escolha entre dois provedores: Resend (recomendado) ou SMTP (Gmail, Outlook, servidor próprio). Configure em: Projetos → Configurações → aba Email. Cada projeto pode ter seu próprio provedor.

📨 Opção 1 — Resend (recomendado)

API moderna de e-mail, sem necessidade de configurar servidor SMTP. A opção mais simples e confiável.

Vantagens do Resend

• Plano gratuito: 3.000 e-mails/mês
• Sem configurar servidor — apenas uma API Key
• Alta taxa de entrega e dashboard com métricas
• Suporte a domínio personalizado

Como configurar o Resend

1. Acesse resend.com e crie uma conta gratuita
2. Vá em API Keys → Add API Key e copie a chave (começa com re_)
3. No servidor, adicione ao .env: RESEND_API_KEY=re_sua_chave_aqui
4. Em Projetos → Configurações → Email, selecione Resend e configure o nome do remetente do projeto

Verificar domínio no Resend

1. Resend.com → Domains → Add Domain → informe seu domínio
2. Adicione os registros DNS indicados (SPF, DKIM, DMARC)
3. Aguarde verificação (pode levar até 48h)
4. Atualize RESEND_FROM_EMAIL no .env do servidor

📬 Opção 2 — SMTP

Use qualquer servidor SMTP: Gmail, Outlook, Zoho, hospedagem cPanel, ou servidor próprio.

Configurações gerais

• Host: Endereço do servidor SMTP
• Porta: 587 (STARTTLS, recomendado) ou 465 (SSL/TLS)
• Usuário: Seu endereço de e-mail completo
• Senha: Senha normal ou senha de aplicativo

Configurações por provedor

Gerenciar inscritos

• Adicionar: Projetos → Configurações → Email → Destinatários → + Adicionar
• Ativar/desativar: Toggle ao lado de cada destinatário
• Remover: Ícone de exclusão ao lado do destinatário

Envio automático vs manual

• Automático: Habilitado em Configurações → Email → Enviar ao publicar. Disparado após cada publicação
• Manual: Dashboard → botão "✉️ Enviar" ou "↩️ Reenviar" em qualquer post

Testar o envio

1. Projetos → Configurações → aba Email → configure provedor e salve
2. Clique em Testar conexão — verifica credenciais sem enviar e-mail
3. Digite um e-mail no campo de teste e clique Enviar teste
4. Verifique a caixa de entrada (e a pasta spam)

📡 Monitor de Pauta

O Monitor de Pauta monitora feeds RSS/Atom de fontes relevantes e sugere tópicos baseados nas tendências do momento.

Como funciona

• Configure feeds RSS das suas fontes de referência (blogs, portais, sites especializados)
• O sistema verifica os feeds periodicamente e indexa novos artigos
• Claude analisa os títulos e assuntos dos artigos e sugere tópicos alinhados ao seu nicho
• Tópicos sugeridos aparecem na lista — você escolhe quais adicionar à fila

Adicionando feeds

Em Monitor de Pauta → Configurar Feeds, adicione URLs de feeds RSS. Exemplo para um portal de notícias:

https://exemplo.com/feed.xml

🗂️ Projetos

Projetos são blogs independentes dentro do BLOGGENAI. Cada um tem configuração isolada: blog Blogger, prompt de linguagem, tópicos, agendamento e membros.

Criar um projeto

1. Clique em + Novo Projeto na página de Projetos.
2. Preencha nome, descrição e cor do projeto.
3. O sistema cria a estrutura de dados e um template de prompt de linguagem para preencher.
4. Configure as integrações (Blogger, etc.) nas configurações do projeto.
5. Clique em Usar este projeto para ativá-lo — todas as ações passarão a operar nele.

Membros do projeto

Usuários com role user só veem os projetos onde são membros. Administradores veem todos os projetos. Para adicionar um membro:

• Abra as configurações do projeto
• Vá na aba 👥 Membros
• Digite o e-mail do usuário e clique em Adicionar

👥 Usuários

Gerenciamento de contas de acesso ao painel. Disponível apenas para administradores.

Roles (Perfis de acesso)

• admin — Acesso completo. Vê todos os projetos, pode gerenciar usuários, configurar formatação, acessar logs e monitor do sistema.
• user — Acesso aos projetos onde é membro. Pode editar prompt de linguagem, tópicos e agendamento. Não acessa logs, formatação nem configurações de sistema.

Criar usuário

Em Usuários → Novo Usuário, preencha nome, e-mail, senha e role. A senha deve ter no mínimo 8 caracteres.

Usuários também podem se registrar na tela de login clicando em Criar conta. Novas contas criadas desta forma recebem role user automaticamente.

Alterar senha

Usuários podem alterar sua própria senha em Perfil → Alterar Senha. Administradores podem redefinir senhas de qualquer usuário.

🖥️ Monitor do Sistema

O Monitor exibe o estado em tempo real do servidor, logs e processos em execução.

O que você vê

• Status do servidor: Uptime, uso de memória, versão do Node.js
• Logs em tempo real: Saída do data/app.log com filtro por nível (info, warn, error)
• Status de geração: Se há uma geração em andamento e em qual etapa
• Configurações de ambiente: Quais variáveis estão configuradas (sem expor valores sensíveis)

Logs

Para que os logs apareçam no Monitor, o processo gerador deve redirecionar saída para data/app.log:

blog generate >> data/app.log 2>&1

Quando usado via PM2 ou com o servidor web rodando, os logs são capturados automaticamente.

🔐 Segurança

Boas práticas de segurança para manter o painel protegido.

Autenticação

• Sessões JWT com expiração de 8 horas
• Rate limiting no login: 5 tentativas por minuto por IP
• Senhas com hash bcrypt (custo 10)
• Auditoria de todas as ações importantes no log

Configurações críticas

Recomendações para produção

• Use Nginx como reverse proxy — nunca exponha o Node diretamente na porta 80/443
• Ative HTTPS com certificado Let's Encrypt
• Restrinja acesso ao painel por IP se possível (firewall/allowlist)
• Faça backup regular de data/ e config/
• Monitore data/app.log para atividades suspeitas
• Revise periodicamente a lista de usuários e remova contas inativas

Auditoria

Toda ação sensível (login, criação/exclusão de usuário, mudança de configuração, geração de post) é registrada em log com timestamp, IP e usuário. Acesse em Auditoria (admin apenas).