AEO Monitor & Optimizer: guia completo

Apresentação

O AEO Monitor & Optimizer mede a visibilidade da sua marca nas respostas de cinco assistentes de IA (ChatGPT da OpenAI, Claude da Anthropic, Perplexity, Gemini da Google e Mistral) e gera depois recomendações concretas para a melhorar. O plugin envia os seus prompts de monitorização a cada LLM ativado, analisa as respostas (menções de marca, citações de domínio, URL exatos, concorrentes), calcula uma pontuação de visibilidade de 0 a 100 e serve um ficheiro llms.txt dinâmico.

O plugin funciona em modelo BYOK (Bring Your Own Key): usa as suas próprias chaves de API e as chamadas partem diretamente do seu servidor para as API oficiais. Nenhum dado passa pela DataFirefly.

Requisitos

• WordPress 6.0 ou superior (testado até à 6.7)
• PHP 7.4 ou superior (recomendado 8.1+)
• WooCommerce 7.0+ apenas para o acompanhamento automático dos produtos e a geração de prompts por categoria (opcional)
• Pelo menos uma chave de API entre: OpenAI, Anthropic, Perplexity, Google Gemini e Mistral
• WP-Cron funcional (ou um cron de sistema que chame o wp-cron.php) para as auditorias agendadas

Instalação

1. Descarregue o ficheiro ZIP a partir da sua conta de cliente DataFirefly.
2. Na administração do WordPress, vá a Plugins → Adicionar → Carregar plugin, selecione o ficheiro dfaeomonitor.zip e clique em Instalar agora.
3. Clique em Ativar. O plugin cria automaticamente as suas 6 tabelas de base de dados e agenda o cron de auditoria semanal.
4. Vá a Definições → Permalinks e clique em Guardar (sem alterar nada) para atualizar as regras de reescrita do URL llms.txt.

Configuração inicial

1. Marca e site

Em AEO Monitor → Definições, preencha:

• Nome da marca: o nome exato que os LLM deveriam citar.
• Nomes alternativos: outras grafias ou nomes comerciais (um por linha). Cada alternativa conta como uma menção de marca.
• Domínio principal: o seu domínio sem http nem www (exemplo: aminhaloja.pt). Qualquer citação de um URL deste domínio conta como citação de domínio.
• Concorrentes: uma marca por linha. O plugin deteta quando um LLM fala deles em vez de si e aplica uma penalização à pontuação.

2. Fornecedores de LLM

Ainda nas Definições, ative os fornecedores que quer consultar e cole a chave de API correspondente:

• OpenAI: chave em platform.openai.com. Modelo recomendado para a monitorização: gpt-4o-mini. O plugin usa a API Responses com a ferramenta de pesquisa web.
• Anthropic: chave em console.anthropic.com. A chamada usa a API Messages com a ferramenta de pesquisa web.
• Perplexity: chave em perplexity.ai. Modelo sonar-pro com citações nativas, o fornecedor mais rico em fontes.
• Google Gemini: chave no Google AI Studio. O grounding com a Pesquisa Google é ativado automaticamente.
• Mistral: chave em console.mistral.ai. Pesquisa web quando disponível, e recurso ao conhecimento interno do modelo caso contrário.

3. Agendamento

• Cadência de auditoria: semanal (recomendada) ou diária.
• Máximo de prompts por auditoria: limite de prompts enviados em cada execução. Recorde-se de que cada prompt é enviado a cada LLM ativado.
• Tempo limite do pedido: duração máxima de uma chamada à API (45 segundos por predefinição).
• Acompanhamento automático: assinale para acompanhar automaticamente cada novo produto WooCommerce publicado e, se quiser, cada nova página.
• llms.txt dinâmico: ativa a resposta do site no URL llms.txt.

Criar e gerir os prompts

Um prompt é uma pergunta feita tal e qual aos LLM, formulada como um utilizador real a faria. Exemplos: «Quais são os melhores módulos de SEO para PrestaShop?», «Que loja recomendas para comprar ténis de couro em Portugal?»

Em AEO Monitor → Prompts pode:

• Criar um prompt manualmente, com uma designação interna, o texto da pergunta, uma intenção (marca, produto, categoria, concorrente, informacional), um idioma e, opcionalmente, um URL alvo cuja citação queira acompanhar.
• Gerar prompts predefinidos: o botão dedicado cria automaticamente prompts de marca e um prompt por categoria do WooCommerce, no idioma do site.
• Ativar ou desativar um prompt sem o eliminar: só os prompts ativos são enviados nas auditorias.

Lançar uma auditoria

Há três formas de desencadear uma auditoria:

1. Botão «Lançar uma auditoria agora» no painel: a execução arranca em segundo plano nos segundos seguintes.
2. Cron agendado: automático conforme a cadência escolhida nas definições.
3. WP-CLI: o comando wp dfaeo audit executa a auditoria de forma síncrona, com o detalhe no terminal.

