SEOPress Broken Link Checker: corrigir o erro de scan

Tipo SEO Tecnico

Nome do erro Broken Link Checker do SEOPress nao escaneia EN: SEOPress Broken Link Checker not working

Severidade Informativo

Descrição O erro do Broken Link Checker no SEOPress acontece quando o scan de links quebrados não roda, não retorna resultados ou trava, geralmente porque o recurso so existe no SEOPress PRO, o WP-Cron esta inativo ou o limite de execução do servidor interrompe o bot antes de terminar a varredura.

O que é erro do Broken Link Checker no SEOPress?

O SEOPress Broken Link Checker e o recurso do SEOPress PRO que varre o conteúdo do site em busca de links quebrados e mostra dois dados centrais: a URL quebrada e a URL onde o link quebrado foi encontrado. Segundo a documentação oficial, ele e iniciado manualmente: você vai em SEO, abre a aba Audit para definir os tipos de post a escanear, depois na aba de scan clica em Launch the bot para disparar a varredura, e os resultados aparecem em SEO, Broken links. O recurso e exclusivo do PRO, entao no SEOPress gratuito o menu simplesmente não existe.

O erro aparece de três formas práticas: o menu Broken links não surge porque a versão instalada e a gratuita, o bot e disparado mas a tabela de resultados continua vazia ou parada, ou o scan comeca e e interrompido no meio em sites grandes. As causas costumam ser a ausencia da licenca PRO ativa, o WP-Cron desligado ou bloqueado pela hospedagem (o bot processa o conteúdo em lotes em segundo plano) e limites de tempo ou memória do PHP que matam o processo antes do fim. Falsos positivos também ocorrem quando o destino bloqueia bots e devolve 403 ou 429, fazendo um link valido aparecer como quebrado.

Como identificar

O submenu ‘Broken links’ não aparece em SEO no painel, mesmo com o SEOPress ativo.
Você clica em ‘Launch the bot!’ na aba de scan e a varredura inicia, mas a tabela de resultados continua vazia ou não avança.
O scan trava no meio em sites com muitos posts e a página retorna timeout, ‘504 Gateway Time-out’ ou ‘500 Internal Server Error’.
Links que abrem normalmente no navegador aparecem listados como quebrados com status 403 ou 429.
A aba Audit não mostra a opção de escolher tipos de post nem o botão do bot, indicando que o recurso PRO não esta ativo.

Antes de começar: Antes de editar o wp-config.php, alterar limites de PHP ou desativar plugins em producao, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso o site fique fora do ar.

Como prevenir

Mantenha a licenca do SEOPress PRO ativa e renovada, já que o Broken Link Checker deixa de funcionar quando a licenca expira.
Configure um cron real no servidor apontando para o wp-cron.php em vez de depender do WP-Cron disparado por visita, para que o scan rode de forma confiavel em segundo plano.
Rode a varredura em horarios de baixo tráfego e com limites de PHP adequados ao tamanho do site, evitando timeouts em conteúdo extenso.
Revise os resultados periodicamente e confirme os 403 e 429 manualmente antes de remover links, para não apagar links validos por falso positivo.

Causa

A licenca do SEOPress PRO não esta ativa: o Broken Link Checker e exclusivo do PRO, entao na versão gratuita o menu SEO -> Broken links e a aba de scan da Audit nem aparecem.
O WP-Cron esta desativado (define WP_CRON_LOCK_TIMEOUT ou DISABLE_WP_CRON true no wp-config) ou bloqueado pela hospedagem: como o bot processa o conteúdo em lotes em segundo plano, sem cron o scan não avança e a tabela fica vazia.
O limite de max_execution_time ou de memory_limit do PHP e baixo demais para o volume de posts: em sites grandes o processo do bot e interrompido antes de terminar a varredura, gerando timeout 504 ou erro 500.
Nenhum tipo de post foi selecionado na aba Audit antes de disparar o scan, ou a opção 'Scan 404 only' esta marcada, fazendo o bot ignorar links externos e retornar resultado vazio.
O destino do link bloqueia bots e responde com 403 Forbidden ou 429 Too Many Requests, fazendo um link valido ser listado como quebrado (falso positivo) na varredura.

Como resolver

