AgriciDaniel/jev-seo

Live SEO audit for any website from one homepage URL, judged by Jev. PDF, XLSX and Markdown reports.

什么是 jev‑seo？

jev‑seo 是一个 Python 工具，只需提供首页 URL，即可对任何网站执行实时 SEO 审计。它会爬取网站、根据 52 条 Google 建议规则进行检查、通过 PageSpeed Insights 衡量 Core Web Vitals，然后向 Jev（TypeSafe 的“System One”LLM）提出一系列关于每个页面的类型化问题（例如页面类型、搜索意图、实用性）。答案会经过评分、优先排序，并转换为三份可直接分享的报告：

PDF – 一份客户友好的文档，包含封面、执行摘要、计分卡、图表和可操作的建议。
XLSX – 一份可编辑的動作追踪表，每个修复项目都有 ID、优先级、影响、努力程度和来源。
Markdown – 一份 GitHub/Obsidian 友好的版本，内嵌图表。

该工具可作为 Claude Code 技能（/jev‑seo https://example.com）或从命令行执行。

运作方式（高阶流程）

爬取 – 有礼貌地爬取，尊重 robots.txt，遵循 sitemap，记录重定向、损坏的链接、canonical 标签、结构化数据，并可选择使用 Playwright 渲染仅含 JavaScript 的页面。
规则检查 – 应用 52 条 SEO 规则，涵盖可爬性、索引、页面因素、结构化数据、性能、安全性和 AI 爬虫访问。
Core Web Vitals – 从 Google PageSpeed Insights（免费 API）获取 Lighthouse 分数。
Jev 判断 – 向 TypeSafe Jev 模型（每页约 0.00015 美元）发送类型化提示，以获取 13 个页面级和 5 个网站级问题的概率性答案。
（可选）完整模式 – 使用 DataForSEO（每个网站约 0.30 美元）的关键词排名、流量估算、竞争对手、反向链接和实时 SERP 数据丰富审计内容。
评分与排序 – 将规则结果、Jev 概率和可选的 SEO 数据组合成数值分数和优先排序的修复列表。
报告生成 – 单一 audit.json 驱动 PDF（通过 WeasyPrint）、Excel 工作簿和 Markdown 输出。

主要功能

功能	重要性
实时爬取（非静态模板）	确保审计反映网站当前状态，包括 JavaScript 渲染的内容。
Jev 驱动的判断	添加基于 LLM 的页面意图、实用性、信任度等评估，并存储概率以供透明化。
排序且可解释的修复	每个建议都包含 ID、优先级、影响、努力程度、证据和来源链接，方便移交给开发人员或内容团队。
单一来源的三种输出格式	PDF 给客户，XLSX 用于项目追踪，Markdown 用于版本控制的文档。
成本控制的 API 使用	内置上限（`--jev-budget`、`--dfs-budget`）和报告中的成本账本，让支出可预测。
可选的 DataForSEO 丰富化	添加关键词机会、竞争者分析和反向链接数据，以获得更深入的 SEO 全貌（付费）。
离线测试套件	单元测试在无网络调用的情况下执行，确保核心逻辑正常运作，不花费 API 额度。

谁可能使用它

SEO 顾问 – 需要快速、可重现的审计结果与客户分享。
网页开发人员 / 产品团队 – 寻找具体、优先排序的技术 SEO 修复列表。
内容策略师 – 对关键词和 SERP 洞察感兴趣（通过 --full 模式）。
熟悉 AI 的营销人员 – 想了解 LLM（Jev）如何评估网站质量，并将这些判断纳入工作流程。

快速开始（快速步骤）

# 克隆并设置虚拟环境
git clone https://github.com/AgriciDaniel/jev-seo.git
cd jev-seo
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt

# 添加你的 TypeSafe API 密钥（Jev 可选，完整模式必填）
cp .env.example .env   # 编辑 .env 并设置 TYPESAFE_API_KEY

# 运行基本审计
bin/jevseo run https://example.com

可选：安装 Playwright 以进行 JavaScript 渲染，并安装 DataForSEO 凭证以使用丰富化模式。

限制与注意事项

采样 – 大型网站默认限制为 60 页；报告会注明何时进行采样。
Jev 校准 – LLM 的阈值尚未与人类 SEO 专家进行基准测试。
PageSpeed 变异 – Lighthouse 分数可能因运行而异。
无流量或排名追踪 – 此工具是证据快照，而非排名追踪器或分析平台。

许可证

MIT 许可证。PDF 附带的字体采用 SIL Open Font License。

以上所有信息直接取自存储库的 README；未添加任何外部假设。