jev-seo

jev-seo 是一款开源实时SEO审计工具，依托TypeSafe的Jev System One决策模型，输入网站首页URL即可启动站点爬取与全方位SEO检测，对照Google Search Central的52条规则校验，同时采集Core Web Vitals性能指标，利用Jev对页面做带类型、附带概率的语义评估。审计完成后一次性生成PDF客户报告、Excel任务跟踪表、Markdown文档三套格式，数据源统一来自同一份审计JSON文件。

工具支持两种调用方式：作为Claude Code技能直接用/jev-seo [https://example.com](https://example.com)，或是在终端命令行运行。

• 标准基础模式：无需订阅SEO数据服务，单站点Jev调用成本约1美分
• --full完整模式：接入DataForSEO，补充关键词、排名、外链等数据，单站点约0.3美元

核心能力

环境与使用

依赖 Python3.10+；生成PDF需要WeasyPrint与Pango文本库。

git clone [https://github.com/AgriciDaniel/jev-seo.git](https://github.com/AgriciDaniel/jev-seo.git)
cd jev-seo
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
bin/jevseo doctor
bin/jevseo run [https://example.com](https://example.com)

可选安装Playwright，启用无头Chromium渲染JS动态页面。

• bin/jevseo audit：执行爬取、规则校验、Jev评估、PageSpeed检测，输出audit.json与摘要md
• bin/jevseo render：基于审计数据渲染PDF/XLSX/Markdown报告
• bin/jevseo audit --full：开启DataForSEO关键词、排名、竞品数据
• bin/jevseo rescore：离线重新计算评分，不再消耗API费用

成本拆分

支持设置API预算硬上限，每次调用前校验额度，报告内置成本账本。缺少TypeSafe密钥仍可运行审计，Jev相关评估部分标记为未完成。

可靠性评估

项目附带独立评测记录，核心结果：

1. 爬虫事实类检测可独立复现，词数误差控制在5%以内；DataForSEO数据内部校验精确
2. Jev模型重复测试，同一59页站点两次评估分数波动≤0.03，页面类型判定完全一致
3. 盲测对照独立评判模型，决定性结论匹配度高；不确定结论会在报告中标注「待验证」

检测覆盖范围

• 爬虫索引：robots、抓取延迟、站点地图、重定向、软404、llms.txt、内网防护
• 52条校验规则：爬取索引、页面基础、内容、内链外链、结构化富媒体数据、AI爬虫访问、性能安全
• Jev评估：13项页面问题、5项全站问题，完整模式下额外增加关键词相关性、品牌检测
• --full扩展：关键词排名、预估流量、竞品、引用域、SERP、AI Overview检索结果、LLM引用提及

输出PDF包含摘要、优化路线图、记分卡、热力图；Excel内置下拉式优化任务清单、原始Jev概率判断、性能/排名/竞品数据表；Markdown附带Mermaid图表、目录。

局限说明

• 站点页面数量存在上限（默认采样60页），大网站仅抽样评估，报告会明确标注
• Jev评估阈值尚未经过人工标签校准
• PageSpeed实验室分数存在波动；字段数据仅流量足够页面才会采集
• DataForSEO流量、难度指标属于估算值；启发式规则仅为参考，不等同搜索引擎硬性要求
• 定位是证据审计工具，不能替代Search Console，不做长期排名监控