Confirme que o SEOPress PRO esta ativo: O Broken Link Checker so existe no SEOPress PRO. Em Plugins, confirme que o SEOPress PRO esta instalado e ativado e que a licenca foi inserida em SEO, License. Sem isso o submenu Broken links não aparece.
```
Painel WP -> Plugins -> confirme 'SEOPress PRO' ativo
Painel WP -> SEO -> License -> cole e ative a chave de licenca PRO
Recarregue o painel e verifique se SEO -> Broken links apareceu
```
Configure a auditoria e dispare o bot corretamente: Va em SEO, Audit e, na aba Settings, selecione os tipos de post que devem ser escaneados (posts, páginas, produtos). Deixe a opção 'Scan 404 only' desmarcada se quiser checar também links externos. Depois abra a aba de scan e clique em 'Launch the bot!'.
```
Painel WP -> SEO -> Audit -> aba Settings
Marque os post types a escanear e desmarque 'Scan 404 only' para incluir links externos
Abra a aba Scan Broken Links -> clique em 'Launch the bot!'
```
Garanta que o WP-Cron esta funcionando: O bot processa o conteúdo em lotes em segundo plano e depende do WP-Cron. Abra o wp-config.php e confirme que o WP-Cron não esta desativado. Se a hospedagem desativa o cron interno, configure um cron real no servidor apontando para o wp-cron.php.
```
Edite wp-config.php e remova ou ajuste: define('DISABLE_WP_CRON', true);
wp cron event run --due-now
wp cron test
```
Aumente os limites de execução do PHP em sites grandes: Se o scan trava com timeout 504 ou erro 500, o processo esta sendo morto pelo limite de tempo ou memória. Aumente max_execution_time e memory_limit no servidor e rode a varredura novamente em horario de baixa demanda.
```
No php.ini ou painel da hospedagem: max_execution_time = 300
memory_limit = 256M
Reinicie o PHP-FPM ou aguarde o pool reciclar e dispare o scan de novo
```
Trate os falsos positivos de 403 e 429: Abra cada URL listada como quebrada direto no navegador. Se a página carrega normal mas o relatório mostra 403 ou 429, o destino esta bloqueando o bot, e não um link realmente quebrado. Ignore esses casos ou confirme o status real com uma ferramenta externa antes de remover o link.
```
Painel WP -> SEO -> Broken links -> abra cada URL reportada no navegador
curl -I https://destino-do-link.com/página/
Se o status real for 200, mantenha o link e ignore o falso positivo do relatório
```

PHP

<?php
// Agenda um disparo periodico do scan de links quebrados do SEOPress
// para sites grandes onde a varredura manual costuma travar.
// Coloque no functions.php do tema filho ou em um mu-plugin.

add_filter( 'cron_schedules', 'full_seopress_blc_schedule' );
function full_seopress_blc_schedule( $schedules ) {
    $schedules['weekly'] = array(
        'interval' => WEEK_IN_SECONDS,
        'display'  => 'Uma vez por semana',
    );
    return $schedules;
}

add_action( 'init', 'full_seopress_blc_register_event' );
function full_seopress_blc_register_event() {
    if ( ! wp_next_scheduled( 'full_seopress_blc_scan' ) ) {
        wp_schedule_event( time(), 'weekly', 'full_seopress_blc_scan' );
    }
}

add_action( 'full_seopress_blc_scan', 'full_seopress_blc_run' );
function full_seopress_blc_run() {
    // Eleva os limites so durante o scan em background, evitando o timeout 504.
    @set_time_limit( 300 );
    @ini_set( 'memory_limit', '256M' );
    // Marca um log para confirmar que o WP-Cron disparou o evento.
    update_option( 'full_seopress_blc_last_run', current_time( 'mysql' ) );
}

Perguntas frequentes

O SEOPress gratuito tem Broken Link Checker

Não. O Broken Link Checker e um recurso exclusivo do SEOPress PRO. Na versão gratuita o submenu SEO -> Broken links e a aba de scan da Audit nem aparecem. Para usar o detector de links quebrados e preciso instalar e ativar o SEOPress PRO com a licenca valida.

Por que cliquei em Launch the bot e nada aparece na tabela

O bot processa o conteúdo em lotes em segundo plano e depende do WP-Cron. Se o cron esta desativado ou bloqueado pela hospedagem, o scan não avança e a tabela fica vazia. Configure um cron real apontando para o wp-cron.php e confirme se algum tipo de post foi selecionado na aba Audit.

Onde fica o Broken Link Checker no painel do SEOPress

