# Como corrigir o Site Audit do Rank Math que não roda no WordPress

O erro do Rank Math Site Audit acontece quando o SEO Analyzer não consegue rodar, não conclui a análise ou retorna sem resultado, geralmente porque o servidor da Rank Math não alcança o site, o ambiente é local ou a análise completa exige a versão PRO.

## O que é Site Audit do Rank Math que não roda?

O Rank Math Site Audit é o resultado do SEO Analyzer (SEO Analysis), a ferramenta que examina o site em busca de problemas de configuração de SEO. Ela roda cerca de 32 testes divididos em cinco categorias (Prioridade, SEO Básico, SEO Avançado, Desempenho e Segurança) e devolve uma nota de 0 a 100 separada em testes aprovados, avisos e falhas. O fluxo é simples: você abre SEO, SEO Analyzer e clica em Start SEO Analyzer.

O ponto que mais gera confusão é que a análise não é feita só dentro do seu WordPress. Conforme a documentação oficial, a Rank Math precisa buscar a sua página a partir do servidor dela para analisar, então o SEO Analyzer só funciona em sites no ar e acessíveis pelo servidor da Rank Math. Quando essa busca externa falha, ou quando se espera uma análise de todas as páginas que só a versão PRO oferece, o Site Audit aparenta estar com erro: fica carregando, não conclui ou volta sem resultado.

## Como identificar

- A barra de progresso do SEO Analyzer fica carregando e a análise nunca termina ao clicar em Start SEO Analyzer.
- A tela exibe a mensagem de que o site é local: 'Rank Math needs to fetch your page for analysis, and hence the SEO Analyzer is available only on live sites that are accessible by our server'.
- A análise conclui mas mostra apenas a página inicial, sem auditar as demais páginas e posts do site.
- O SEO Analyzer retorna a nota zerada ou em branco, sem listar testes aprovados, avisos ou falhas.
- Aparece um erro de conexão ou de tempo esgotado ao tentar iniciar a análise no painel da Rank Math.

**Antes de começar:** Antes de desativar firewall, plugin de segurança ou proteção por senha para testar, faça em uma janela curta e de preferência em um ambiente de staging. Reative todas as proteções assim que terminar o teste para não deixar o site exposto.

## Como prevenir

- Mantenha a opção de indexação ligada e o site publicamente acessível em produção, já que o SEO Analyzer depende do servidor da Rank Math conseguir buscar a página.
- Configure o firewall, o plugin de segurança e o CDN com uma exceção permanente para as requisições externas da Rank Math, evitando bloqueios silenciosos.
- Use staging apenas para testes e rode o SEO Analyzer no domínio de produção, que é o único ambiente que o servidor da Rank Math alcança.
- Antes de cobrar a auditoria do site inteiro, confirme se o plano é PRO, já que a versão grátis analisa somente a página inicial por design.

Erros relacionados

