Auditoria SEO Completa Direto no Terminal com o Plugin Claude SEO

Uma auditoria SEO típica geralmente se transforma em uma tarefa tediosa. Você abre o Ahrefs ou Screaming Frog, exporta gigabytes de tabelas CSV, e então passa muito tempo tentando descobrir quais dos quinhentos erros encontrados realmente afetam o tráfego e quais são apenas ruído. Depois disso, você tem que transferir manualmente as tarefas para o backlog dos desenvolvedores.

Recentemente encontrei um projeto open-source claude-seo. É uma extensão para a ferramenta CLI do Claude Code que cuida de todo o trabalho rotineiro de análise SEO e entrega um roadmap pronto para uso diretamente no console.

O que torna esta ferramenta interessante

O projeto resolve o problema principal da maioria dos serviços de SEO: ele não apenas gera uma parede de métricas, mas constrói verificações em torno da falseabilidade. Cada recomendação no relatório tem quatro campos obrigatórios:

• Observação da fonte (em que a conclusão se baseia)
• Conexão com outras tarefas no grafo de dependências
• Critérios claros de verificação ("como saber se a hipótese não funcionou")
• Indicador principal para acompanhamento dos resultados

Dentro do plugin, funcionam 25 submódulos e 18 agentes especializados. Quando você executa uma auditoria do site, o sistema inicializa até 15 processos em paralelo. Eles analisam simultaneamente o lado técnico, a validade dos microdados Schema.org, a qualidade do conteúdo de acordo com as diretrizes E-E-A-T e o preparo da página para respostas de IA na busca (GEO).

Foco no novo tipo de resultado de busca

O desenvolvedor do projeto se orientou pelas diretrizes atuais do Google sobre otimização de IA. A ferramenta avalia a citabilidade de blocos de texto (o snippet ideal tem entre 134 e 167 palavras com uma resposta completa à pergunta), a densidade de atribuição de fatos e a presença da marca em plataformas externas como Reddit, YouTube e LinkedIn.

Ao mesmo tempo, o autor desmistifica abertamente mitos populares. Com base em fontes primárias, o plugin leva em consideração que o arquivo robots.txt atualmente não afeta as citações do Google, a divisão artificial de conteúdo em chunks não é necessária e reescrever textos para palavras-chave de IA é inútil — os mecanismos de busca lidam bem com sinônimos.

O que o plugin pode fazer na prática

A ferramenta adiciona 32 comandos à interface do Claude Code. Aqui estão as principais áreas de trabalho:

Auditoria rápida e análise técnica

O comando /seo audit https://example.com executa uma verificação paralela de todo o site. Se você precisa de uma análise de uma única página, o comando /seo page fornece uma fatia exata de títulos, meta tags e estrutura. As métricas técnicas são verificadas via /seo technical — ele rastreia os Core Web Vitals (LCP, INP, CLS) sem parâmetros desatualizados como FID.

Validação de Schema.org

Usando /seo schema, você pode encontrar blocos JSON-LD existentes, verificar sua correção e gerar imediatamente a marcação ausente. O plugin conhece a depreciação de rich-results para FAQ e HowTo, então não vai sugerir perder tempo com tipos de schema desatualizados.

SEO local e marketplaces

Os comandos /seo local e /seo maps analisam sinais do Google Business Profile, consistência de endereço e telefone (NAP) em diretórios e sentimento das avaliações. Para proteger sites de penalidades por doorway pages, o plugin tem limites internos no número de páginas geográficas.

Como instalar e executar

A ferramenta requer o Claude Code CLI e Python 3.10 ou mais recente instalados. O plugin é instalado com um único comando dentro do Claude Code:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

O comando /seo setup cria um ambiente Python isolado na pasta do plugin e baixa o Chromium para o Playwright. Pacotes globais não são instalados no sistema.

Se você prefere um script bash convencional:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Após a instalação, você pode chamar os comandos imediatamente:

# Запустить аудит сайта
/seo audit https://mysite.com

# Проверить разметку Schema
/seo schema https://mysite.com/product/123

# Оценить готовность контента к AI-выдаче
/seo geo https://mysite.com/blog/article

Trabalhando com API e extensões

A funcionalidade básica do plugin funciona localmente e gratuitamente. Não precisa de chaves de API para analisar páginas e construir relatórios. Mas se você conectar as chaves do Google, possibilidades adicionais se abrem:

1. No nível básico (chave de API), dados reais do PageSpeed Insights e tendências do CrUX de 25 semanas são puxados.
2. Ao conectar OAuth ou uma service account, a integração com o Google Search Console e Indexing API é adicionada.
3. Conectar o GA4 fornece análises de tráfego orgânico e páginas de destino.
4. Para desenvolvedores, a conexão com a API do Google Ads está disponível para estimar o volume de demanda de busca.

Além disso, servidores MCP externos são suportados: Ahrefs, DataForSEO, Firecrawl, Unlighthouse e SE Ranking.

Onde a ferramenta será útil

• Equipes internas de desenvolvimento e SEO. É conveniente executar /seo audit um dia antes de um sprint ou antes de um release para pegar canonicals quebrados, problemas de hidratação no Next.js ou marcação quebrada.
• Freelancers. Durante uma chamada com cliente, você pode montar um relatório Markdown completo com pontuações de 0 a 100 e uma lista clara de correções em 10 minutos.
• Agências. Em vez de compilar manualmente relatórios trimestrais, você pode configurar uma execução semanal de script e acompanhar regressões usando o módulo /seo drift.

Limitações e pontos fracos

A ferramenta não é perfeita. Em páginas com renderização client-side pesada (CSR) ou hidratação complexa que depende da rolagem do usuário, o renderizador headless às vezes perde conteúdo, criando falsos positivos. Nesses casos, o autor recomenda executar o sub-agente seo-visual e comparar seu snapshot com o HTML renderizado bruto.

O segundo ponto — sem APIs externas pagas (Ahrefs ou DataForSEO), você não terá uma análise completa de backlinks de concorrentes. O plugin é excelente em auditorias On-Page e técnicas, mas dados Off-Page são limitados a fontes gratuitas como Bing ou Common Crawl.

claude-seo é um bom exemplo de como agentes LLM podem simplificar análises rotineiras. O projeto é distribuído sob a licença MIT, o código é totalmente aberto e o plugin não envia seus dados para servidores de terceiros. Se você usa o Claude Code no seu trabalho diário e lida com desenvolvimento web de qualquer forma, instalar e testar esta ferramenta definitivamente vale a pena.