Durante a auditoria, cada prompt ativo é enviado a cada fornecedor ativado com um intervalo de 300 ms entre as chamadas. As respostas são guardadas e analisadas, e as recomendações são geradas automaticamente no fim da execução.

Compreender a pontuação de visibilidade

Cada resposta de LLM recebe uma pontuação de 0 a 100, calculada assim:

• +30 pontos se a sua marca for mencionada, mais um bónus até +15 conforme o número de repetições
• +25 pontos se o seu domínio for citado nas fontes
• +20 pontos se o URL alvo exato do prompt for citado
• +5 pontos se a resposta contiver fontes
• Penalização até -15 pontos conforme o número de menções a concorrentes

O painel agrega estas pontuações: média global, taxa de menção da marca, taxa de citação do domínio, evolução a 7, 30 ou 90 dias, e comparação das cinco plataformas.

Páginas acompanhadas e pontuação de cobertura

A página Páginas acompanhadas lista os URL cuja indexação pelos LLM está a monitorizar. A pontuação de cobertura de uma página aumenta sempre que um LLM cita o seu URL exato e desce ligeiramente a cada auditoria sem citação (fator 0,98), o que reflete a frescura real da sua presença.

• Os produtos WooCommerce publicados são acrescentados automaticamente se a opção estiver ativa.
• Pode acrescentar manualmente qualquer URL com um tipo (página, produto, artigo, categoria) e uma prioridade de 1 a 10.
• As páginas com prioridade elevada mas pontuação baixa geram automaticamente recomendações.

Recomendações

Depois de cada auditoria, o motor de recomendações analisa as páginas com dificuldades e propõe ações classificadas por gravidade (alta, média, baixa):

• FAQ em JSON-LD: bloco de código pronto a colar no cabeçalho da página, com perguntas e respostas geradas a partir do conteúdo.
• Schema Product: dados estruturados enriquecidos para as fichas WooCommerce (preço, disponibilidade, avaliações), preenchidos a partir dos dados reais do produto.
• Resumo TL;DR: um parágrafo de 60 a 80 palavras para colocar no início do conteúdo, um formato que os LLM extraem com facilidade.
• Schema Organization: identidade de marca reforçada, para limitar as confusões e as alucinações sobre a sua empresa.
• robots.txt: regras de autorização para os crawlers de IA: GPTBot, ClaudeBot, PerplexityBot, Google-Extended.
• Prioridade no llms.txt: promoção de uma página estratégica no ficheiro llms.txt dinâmico.

Cada recomendação pode ser marcada como Em curso, Resolvida ou Ignorada. O código proposto aparece num bloco expansível, pronto a copiar.

O ficheiro llms.txt dinâmico

Quando a opção está ativa, o seu site responde no URL llms.txt com um índice em Markdown gerado em contínuo:

• Top references: as páginas mais bem detetadas pelos LLM, ordenadas pela pontuação de cobertura.
• Priority pages: as páginas com prioridade 5 ou superior que ainda não estão bem detetadas.
• Catalog: as suas principais categorias do WooCommerce.
• About: nome da marca, URL do site e contacto.

WP-CLI

Estão disponíveis três comandos para a automatização:

«wp dfaeo audit» lança uma auditoria síncrona (opção --prompts=5 para limitar)
«wp dfaeo seed» gera os prompts predefinidos a partir da marca e das categorias
«wp dfaeo report --days=30» apresenta o relatório agregado (opção --format=json ou csv)

O comando report é ideal para alimentar uma ferramenta de BI ou um painel externo através de uma tarefa cron de sistema.

Resolução de problemas

• «Nenhuma auditoria conseguiu arrancar»: verifique que há pelo menos um fornecedor ativado com uma chave de API válida e pelo menos um prompt ativo.
• Erros 401 ou 403 nos resultados: a chave de API do fornecedor em causa é inválida ou expirou. Os erros são visíveis no detalhe de cada resultado.
• Erros 429: quota de API atingida no fornecedor. Reduza o número de prompts por auditoria ou passe à cadência semanal.
• O cron não dispara: nos sites de baixo tráfego, o WP-Cron só é executado durante as visitas. Configure um cron de sistema que chame o wp-cron.php a cada 15 minutos.
• llms.txt em 404: volte a guardar os permalinks, ou desative e reative o plugin.
• Gráficos vazios no painel: é normal antes da primeira auditoria concluída. Verifique também que nenhum bloqueador de scripts impede o carregamento do Chart.js a partir do CDN jsdelivr.

Desinstalação

A desativação conserva todos os seus dados. A remoção do plugin a partir da página de Plugins desencadeia a limpeza completa: as 6 tabelas (prompts, runs, results, citations, pages, recommendations), as opções e as tarefas cron são eliminadas definitivamente.

Privacidade e RGPD

O plugin não envia qualquer dado à DataFirefly e não inclui telemetria. As únicas chamadas de saída vão para as API dos LLM que ativou, com as suas chaves. Os prompts que redige são transmitidos a esses fornecedores terceiros: evite incluir neles dados pessoais de clientes. As chaves de API são guardadas na tabela de opções do WordPress, na sua base de dados.