Repolode
AgriciDaniel

AgriciDaniel/jev-seo

从一个首页 URL 对任意网站做 SEO 审计的命令行工具与 Claude Code 技能,输出 PDF、XLSX 和 Markdown 报告。

可替代:Screaming Frog SEO SpiderSemrush Site Audit

Star
657
Fork
106
未关闭 Issue
2
最近提交
29天前

这是什么?

jev-seo 会抓取整个网站,依据 Google Search Central 相关的 52 条规则进行检查,通过 PageSpeed Insights API 测量 Core Web Vitals,并把每个页面的问题交给 Jev 模型判断页面类型、搜索意图、有用性和标题匹配度。每项发现都会变成带编号、优先级、影响、工作量、证据和修复建议的行动项。

审计结果可生成面向客户的 PDF、带可编辑行动跟踪表的 Excel 工作簿,以及可在 GitHub 和 Obsidian 中直接渲染的 Markdown 报告,三者都基于同一份 audit.json。项目既可作为 Claude Code 技能使用(/jev-seo 加网址),也可通过命令行运行。

标准模式不需要 SEO 数据订阅。可选的 --full 模式会通过 DataForSEO 补充排名、关键词、竞争对手和外链数据。两项付费 API 都设有每次运行的预算上限,所有调用都记录在报告的成本清单中。

核心功能

  • 01抓取在线网站的 robots.txt、站点地图、重定向、死链、规范链接和结构化数据。
  • 02依据 52 条规则检查,并附上证据与官方来源。
  • 03借助 Jev 模型对页面意图、有用性和标题匹配度作出判断。
  • 04按优先级、影响和工作量对修复建议排序。
  • 05基于同一份 audit.json 导出 PDF、XLSX 和 Markdown 报告。

适用场景

  • 在深入分析前,对客户网站做一次初步 SEO 审计。
  • 用 Excel 行动表跟踪 SEO 修复进度。
  • 通过技能在 Claude Code 工作流中加入 SEO 检查。
  • 生成可分享的 PDF 摘要,列出网站的技术与内容问题。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/AgriciDaniel/jev-seo.git
  2. 2

    进入目录并创建虚拟环境

    cd jev-seo && python3 -m venv .venv && . .venv/bin/activate
  3. 3

    安装 Python 依赖

    pip install -r requirements.txt
  4. 4

    对网站运行审计

    bin/jevseo run https://example.com

使用前须知

  • 标准模式需要付费的 TypeSafe Jev API 密钥进行页面判断,--full 模式需要付费的 DataForSEO 凭据。
  • PDF 输出需要先安装系统库 Pango,WeasyPrint 才能工作。
  • 大型网站默认只抽样检查 60 个页面,且 Jev 的阈值尚未根据人工标注进行调整。

标签

常见问题

jev-seo 是什么?
从一个首页 URL 对任意网站做 SEO 审计的命令行工具与 Claude Code 技能,输出 PDF、XLSX 和 Markdown 报告。 jev-seo 会抓取整个网站,依据 Google Search Central 相关的 52 条规则进行检查,通过 PageSpeed Insights API 测量 Core Web Vitals,并把每个页面的问题交给 Jev 模型判断页面类型、搜索意图、有用性和标题匹配度。每项发现都会变成带编号、优先级、影响、工作量、证据和修复建议的行动项。
jev-seo 可以免费使用吗?用的什么许可证?
jev-seo 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
jev-seo 还在维护吗?
活跃维护中。jev-seo 最近一次提交是在 2026年9月22日。
jev-seo 适合用来做什么?
在深入分析前,对客户网站做一次初步 SEO 审计。 用 Excel 行动表跟踪 SEO 修复进度。 通过技能在 Claude Code 工作流中加入 SEO 检查。 生成可分享的 PDF 摘要,列出网站的技术与内容问题。
jev-seo 怎么安装和运行?
克隆仓库: git clone https://github.com/AgriciDaniel/jev-seo.git 进入目录并创建虚拟环境: cd jev-seo && python3 -m venv .venv && . .venv/bin/activate 安装 Python 依赖: pip install -r requirements.txt 对网站运行审计: bin/jevseo run https://example.com
在哪里获取 jev-seo?
源代码和安装说明在 GitHub 上:https://github.com/AgriciDaniel/jev-seo

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目