diff --git a/README.md b/README.md index f3de82bb..e71d2ab1 100644 --- a/README.md +++ b/README.md @@ -288,6 +288,7 @@ The [independent model research](community/projects/tools/README.md#independent- - [Jev Second Brain](https://github.com/fellowship-dev/jev-second-brain) - Local-first Markdown vault CLI: FTS index, source-linked related-note suggestions, optional TypeSafe Jev judgments via Vercel AI Gateway. [Project guide](community/projects/tools/jev-second-brain.md). - [AnchorLint](https://github.com/prantikmedhi/anchorlint) - Audits internal links in built HTML sites with deterministic checks plus optional TypeSafe Jev promise/relevance judgments. [Project guide](community/projects/tools/anchorlint.md). - [jev-seo](https://github.com/AkashPriyadarshii/jev-seo) - Agent-oriented SEO/GEO CLI and MCP with local DuckDuckGo helpers and optional TypeSafe Jev scoring. [Project guide](community/projects/tools/jev-seo.md). +- [jev-seo (AgriciDaniel)](https://github.com/AgriciDaniel/jev-seo) - Live website SEO audit from one URL with TypeSafe Jev judgments and PDF/XLSX/Markdown reports (distinct from AkashPriyadarshii/jev-seo). [Project guide](community/projects/tools/agrici-jev-seo.md). - [Jev Browser (tontoko)](https://github.com/tontoko/jev-browser) - Integrates Jev field selection and source-backed extraction with a Playwright SDK, CLI, MCP server, and explicit assertions. [Project guide](community/projects/tools/jev-browser-tontoko.md). - [Jev Browser (Ying-Kai-Liao)](https://github.com/Ying-Kai-Liao/jev-browser) - Turns caller-defined browser goals into Jev-selected Playwright actions with a library, CLI, and MCP server. [Project guide](community/projects/tools/jev-browser-ying-kai-liao.md). - [Jev Browser Skill](https://github.com/zurfyx/jev-browser-skill) - Claude Code/Codex skill where TypeSafe Jev chooses browser operations and targets from a code-built element table (reference implementation; explainer site included). [Project guide](community/projects/tools/jev-browser-skill.md). diff --git a/community/projects/tools/README.md b/community/projects/tools/README.md index d22789ea..abc0c0b0 100644 --- a/community/projects/tools/README.md +++ b/community/projects/tools/README.md @@ -52,6 +52,7 @@ See the [computer-use guide](../../../docs/computer-use.md) for a comparison, fo | [AnchorLint](anchorlint.md) | Audit internal links in built HTML: deterministic checks plus optional TypeSafe Jev promise/relevance judgments. | Python · CLI (`anchorlint`) | | [Clay JEV People Ranker](clay-jev-people-ranker.md) | Qualify Clay people-search candidates with TypeSafe Jev Choice/Noul before enrichment (Agent Skill + Python script). | Python · Agent Skill + CLI script (`rank_clay_people.py`) | | [jev-seo](jev-seo.md) | Local SEO/GEO CLI and MCP: DuckDuckGo SERP/audits plus optional TypeSafe Jev intent and visibility judgments. | Rust · CLI (`jev-seo`) and MCP | +| [jev-seo (AgriciDaniel)](agrici-jev-seo.md) | Live site SEO audit from one URL: crawl/rules/PageSpeed plus TypeSafe Jev judgments; PDF/XLSX/Markdown (distinct from Rust jev-seo). | Python · CLI (`jevseo` 0.1.1, MIT) + Claude skill | ## Developer tools diff --git a/community/projects/tools/agrici-jev-seo.md b/community/projects/tools/agrici-jev-seo.md new file mode 100644 index 00000000..f3d0a084 --- /dev/null +++ b/community/projects/tools/agrici-jev-seo.md @@ -0,0 +1,51 @@ +# jev-seo (AgriciDaniel) + +[All projects](../README.md) · [Customer feedback and marketing](README.md#customer-feedback-and-marketing) + +Live website SEO audit from one homepage URL: crawl + 52 Search Central–tied rules + PageSpeed, with TypeSafe Jev page/site judgments, then ranked fixes as PDF/XLSX/Markdown. Distinct from the Rust [jev-seo](jev-seo.md) (AkashPriyadarshii) CLI/MCP. + +| At a glance | Details | +| --- | --- | +| Source | [Source](https://github.com/AgriciDaniel/jev-seo) | +| Maintainer | [AgriciDaniel](https://github.com/AgriciDaniel) (Agrici Daniel). Independently curated; this entry is not an upstream submission or endorsement. | +| Format | Python CLI **`jevseo` 0.1.1** + Claude Code skill (`SKILL.md`). | +| Requirements | Python ≥ 3.10; WeasyPrint/Pango for PDF; optional Playwright Chromium and DataForSEO for `--full`. Live Jev needs `TYPESAFE_API_KEY`. | +| License | [MIT](https://github.com/AgriciDaniel/jev-seo/blob/55a184a3b0d09565a4c84268f725a47784e62528/LICENSE). | +| Disclosure | AI-assisted catalog review; no affiliation. Listing is not an endorsement. Source inspected (README, LICENSE, pyproject, skill). Live crawl/Jev/DataForSEO runs were **not** executed on the review host. Upstream cost and evaluation tables are author-reported. | + +## When to use + +Use it when you want a one-URL live audit with typed Jev meaning judgments and client-ready PDF/XLSX. Prefer [jev-seo](jev-seo.md) (Akash) for a Rust SERP/GEO MCP without the PDF pipeline; prefer [SiteClarity](../apps/siteclarity.md) for hosted answer-readiness page audits. + +## How it works + +`bin/jevseo` crawls, applies deterministic rules, optionally calls PageSpeed and TypeSafe Jev (page type, intent, helpfulness, …), scores/ranks actions in code, and renders three report formats from one `audit.json`. `--full` adds paid DataForSEO visibility data. Budget caps and a cost ledger bound spend. + +## Get started + +```sh +git clone https://github.com/AgriciDaniel/jev-seo.git +cd jev-seo +git checkout 55a184a3b0d09565a4c84268f725a47784e62528 +python3 -m venv .venv && . .venv/bin/activate +pip install -r requirements.txt +cp .env.example .env # TYPESAFE_API_KEY optional; without it Jev sections are skipped +bin/jevseo doctor +python -m unittest discover -s tests -v # offline, no keys +# Live (charges): bin/jevseo run https://example.com +``` + +## Examples and demos + +- [`examples/claude-seo.md/`](https://github.com/AgriciDaniel/jev-seo/tree/55a184a3b0d09565a4c84268f725a47784e62528/examples/claude-seo.md) sample PDF/XLSX/Markdown (author run). +- `references/judgments.md`, `references/evaluation.md`, `references/method.md`. + +## Limits and data handling + +Live audits send page text/metadata to TypeSafe and may call Google PageSpeed / DataForSEO. Scores rank work; they do not predict rankings or traffic. This listing did not crawl live sites or spend on APIs. + +## Review and maintenance + +Reviewed on **2026-09-23** at [commit 55a184a](https://github.com/AgriciDaniel/jev-seo/tree/55a184a3b0d09565a4c84268f725a47784e62528) (**0.1.1**, MIT). AI-assisted source review of README, LICENSE, pyproject. No live TypeSafe/DataForSEO spend. + +Related: [jev-seo](jev-seo.md), [SiteClarity](../apps/siteclarity.md), [deslop](deslop.md).