Repolode
Submit
AgriciDaniel

AgriciDaniel/jev-seo

Command-line and Claude Code skill that audits any website's SEO from one homepage URL, outputting PDF, XLSX and Markdown reports.

Open-source alternative to:Screaming Frog SEO SpiderSemrush Site Audit

View on GitHubWebsite
Stars
657
Forks
106
Open issues
2
Last commit
29 days ago

What is it?

jev-seo crawls a website and checks it against 52 rules tied to Google Search Central, measures Core Web Vitals through the PageSpeed Insights API, and sends typed questions about each page to the Jev model for judgments on page type, search intent, helpfulness and title fit. Every finding becomes an action with an ID, priority, impact, effort, evidence and a suggested fix.

Results are rendered as a designed PDF for clients, an Excel workbook with an editable action tracker, and a Markdown report that renders on GitHub and in Obsidian, all built from a single audit.json. It runs as a Claude Code skill (/jev-seo URL) or from the bin/jevseo command line.

The standard mode needs no SEO data subscription. An optional --full mode adds rankings, keywords, competitors and backlinks from DataForSEO. Both paid APIs are guarded by per-run budget caps, and every call is listed in the report's cost ledger.

Key features

  • 01Crawls robots.txt, sitemaps, redirects, broken links, canonicals and structured data on a live site.
  • 02Checks 52 rules and reports issues with evidence and official sources.
  • 03Uses the Jev model to answer typed questions about page intent, helpfulness and title fit.
  • 04Ranks fixes by priority, impact and effort.
  • 05Exports PDF, XLSX and Markdown reports from one audit.json.

Use cases

  • Running a first-pass SEO audit on a client website before a deeper review.
  • Tracking SEO fixes over time in the Excel action sheet.
  • Adding an SEO check to a Claude Code workflow via the skill.
  • Producing a shareable PDF summary of a site's technical and content issues.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/AgriciDaniel/jev-seo.git
  2. 2

    Enter the folder and create a virtual environment

    cd jev-seo && python3 -m venv .venv && . .venv/bin/activate
  3. 3

    Install the Python dependencies

    pip install -r requirements.txt
  4. 4

    Run an audit on a site

    bin/jevseo run https://example.com

Things to know

  • Standard mode uses a paid TypeSafe Jev API key for page judgments, and --full mode needs paid DataForSEO credentials.
  • WeasyPrint needs the Pango system library installed before the PDF output works.
  • Large sites are sampled at 60 pages by default, and Jev thresholds are not yet tuned against human labels.

Topics

#seo#website-audit#web-crawler#core-web-vitals#claude-code#python#report-generation#llm

FAQ

What is jev-seo?
Command-line and Claude Code skill that audits any website's SEO from one homepage URL, outputting PDF, XLSX and Markdown reports. jev-seo crawls a website and checks it against 52 rules tied to Google Search Central, measures Core Web Vitals through the PageSpeed Insights API, and sends typed questions about each page to the Jev model for judgments on page type, search intent, helpfulness and title fit. Every finding becomes an action with an ID, priority, impact, effort, evidence and a suggested fix.
Is jev-seo free to use? What license does it have?
jev-seo is open source under the MIT license. Check the license terms before using it in commercial products.
Is jev-seo still maintained?
Actively maintained. The last commit to jev-seo was on Sep 22, 2026.
What can I use jev-seo for?
Running a first-pass SEO audit on a client website before a deeper review. Tracking SEO fixes over time in the Excel action sheet. Adding an SEO check to a Claude Code workflow via the skill. Producing a shareable PDF summary of a site's technical and content issues.
How do I install jev-seo?
Clone the repository: git clone https://github.com/AgriciDaniel/jev-seo.git Enter the folder and create a virtual environment: cd jev-seo && python3 -m venv .venv && . .venv/bin/activate Install the Python dependencies: pip install -r requirements.txt Run an audit on a site: bin/jevseo run https://example.com
Where can I get jev-seo?
The source code and installation instructions are on GitHub: https://github.com/AgriciDaniel/jev-seo

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects