---

Why jev-seo?

Semrush and Ahrefs cost upwards of $130 per month. OpenSEO still requires paid DataForSEO credit cards. Most SEO suites are bloated web dashboards filled with vanity charts.

• Zero subscriptions (₹0): Scrapes DuckDuckGo HTML and suggest endpoints directly. No credit cards, no paid API keys.
• TypeSafe Jev System One: Semantic intent classification, competitive gap detection, and AI visibility (GEO) scored deterministically without conversational LLM hallucinations.
• Batch Directory Auditing: Audits hundreds of markdown/HTML files in <1 second, detecting title collisions, canonical mismatches, and thin pages.
• 2026 Schema.org Validator: Deeply inspects JSON-LD schemas (SoftwareApplication, Article, Organization, Product) and flags deprecated schemas.
• Robots.txt & AI Crawler Radar: Evaluates permissions for AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Bytespider).
• SERP Content Briefs: Synthesizes competitor SERP snippets into an actionable content blueprint with H2 outlines and optimal 134-167 word GEO blocks.
• Agent native (MCP): Native stdio JSON-RPC 2.0 MCP server directly feeds 8 SEO tools into Claude Code, Gemini CLI, and Antigravity.
• Local & private: All rank tracking and audit histories persist in a single local SQLite database (.jev-seo.db).
• Low RAM footprint: Fast native Rust binary that runs in under 30MB RAM on resource-constrained machines.

---

Quickstart

# Install via Cargo (crates.io)
cargo install jev-seo

# Set your free TypeSafe key for semantic oracle scoring
export TYPESAFE_API_KEY=your_key_here

# Run a live SERP competitive radar check
jev-seo query "offline expense tracker android"

# Audit a single file or an entire documentation directory
jev-seo audit docs/

# Audit an XML sitemap for protocol security, URL limits, and hreflang
jev-seo sitemap https://example.com/sitemap.xml

# Validate JSON-LD Schema.org markup
jev-seo schema index.html

# Check AI crawler permissions on a live domain
jev-seo robots github.com

# Generate a SERP-driven content brief
jev-seo brief "agentic skills" --limit 5

# Track domain rankings over time (saved to local SQLite)
jev-seo rank --domain "crates.io" --query "rust grep"

# Start the Native Agent MCP Server
jev-seo mcp

---

Workflows

1. Batch Directory & File On-Page Audit

jev-seo audit content/posts/

Recursively scans all markdown and HTML files, identifies title collisions, detects thin content (<300 words), verifies canonical links, and flags image alt deficiencies.

2. JSON-LD Schema.org Validation

jev-seo schema content/guide.md

Validates required properties across SoftwareApplication, Article, Organization, and Product. Flags deprecated schema types (e.g. HowTo rich results).

3. Robots.txt & AI Crawler Inspection

jev-seo robots example.com

Audits robots.txt directives specifically for modern generative AI indexers:

• GPTBot (OpenAI model training)
• ClaudeBot & anthropic-ai (Anthropic)
• PerplexityBot (Perplexity citation engine)
• Google-Extended (Gemini training)
• Bytespider (ByteDance)

4. SERP-Driven Content Brief Generator

jev-seo brief "fast local sqlite tui" --markdown

Pulls live DuckDuckGo competitors, calculates optimal word count, and uses Jev System One fan-out to generate an actionable heading outline with a 150-word GEO direct-answer prescription.

5. Generative Engine Optimization (GEO)

jev-seo geo README.md --query "agentic skills framework for coding agents"

Calculates citation probability for Perplexity, SearchGPT, and Gemini Overviews using Jev Score (1-10) and Noul.

6. XML Sitemap & International Hreflang Auditor

jev-seo sitemap sitemap.xml
jev-seo sitemap https://example.com/sitemap.xml

Validates sitemaps against Google webmaster standards: enforces canonical HTTPS protocols, flags parameter pollution, verifies the 50,000 URL limit, and audits international hreflang codes (flagging malformed codes like en-UK vs en-GB and enforcing x-default).

7. Google Helpful Content & AI Slop Radar

Integrated into jev-seo audit:

• Em-dash density scanner: Flags excessive em-dash saturation (>2 per 500 words).
• AI Vocabulary Detector: Flags 17 pervasive AI boilerplate crutches (delve, leverage, testament, foster, seamless, crucial, robust, landscape, etc.).
• Heading Hierarchy Auditor: Flags illegal skip-levels (e.g. H1 -> H3 without H2).
• Internal Link Graph: Pinpoints orphan pages with 0 inbound internal links across directories.
• Keyword Cannibalization Radar: Identifies competing articles targeting identical keyword stems.

---

Command Reference

Command	Description	Flags
keywords <query>	Autocomplete discovery and Jev intent classification	--json
query <query>	Live SERP competitor scraping and winning gap analysis	--json
audit <path>	Batch directory or file on-page, orphan, and AI-slop audit	--target-query <query>, --json
geo <target>	Generative Engine Optimization citation scoring (1-10)	--query <query>, --json
schema <target>	Schema.org JSON-LD structural and deprecation validator	--json
robots <domain>	Robots.txt and AI crawler permission auditor	--json
brief <topic>	SERP-driven heading outline and 150-word GEO direct-answer	--limit <n>, --markdown, --json
rank	SQLite rank drift tracker (.jev-seo.db)	--domain <domain>, --query <query>
sitemap <target>	XML sitemap, 50k limit, HTTPS, and hreflang validator	--json
mcp	Native Stdio JSON-RPC 2.0 Agent MCP Server	(None)

---

Native MCP Server (8 Tools)

When launched via jev-seo mcp, the binary acts as a stdio JSON-RPC 2.0 Model Context Protocol server exposing 8 tools:

MCP Tool	Arguments	Purpose
seo_keywords	query: string	Discover keyword autocomplete variants and classify user intent
seo_serp_inspect	query: string, limit?: int	Scrape live top-ranking competitor titles, snippets, and URLs
seo_audit	path: string	Audit local markdown/HTML files, orphan pages, and AI slop
seo_geo	target: string, query: string	Evaluate AI citation likelihood (1-10) and direct answer presence
seo_schema	target: string	Validate JSON-LD schemas and check active search rich result rules
seo_robots	domain: string	Inspect live robots.txt directives for major LLM crawlers
seo_brief	topic: string, limit?: int	Generate structured markdown content briefs with H2 outlines
seo_sitemap	target: string	Validate XML sitemap protocols, HTTPS links, and hreflang tags

---

Architecture

jev-seo
├── src
│   ├── main.rs         CLI entrypoint & command dispatch
│   ├── engine.rs       TypeSafe Jev client & speculative fan-out
│   ├── serp.rs         DuckDuckGo HTML & suggest scraper
│   ├── audit.rs        Batch directory & file on-page meta auditor
│   ├── schema.rs       JSON-LD Schema.org structural & semantic validator
│   ├── robots.rs       Robots.txt & AI crawler permission analyzer
│   ├── brief.rs        SERP-driven content brief generator
│   ├── rank.rs         Local SQLite rank drift tracker (.jev-seo.db)
│   ├── sitemap.rs      XML sitemap & international hreflang auditor
│   ├── mcp.rs          Native stdio JSON-RPC 2.0 MCP server (8 tools)
│   └── tests.rs        Unit & integration test harness (21 tests passing)
├── Cargo.toml
└── README.md

---

Non-Goals

• No bloated electron or cloud web dashboards.
• No paid third-party API dependencies (no forced DataForSEO subscriptions).
• No generative AI prose synthesis (Jev is used strictly as a deterministic evaluation oracle).

---

Ecosystem

• design-genius — Autonomous design system intelligence for web applications
• akash-design-engineering — High-performance editorial brutalist design tokens and cookbook
• tdlib-android — Precompiled TDLib native binaries for all 4 Android ABIs
• kharcha — India-first offline-first UPI expense tracker for Android

---

Author

Akash Priyadarshi
Patna, Bihar, India

• GitHub: @AkashPriyadarshii
• Portfolio: akashpriyadarshi.vercel.app
• LinkedIn: Akash Priyadarshi
• Resume: akashpriyadarshii.github.io/Resume

Social: X / Twitter • Threads • Instagram • Reddit

---

Zero-cost, agent-first SEO radar built with TypeSafe AI System One.