jev-seo

概览

GitHub

jev-seo 是一个基于 Python 的开源 SEO 审计工具。用户只需提供一个网站的首页 URL，它便会自动抓取站点内容，依据与 Google Search Central 相关的 52 条规则进行检查，测量 Core Web Vitals，并通过 TypeSafe 的 Jev 模型对每个页面提出结构化问题。 ### 主要能力 - **实时抓取**：检查 robots.txt、sitemap、重定向、死链、canonical 标签、结构化数据以及仅依赖 JavaScript 渲染的页面，耗时约一分钟。 - **Jev 模型评估**：由 Jev 判断页面类型、搜索意图、重要性、帮助性、信任度等维度，并保留概率值。 - **修复建议排序**：每项操作均包含 ID、优先级、影响程度、工作量、证据、修复方案及官方来源，启发式规则会被明确标注。 - **多格式输出**：基于同一份 `audit.json` 数据，生成供客户查看的 PDF、用于跟踪进度的 XLSX 表格，以及适用于 GitHub 和 Obsidian 的 Markdown 报告。 ### 运行方式与成本 jev-seo 可作为命令行工具运行，也可作为 Claude Code skill 使用（命令为 `/jev-seo https://example.com`）。标准模式无需订阅 SEO 数据，每次站点的 Jev API 调用成本约为一美分。可选的 `--full` 模式会接入 DataForSEO API 获取排名、关键词和外链数据，单次站点成本约为 0.30 USD。爬取、规则校验、评分、图表生成及报告渲染均在本地机器完成，不产生费用。 ### 适用人群 适合需要快速了解网站 SEO 状况的开发者、SEO 从业者或站长，尤其是希望将审计结果直接转化为可跟踪任务列表的团队。要求环境为 Python 3.10+。

Q&A

jev-seo 的运行环境要求是什么？由 AI 生成

需要 Python 3.10 及以上版本。生成 PDF 依赖 WeasyPrint，需安装 Pango 文本库（Debian/Ubuntu 用 apt 安装，macOS 用 brew 安装）。若需审计纯 JS 渲染页面，还需安装 Playwright 和 Chromium。

使用 jev-seo 需要付费吗？由 AI 生成

jev-seo 本身是 MIT 协议的开源软件，爬取、规则校验和报告生成在本地免费运行。但调用 TypeSafe Jev API 会产生少量费用（每页约 0.00015 USD），若使用 --full 模式调用 DataForSEO API，每个站点约需 0.30 USD。

如何控制 API 调用的花费？由 AI 生成

工具内置了硬性预算上限参数，如 --jev-budget（默认 0.25 USD）和 --dfs-budget（默认 1.00 USD），在每次发起请求前都会进行检查，且所有调用记录都会体现在报告的成本明细中。

如果没有 TypeSafe API Key 可以运行吗？由 AI 生成

可以运行。缺少该 Key 时，审计仍会继续，但 Jev 评估部分会被标记为未评估，最终得分会被标记为部分审计结果。

生成的报告存放在哪里？由 AI 生成

报告默认保存在 jev-seo-reports/<domain>-<stamp>/ 目录下，包含 audit.json、digest.md 以及 PDF、XLSX、Markdown 格式的报告文件。

jev-seo 的评分能预测网站排名吗？由 AI 生成

不能。文档明确指出，分数仅用于排列修复工作的优先级，从不预测排名或流量。缺失的数据会保持缺失状态，不会编造。