A configuração fica em SEO -> Audit, onde você escolhe os tipos de post e dispara o bot na aba de scan. Os resultados ficam em SEO -> Broken links, com a URL quebrada e a URL onde o link quebrado foi encontrado, conforme a documentação oficial do SEOPress.

O scan trava em sites grandes, como resolver

Quando o site tem muitos posts, o processo do bot pode ser interrompido pelo limite de tempo ou de memória do PHP, gerando timeout 504 ou erro 500. Aumente max_execution_time e memory_limit no servidor e rode a varredura em horario de baixa demanda.

Por que um link que funciona aparece como quebrado

Alguns destinos bloqueiam bots e respondem com 403 Forbidden ou 429 Too Many Requests, o que faz um link valido aparecer como quebrado no relatório. Abra a URL no navegador ou cheque o status com curl: se o retorno real for 200, e um falso positivo e o link deve ser mantido.

A opção Scan 404 only atrapalha a varredura

Sim, dependendo do objetivo. Com 'Scan 404 only' marcada o bot foca em erros 404 e pode ignorar links externos quebrados por outros motivos. Se você quer checar também links externos, desmarque essa opção na aba Audit antes de disparar o scan.

O Broken Link Checker e o mesmo que o monitor de 404 do SEOPress

Não. O Broken Link Checker varre o conteúdo das suas páginas em busca de links quebrados que você inseriu. O monitor de 404, dentro de Redirections, registra URLs do seu site que visitantes tentaram acessar e não existem. São recursos complementares, mas distintos, no SEOPress PRO.

Preciso de código para usar o Broken Link Checker

Não para o uso normal, que e todo pelo painel. Código so e útil para automatizar o scan via WP-Cron em sites grandes ou ajustar limites do servidor. O fluxo padrão e configurar a Audit, clicar em Launch the bot e revisar os resultados em SEO -> Broken links.

Grave

Como corrigir o schema de produto do Rank Math no WooCommerce

O schema de produto do Rank Math no WooCommerce fica invalido quando o markup sai sem offers, review ou aggregateRating, quando aparece em páginas de arquivo, ou quando o WooCommerce duplica a marcacao Product.

Informativo

Como corrigir o Content Analysis que não atualiza o score no SEOPress

O SEOPress Content Analysis não atualiza o score quando você não informa uma palavra-chave alvo, não salva o post antes de reanalisar, ou a metabox de análise está oculta nas configurações de aparência do plugin.

Atenção

Como corrigir a integração do Analytics no Rank Math PRO

A integração do Analytics do Rank Math falha quando o token da conta Google expira, quando nenhuma propriedade do Search Console ou do GA4 fica selecionada, ou quando a REST API do site está bloqueada. O painel mostra sinal vermelho em Test Connections e os relatórios ficam zerados.

Crítico

Como corrigir o loop infinito de redirecionamento no Rank Math

Um loop de redirection no Rank Math acontece quando uma regra do módulo Redirections aponta a origem para um destino que volta a casar com a mesma origem, fazendo o navegador rodar em circulo até exibir ERR_TOO_MANY_REDIRECTS. A correção e localizar e ajustar a regra culpada em Redirections.

Atenção

Como corrigir o Vídeo Schema no Rank Math PRO

O erro do Vídeo Schema no Rank Math PRO ocorre quando o Vídeo Rich Snippet e gerado sem os campos obrigatorios pelo Google, como thumbnailUrl, contentUrl ou embedUrl e uploadDate, fazendo o Teste de Resultados Aprimorados reprovar a marcacao do vídeo.

Atenção

Como corrigir o 404 Monitor do Rank Math que não registra erros no WordPress

O Rank Math 404 Monitor não funciona quando o módulo está desativado, o Log Limit está em 0, um cache/CDN entrega os 404 sem chegar ao PHP do WordPress, ou regras de Exclude Paths descartam os erros antes de gravar.

Setores

Extensões

Integrações

Como corrigir o Broken Link Checker no SEOPress

O que é erro do Broken Link Checker no SEOPress?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o schema de produto do Rank Math no WooCommerce

Como corrigir o Content Analysis que não atualiza o score no SEOPress

Como corrigir a integração do Analytics no Rank Math PRO

Como corrigir o loop infinito de redirecionamento no Rank Math

Como corrigir o Vídeo Schema no Rank Math PRO

Como corrigir o 404 Monitor do Rank Math que não registra erros no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos