Back to notes

AgriciDaniel/jev-seo

AI summary · Qwen Summary in Chinese Indexed
Original source

jev-seo 是一个从首页 URL 生成实时 SEO 审计和 PDF、XLSX、Markdown 报告的开源工具，结合爬取、规则检查、Core Web Vitals 与 Jev 判断。

项目定位

  • jev-seo 是一个从单个首页 URL 对任意网站进行实时 SEO 审计的开源项目。
  • 它会爬取网站、按 52 条与 Google Search Central 相关的规则检查，并测量 Core Web Vitals。
  • 它使用 TypeSafe 的 Jev 模型对每个页面提出类型化问题，并由代码对修复项评分和排序。

报告输出

  • 输出包括 PDF、XLSX 和 Markdown 三种格式，均基于同一份 audit.json 数据生成。
  • PDF 面向客户，XLSX 用作可编辑的行动跟踪表，Markdown 可用于 GitHub 和 Obsidian。
  • 示例报告包含评分卡、优先级、关键词机会、Jev 判断卡、质量热图和投资建议等内容。

运行方式

  • 可作为 Claude Code skill 运行，也可通过命令行运行，例如 bin/jevseo run https://example.com。
  • 标准模式无需 SEO 数据订阅，Jev 成本约为每个站点 1 美分。
  • 可选 --full 模式会加入 DataForSEO 的排名、关键词和反向链接数据，成本约为 0.30 美元。

成本与依赖

  • 爬取、规则、评分、图表和报告渲染在本地运行，免费。
  • Jev API 按输入 token 计费，约每页 0.00015 美元；DataForSEO 按调用计费，约每站点 0.30 美元。
  • 需要 Python 3.10+，PDF 生成依赖 WeasyPrint 和 Pango；可选 Playwright 用于渲染 JavaScript 页面。

可信度与限制

  • 文档记录了 2026-09-22 的评估：规则与爬取事实、DataForSEO 内部一致性、PageSpeed 独立运行和 Jev 可重复性均得到验证。
  • Jev 与盲测第二模型在部分判断上高度一致，但盲测模型不是人类，因此只说明一致性和合理性，不证明绝对正确。
  • 大型站点默认按 60 页上限采样；Jev 阈值尚未针对人工标签调优；DataForSEO 数据为估计值。

许可

  • 项目采用 MIT 许可证。
  • 捆绑字体 Inter 和 JetBrains Mono 采用 SIL Open Font License。
  • Jev、DataForSEO 和 PageSpeed Insights 是第三方服务，适用各自条款。