What are the system requirements for jev-seo?

Python 3.10 or later is required. PDF generation relies on WeasyPrint, which needs the Pango text library (install via apt on Debian/Ubuntu or brew on macOS). To audit purely JS-rendered pages, you also need Playwright and Chromium.

Does jev-seo cost money to use?

jev-seo itself is open-source software under the MIT license, and crawling, rule validation, and report generation run locally for free. However, calling the TypeSafe Jev API incurs a small fee (about 0.00015 USD per page), and using --full mode to call the DataForSEO API costs roughly 0.30 USD per site.

How can I control API spending?

The tool includes built-in hard budget cap parameters such as --jev-budget (default 0.25 USD) and --dfs-budget (default 1.00 USD). These are checked before every request, and all call records appear in the report's cost breakdown.

Can I run it without a TypeSafe API Key?

Yes. Without the key, the audit still runs, but the Jev evaluation section is marked as unevaluated, and the final score is flagged as a partial audit result.

Where are the generated reports saved?

Reports are saved by default in the jev-seo-reports/ - / directory, including audit.json, digest.md, and the PDF, XLSX, and Markdown report files.

Can jev-seo scores predict website rankings?

No. The documentation explicitly states that scores are only used to prioritize remediation work and never predict rankings or traffic. Missing data stays missing—it is never fabricated.

October 18, 2026

jev-seo

Name: jev-seo
Author: ad

Marketing & Growth SEO and AI Search Optimization4

Use tool

Enter a homepage URL to run a real-time SEO audit and generate PDF, XLSX, and Markdown reports.

MIT

Backlink Analysis Rank Tracking Site Audit

1 / 6

Product facts

Type: Web App / SaaS
Category: Marketing & Growth › SEO and AI Search Optimization
Pricing: Open source
License: MIT
Launched: Oct 18, 2026
Listed: Oct 18, 2026
Website: github.com

Overview

GitHub

jev-seo is an open-source, Python-based SEO auditing tool. Provide a homepage URL and it automatically crawls the site, checks it against 52 rules aligned with Google Search Central, measures Core Web Vitals, and asks structured questions about each page via TypeSafe's Jev model. ### Key Capabilities - **Real-time crawling**: Inspects robots.txt, sitemaps, redirects, broken links, canonical tags, structured data, and JavaScript-only rendered pages in about one minute. - **Jev model evaluation**: Jev assesses page type, search intent, importance, helpfulness, trustworthiness, and more, while retaining probability scores. - **Prioritized fix recommendations**: Every action includes an ID, priority, impact, effort, evidence, remediation steps, and official sources. Heuristic rules are clearly labeled. - **Multi-format output**: From a single `audit.json` dataset, it generates client-facing PDFs, XLSX spreadsheets for progress tracking, and Markdown reports for GitHub and Obsidian. ### How It Runs & Costs jev-seo works as a CLI tool or as a Claude Code skill (run `/jev-seo https://example.com`). Standard mode requires no SEO data subscription; Jev API calls cost roughly one cent per site. The optional `--full` mode connects to the DataForSEO API for rankings, keywords, and backlink data at about 0.30 USD per site. Crawling, rule validation, scoring, chart generation, and report rendering all happen locally on your machine at no extra cost. ### Who It's For Ideal for developers, SEO professionals, or site owners who need a fast overview of a site's SEO health—especially teams that want to turn audit findings directly into trackable task lists. Requires Python 3.10+.

Key features

Single-URL Audit Launch: Provide just a homepage URL to automatically crawl the entire site and run SEO checks.
52-Rule Checks: Evaluates your site against 52 rules aligned with Google Search Central.
Core Web Vitals Measurement: Fetches Core Web Vitals data for free via the Google PageSpeed Insights API.
Jev Model Semantic Analysis: Uses TypeSafe's Jev model to evaluate page intent, trustworthiness, helpfulness, and more.
Prioritized Fix Recommendations: Provides priority, impact, effort, evidence, and official sources for every issue.
PDF Reports: Generates designed PDF files containing methodology, scorecards, and priorities.
XLSX Action Tracker: Outputs an Excel Actions worksheet for editing and tracking remediation progress.
Markdown Reports: Produces Markdown reports that render cleanly in GitHub and Obsidian.
JavaScript Rendering Support: Optionally install Playwright to audit pages whose content only appears after JS execution.
DataForSEO Integration: Use the --full flag to fetch rankings, keywords, competitor, and backlink data.
Claude Code Skill: Runs as a Claude Code skill, executing audits in the background and relaying progress.
Hard API Budget Caps: Paid APIs enforce hard budget limits, checked before every request and logged in the report.

Releases

Notify me

Initial · jev-seo

October 18, 2026

Q&A

What are the system requirements for jev-seo?AI-generated: Python 3.10 or later is required. PDF generation relies on WeasyPrint, which needs the Pango text library (install via apt on Debian/Ubuntu or brew on macOS). To audit purely JS-rendered pages, you also need Playwright and Chromium.
Does jev-seo cost money to use?AI-generated: jev-seo itself is open-source software under the MIT license, and crawling, rule validation, and report generation run locally for free. However, calling the TypeSafe Jev API incurs a small fee (about 0.00015 USD per page), and using --full mode to call the DataForSEO API costs roughly 0.30 USD per site.
How can I control API spending?AI-generated: The tool includes built-in hard budget cap parameters such as --jev-budget (default 0.25 USD) and --dfs-budget (default 1.00 USD). These are checked before every request, and all call records appear in the report's cost breakdown.
Can I run it without a TypeSafe API Key?AI-generated: Yes. Without the key, the audit still runs, but the Jev evaluation section is marked as unevaluated, and the final score is flagged as a partial audit result.
Where are the generated reports saved?AI-generated: Reports are saved by default in the jev-seo-reports/<domain>-<stamp>/ directory, including audit.json, digest.md, and the PDF, XLSX, and Markdown report files.
Can jev-seo scores predict website rankings?AI-generated: No. The documentation explicitly states that scores are only used to prioritize remediation work and never predict rankings or traffic. Missing data stays missing—it is never fabricated.