jev-seo

Product Introduction

1. Definition: jev-seo is a free, open-source, command-line interface (CLI) tool and Model Context Protocol (MCP) server built in Rust, designed for comprehensive technical SEO and Generative Engine Optimization (GEO) analysis. It functions as a local-first, deterministic auditing and crawling engine.
2. Core Value Proposition: It exists to provide enterprise-grade SEO audit capabilities—including live site crawling, 57-rule technical audits, schema validation, and rank tracking—without the recurring $130+/month subscription fees of platforms like Semrush or Ahrefs. Its core value is delivering deterministic SEO work (crawling, meta tag checking, robots.txt validation) for free, while offering optional, cost-capped AI-powered semantic analysis.

Main Features

1. 57-Rule Technical SEO Audit: The tool performs a deterministic audit against a stable set of 57 rules covering on-page elements, technical health, and content signals. It checks for issues like missing meta descriptions, broken links, invalid schema.org markup, and improper hreflang tags. It works by statically analyzing local HTML/Markdown files or by crawling a live website, parsing the DOM, and applying rule-based checks.
2. Live Site Crawler with Robots.txt Compliance: jev-seo includes a built-in web crawler that respects robots.txt directives and meta robot tags. It can map a site's structure, discover pages, and audit them in real-time. This feature uses a custom Rust-based HTTP client to fetch and parse pages, enabling site-wide technical analysis without external SaaS dependencies.
3. MCP Server for AI Coding Agents: The tool ships as a native MCP (Model Context Protocol) server, exposing 13 tools—such as audit_page, crawl_site, and check_rank—directly to AI coding assistants like Claude Code, Cursor, and Gemini. This allows autonomous agents to run SEO checks within their workflow, making SEO a first-class concern in the development process.
4. Local Rank Tracking & CI Gating: It maintains a local SQLite database to track keyword rank positions over time, detecting rank drift. The CLI can be integrated into Continuous Integration (CI) pipelines (e.g., GitHub Actions) to gate deployments or content merges based on configurable audit score thresholds (--min-pass), enforcing SEO quality standards automatically.
5. Optional Jev-Powered Semantic Scoring: For advanced analysis, jev-seo can connect to the TypeSafe AI Jev platform via a free API key to perform intent classification and GEO/AI-citation scoring. This provides semantic insights into how well content might perform for answer engines, but usage is strictly hard-capped by a user-defined --jev-budget flag (default $0.25 per run) to prevent cost overruns.

Problems Solved

1. Pain Point: The high cost barrier for professional SEO tools. Many essential SEO tasks (crawling, technical audits) are deterministic and do not justify a high monthly subscription. jev-seo eliminates this cost for core functionality.
2. Target Audience: The primary users are developers, indie hackers, DevOps engineers, and technical content creators who need integrated, scriptable SEO tooling. Secondary users are SEO professionals seeking a transparent, auditable, and portable tool for core technical checks.
3. Use Cases: Essential scenarios include pre-deployment website audits in CI/CD pipelines, ongoing technical SEO monitoring for static sites, generating actionable audit reports for clients, providing SEO context to AI coding agents during development, and conducting free competitive analysis or site crawls.

Unique Advantages

1. Differentiation: Unlike cloud-based SaaS platforms (Semrush, Ahrefs, Screaming Frog), jev-seo is a free, open-source (MIT), locally-executing binary. It has zero subscription fees, no seat limits, and does not send sensitive data to third-party servers for its core features. It also uniquely bridges the gap between SEO and AI-assisted development via its integrated MCP server.
2. Key Innovation: The integration of a fully-featured SEO engine with the Model Context Protocol is a significant innovation. It transforms SEO from a manual, post-hoc check into a programmable resource that AI agents can leverage in real-time, effectively enabling "SEO-as-code" and autonomous technical content optimization.

Frequently Asked Questions (FAQ)

1. Is jev-seo really free to use? Yes, the core functionality—including the 57-rule audit engine, live website crawler, schema validator, robots.txt checker, sitemap parser, and local rank tracking—is completely free and does not require any paid API keys or subscriptions.
2. How does jev-seo compare to Semrush? jev-seo provides the deterministic, technical audit and crawl capabilities of Semrush for free in a CLI tool. It lacks Semrush's vast keyword database and backlink analysis but adds unique features like local execution, CI gating, and direct MCP integration for AI agents, which Semrush does not offer.
3. What is the Jev semantic scoring feature? This is an optional premium feature that uses TypeSafe AI's Jev platform to analyze page content for its suitability for AI answer engines (GEO). It classifies search intent and scores content for potential citation. It requires a free API key and costs fractions of a cent per analysis, with a strict user-defined budget cap.
4. Can I use jev-seo in my automated workflows? Absolutely. As a Rust CLI, it is designed for automation. You can integrate it into shell scripts, CI/CD pipelines (e.g., GitHub Actions), and scheduled cron jobs. Its ability to output structured JSON, CSV, and HTML reports makes it ideal for automated reporting and alerting.
5. What is an MCP server and why does it matter for SEO? MCP (Model Context Protocol) is a standard for tools to expose capabilities to AI assistants. By being an MCP server, jev-seo allows AI coding agents to directly run SEO audits, crawl sites, and check rankings as they code, seamlessly integrating SEO best practices into the development lifecycle without context switching.