Tutorial de Python com 17 lições que cria do zero um harness de agente semelhante ao Claude Code, começando com um único loop e bash.
AgriciDaniel/jev-seo
Ferramenta de linha de comando e skill do Claude Code que audita o SEO de qualquer site a partir da URL da página inicial e gera relatórios em PDF, XLSX e Markdown.
Alternativa open source a:Screaming Frog SEO Spider
Semrush Site Audit
- Estrelas
- 657
- Forks
- 106
- Issues abertas
- 2
- Último commit
- há 29 dias
O que é?
jev-seo rastreia um site e o verifica com base em 52 regras alinhadas ao Google Search Central, mede Core Web Vitals pela PageSpeed Insights API e envia perguntas tipadas sobre cada página ao modelo Jev para avaliar o tipo de página, a intenção de busca, a utilidade e a adequação do título. Cada descoberta vira uma ação com ID, prioridade, impacto, esforço, evidências e uma correção sugerida.
Os resultados são gerados como um PDF com design para clientes, uma pasta de trabalho do Excel com um quadro de ações editável e um relatório Markdown que pode ser visualizado no GitHub e no Obsidian. Todos são produzidos a partir de um único audit.json. A ferramenta pode ser executada como uma skill do Claude Code (/jev-seo URL) ou pela linha de comando bin/jevseo.
O modo padrão não exige assinatura de dados de SEO. O modo opcional --full adiciona rankings, palavras-chave, concorrentes e backlinks do DataForSEO. As duas APIs pagas têm limites de orçamento por execução, e todas as chamadas são listadas no relatório de custos.
Recursos principais
- 01Rastreia robots.txt, sitemaps, redirecionamentos, links quebrados, canonicals e dados estruturados em um site ativo.
- 02Verifica 52 regras e relata problemas com evidências e fontes oficiais.
- 03Usa o modelo Jev para responder a perguntas tipadas sobre a intenção da página, sua utilidade e a adequação do título.
- 04Prioriza as correções de acordo com a prioridade, o impacto e o esforço.
- 05Gera relatórios em PDF, XLSX e Markdown a partir de um único audit.json.
Casos de uso
- Fazer uma primeira auditoria de SEO no site de um cliente antes de uma análise mais aprofundada.
- Acompanhar as correções de SEO ao longo do tempo na planilha de ações do Excel.
- Adicionar uma verificação de SEO a um fluxo de trabalho do Claude Code usando a skill.
- Gerar um resumo compartilhável em PDF dos problemas técnicos e de conteúdo de um site.
Início rápido
- 1
Clone o repositório
git clone https://github.com/AgriciDaniel/jev-seo.git - 2
Entre na pasta e crie um ambiente virtual
cd jev-seo && python3 -m venv .venv && . .venv/bin/activate - 3
Instale as dependências do Python
pip install -r requirements.txt - 4
Faça uma auditoria em um site
bin/jevseo run https://example.com
Antes de usar
- O modo padrão usa uma chave de API paga do TypeSafe Jev para avaliar as páginas, e o modo --full precisa de credenciais pagas do DataForSEO.
- O WeasyPrint precisa que a biblioteca de sistema Pango esteja instalada para gerar PDFs.
- Sites grandes são amostrados em 60 páginas por padrão, e os limites do Jev ainda não foram ajustados com base em rótulos humanos.
Tópicos
Perguntas frequentes
- O que é jev-seo?
- Ferramenta de linha de comando e skill do Claude Code que audita o SEO de qualquer site a partir da URL da página inicial e gera relatórios em PDF, XLSX e Markdown. jev-seo rastreia um site e o verifica com base em 52 regras alinhadas ao Google Search Central, mede Core Web Vitals pela PageSpeed Insights API e envia perguntas tipadas sobre cada página ao modelo Jev para avaliar o tipo de página, a intenção de busca, a utilidade e a adequação do título. Cada descoberta vira uma ação com ID, prioridade, impacto, esforço, evidências e uma correção sugerida.
- jev-seo é gratuito? Qual é a licença?
- jev-seo é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- jev-seo ainda é mantido?
- Manutenção ativa. O último commit de jev-seo foi em 22 de set. de 2026.
- Para que posso usar jev-seo?
- Fazer uma primeira auditoria de SEO no site de um cliente antes de uma análise mais aprofundada. Acompanhar as correções de SEO ao longo do tempo na planilha de ações do Excel. Adicionar uma verificação de SEO a um fluxo de trabalho do Claude Code usando a skill. Gerar um resumo compartilhável em PDF dos problemas técnicos e de conteúdo de um site.
- Como instalar jev-seo?
- Clone o repositório: git clone https://github.com/AgriciDaniel/jev-seo.git Entre na pasta e crie um ambiente virtual: cd jev-seo && python3 -m venv .venv && . .venv/bin/activate Instale as dependências do Python: pip install -r requirements.txt Faça uma auditoria em um site: bin/jevseo run https://example.com
- Onde consigo jev-seo?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AgriciDaniel/jev-seo
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Agente autônomo de pesquisa open source que planeja perguntas, coleta fontes da web e locais e escreve relatórios com citações usando qualquer provedor de LLM.
Plugin open source de análise de SEO para Claude Code, com auditorias paralelas de SEO técnico, E-E-A-T, Schema.org e otimização para buscas com IA.
Uma skill do Claude Code que audita a visibilidade de sites em mecanismos de busca com IA, como ChatGPT, Perplexity e Google AI Overviews, além de fazer verificações clássicas de SEO.
Um ambiente de ensino para agentes de programação que planeja um curso para você, cria aulas e adapta exercícios com base no seu progresso registrado.
Aplicativo web auto-hospedado que audita até 500 páginas de um site em 74 métricas de SEO on-page, usando Firecrawl e DataForSEO.