# 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… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfaeomonitor/index.md), [en](https://www.datafirefly.com/en/documentation/dfaeomonitor/index.md), [es](https://www.datafirefly.com/es/documentation/dfaeomonitor/index.md), [de](https://www.datafirefly.com/de/documentation/dfaeomonitor/index.md), [it](https://www.datafirefly.com/it/documentation/dfaeomonitor/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaeomonitor/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaeomonitor/index.md) - Índice: ## 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. Aparece um menu **AEO Monitor** na barra lateral da administração, com seis páginas: Painel, Prompts, Resultados, Páginas acompanhadas, Recomendações e Definições. ## 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. Uma única API chega para começar, mas três fornecedores ou mais dão uma visão representativa. Uma auditoria semanal de 10 prompts em 5 LLM (50 chamadas) custa tipicamente entre 0,30 e 1,20 euros com os modelos económicos. ### 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. Associar um URL alvo a um prompt permite medir com precisão se os LLM remetem para a página certa: a pontuação ganha 20 pontos quando o URL exato é citado. ## 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. Se o URL llms.txt devolver um 404, volte a guardar os permalinks em Definições → Permalinks. O filtro dfaeo_llmstxt_lines permite aos programadores alterar as linhas geradas. ## 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.