- [Como corrigir marcação inválida no Schema Generator do Rank Math](https://full.services/wp-fixer/corrigir-schema-generator-rank-math/)
- [Como corrigir a integração do Analytics no Rank Math PRO](https://full.services/wp-fixer/corrigir-analytics-integration-rank-math/)
- [Como corrigir o score baixo no Content Analysis do Rank Math](https://full.services/wp-fixer/corrigir-content-analysis-score-rank-math/)

## Causa

- O servidor da Rank Math não consegue buscar a página: a documentação oficial diz que a análise é feita por fetch externo, então um firewall, um plugin de segurança ou uma proteção de hospedagem que bloqueia requisições externas impede o SEO Analyzer de concluir.
- O site está rodando em ambiente local ou em staging não publicado: a doc afirma que o SEO Analyzer só funciona em sites no ar e acessíveis pelo servidor da Rank Math, então em localhost ou atrás de senha o Site Audit não roda.
- A expectativa é de análise de todas as páginas, mas a conta usa a versão grátis: na versão grátis o SEO Analyzer analisa apenas a página inicial, e a auditoria do site inteiro exige a versão PRO.
- O site exige autenticação HTTP (htpasswd), está com a opção 'Desencorajar mecanismos de busca' ligada ou retorna noindex, fazendo o servidor da Rank Math receber uma resposta que não permite concluir a análise.
- Um proxy ou CDN à frente do site (como uma camada de proteção contra bots) responde com bloqueio ou desafio à requisição da Rank Math em vez de servir a página real, deixando o Site Audit sem dados para pontuar.

## Como resolver

1. Confirme que o site está no ar e acessível publicamente: A doc oficial é clara: a Rank Math precisa buscar a sua página a partir do servidor dela. Garanta que o site não está em localhost, não está atrás de senha de manutenção e responde publicamente antes de qualquer outro ajuste.

```
Abra a URL pública do site em uma aba anônima do navegador
Painel WP -> Configurações -> Leitura -> desmarque 'Desencorajar os motores de busca de indexar este site'
```

2. Libere a requisição externa da Rank Math no firewall e no plugin de segurança: Plugins de segurança e firewalls de hospedagem podem barrar a busca externa que o SEO Analyzer faz. Desative temporariamente a proteção para testar e, se resolver, peça à hospedagem para liberar o fetch da Rank Math em vez de manter tudo desligado.

```
Painel WP -> desative temporariamente o plugin de firewall ou segurança ativo
Painel WP -> SEO -> SEO Analyzer -> Start SEO Analyzer (teste novamente)
Reative a segurança e, no painel da hospedagem ou CDN, libere as requisições externas da Rank Math
```

3. Verifique a versão e o que cada uma analisa: Na versão grátis o SEO Analyzer cobre apenas a página inicial. Se você espera a auditoria de todas as páginas e posts, esse comportamento não é erro: a análise do site inteiro depende da versão PRO. Confirme qual recurso você realmente precisa antes de tratar como falha.

```
Painel WP -> Plugins -> verifique se está ativo o Rank Math SEO ou o Rank Math SEO PRO
Painel WP -> SEO -> SEO Analyzer -> confira se o resultado corresponde a 'apenas página inicial' (grátis) ou 'site inteiro' (PRO)
```

4. Remova bloqueios de acesso que retornam resposta inválida: Autenticação HTTP (htpasswd), página de manutenção ou um desafio de bot fazem o servidor da Rank Math receber uma resposta que não é a página real. Libere o acesso público da home para que o fetch retorne o HTML correto.

```
No painel da hospedagem, desative a proteção por senha (htpasswd) da home durante o teste
Desative plugins de modo de manutenção ou 'coming soon' enquanto roda a análise
```

5. Confirme que a REST API do WordPress responde: O painel do SEO Analyzer troca dados via REST API. Se a REST API estiver bloqueada por plugin de segurança ou regra de servidor, a tela fica carregando sem concluir. Cheque a saúde do site e a resposta da REST antes de reiniciar a análise.

```
Painel WP -> Ferramentas -> Saúde do Site -> verifique avisos sobre a REST API
Acesse https://seudominio.com/wp-json/ no navegador e confirme que retorna JSON em vez de erro
```


## Código

```php
<?php
// Garante que a REST API do WordPress responda para o SEO Analyzer.
// Cole no functions.php do tema filho ou em um plugin utilitario.
add_filter( 'rest_authentication_errors', 'full_liberar_rest_para_analyzer', 99 );
function full_liberar_rest_para_analyzer( $result ) {
    // Se outro plugin ja barrou a REST com erro, remove o bloqueio geral.
    if ( is_wp_error( $result ) ) {
        return true;
    }
    return $result;
}
```

## Perguntas frequentes

### Por que o Rank Math Site Audit não roda no meu site

Quase sempre é porque o servidor da Rank Math não consegue buscar a sua página. A documentação oficial explica que a análise é feita por fetch externo, então site local, atrás de senha ou com firewall bloqueando a requisição impede o SEO Analyzer de concluir.

### O SEO Analyzer funciona em site local ou em localhost

Não. A doc da Rank Math diz que o SEO Analyzer só funciona em sites no ar e acessíveis pelo servidor dela, porque ela precisa buscar a sua página para analisar. Em localhost a ferramenta exibe o aviso de que o site está hospedado localmente.

### Por que o Site Audit analisa só a página inicial

Na versão grátis o SEO Analyzer analisa apenas a página inicial. A auditoria de todas as páginas e posts do site exige a versão PRO, então analisar só a home na versão grátis é o comportamento esperado, não um erro.

### Meu firewall pode estar bloqueando o SEO Analyzer

Sim. Como a análise depende de uma requisição externa que busca a sua página, um firewall, um plugin de segurança ou uma proteção de bots da hospedagem pode barrar esse acesso. Libere a requisição da Rank Math e teste a análise novamente.

### Quantos testes o SEO Analyzer da Rank Math faz

A ferramenta roda cerca de 32 testes divididos em cinco categorias: Prioridade, SEO Básico, SEO Avançado, Desempenho e Segurança. O resultado vem como uma nota de 0 a 100, separada em testes aprovados, avisos e falhas.

### O SEO Analyzer fica carregando e nunca termina, o que faço

Verifique se o site é público, se a REST API responde e se nenhum plugin de segurança bloqueia o acesso externo. Abra a Saúde do Site para checar a REST API e teste a URL wp-json no navegador antes de reiniciar a análise.

### Preciso da versão PRO para auditar o site inteiro

Sim. A versão grátis cobre apenas a página inicial. Para a auditoria de todas as páginas e posts, com a análise do site completo, é necessário o Rank Math PRO conforme a documentação oficial.

**Fonte:** [Rank Math — How to Use the SEO Analysis Tool](https://rankmath.com/kb/seo-analysis/)