关于 LV24 SEO
LV24 SEO 将搜索数据、网站爬取、报告、CLI 和 Agent 技能整合为 SEO 工作工具,面向网站管理者及需要跨搜索平台分析的 Agent。它统一多来源数据,并侧重追踪变化而非提供仪表盘。
主要功能
- 01整合 GSC、Yandex、Bing、CrUX 和 PSI 数据
- 02爬取网站以检查技术 SEO 问题
- 03保存历史并追踪每周变化
- 04提供 CLI 命令和 Agent 技能
- 05通过邮件或 Telegram 发送报告
适用场景
- 01跨平台查看每周搜索表现
- 02发现索引问题和流量机会
- 03检测爬取、站点地图或 TLS 异常
MCP 相关
MCP 服务提供 10 个工具、3 个资源和 3 个提示词,用于 SEO 分析与报告。工具默认只读,写入操作受限制。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
11收录的工具列表 · 更新于 今天
此工具无需参数。
详细介绍
lv24-seo-optimizer
为人类和 AI Agent 提供的免费优先 SEO 控制平面。
无需仪表板,掌控网站的 SEO。 拉取 Search Console、Yandex Webmaster 和 Metrika、Bing、 CrUX 以及您自己的抓取数据,汇总成一段历史记录——然后通过电子邮件获取每周差异报告,并使用 MCP 服务和 CLI, 让 Agent 真正能够上手使用。无需付费平台,无需抓取 SERP,也无需供应商账户。
| 🚀 开始 | 🧠 使用 | 🛠 运维 |
|---|---|---|
| 安装 · 查看效果 · 文档 | CLI · MCP 工具 · 技能 | 定时调度 · 数据限制 · 安全 |
一个工具即可将 Google Search Console、Yandex Webmaster、Yandex Metrika、Bing Webmaster、 Chrome UX Report 和 PageSpeed Insights 的数据汇总到统一的标准化模型中,抓取您的网站以发现 技术 SEO 回归问题,并将所有数据转化为定时电子邮件报告、MCP 工具、 CLI 命令和 Agent 技能。
无需付费 SEO 平台。默认使用路径中的所有内容都提供免费套餐。
┌──────────── data sources (free) ────────────┐ ┌──── surfaces ────┐
│ GSC · Yandex Webmaster · Metrika · Bing · │ ───▶ │ CLI (--json) │
│ CrUX · PSI · your own crawl + nginx logs │ │ MCP server │
└──────────────────────────────────────────────┘ │ Skills / AGENTS │
│ Email / Telegram │
│ SQLite history │
└──────────────────┘
为什么还要开发另一个 SEO 工具
- 免费优先的数据融合。 现有 MCP 服务各自封装一个供应商,并将原始供应商格式交给模型。我们会按属性合并 GSC + Bing + Yandex + Metrika,并明确说明 API 无法提供的数据(Yandex 不支持查询×页面关联,GSC 每天最多返回 50k 行,数据会延迟 2–3 天)。
每个响应都包含
truncated、total、data_age和limitations[]。 - 关注差异,而非仪表板。 报告会与上次保存的快照进行比较,只有出现重大变化时才会通过电子邮件通知您(流量下降、新增索引错误、站点地图回归、TLS 过期)。
- 原生支持 Agent。 小巧稳定的 MCP 工具接口(默认只读)、每条 CLI 命令都使用 JSON 封装,以及将审计 → 规划 → 修复 → 验证融入真实代码库的技能。
- 零支出。 公开仓库 CI、SQLite 存储、SMTP/Telegram 投递,默认使用路径不依赖 SaaS。 付费供应商(Ahrefs、Semrush、DataForSEO、SerpApi)可通过可选适配器接入,使用您自己的密钥。
状态
Alpha(v0.1.0 开发中)。 当前已可用:六个供应商适配器(GSC、Yandex Webmaster、Yandex Metrika、Bing/IndexNow、CrUX、PSI)、包含 30 条规则的爬虫、SQLite 历史记录、分析功能(差值、机会、 索引问题分类、多引擎融合、nginx 日志统计)、报告构建器及 HTML/文本/Markdown 渲染器、 支持幂等性的 SMTP/Telegram 投递、完整 CLI、MCP 服务(10 个工具、3 个资源、 3 个提示词)和调度器生成器。
在宣布 v0.1.0 稳定版之前仍需完成:GSC 服务账户认证(目前仅支持 OAuth 令牌)、
站点地图/重新抓取的写入操作(已接入 IndexNow;其他操作会明确返回
WRITE_DISABLED),以及针对真实属性的端到端运行。波次状态请参阅
docs/plans/2026-11-10-implementation-plan.md。
安装
# Python (recommended)
uvx --from lv24-seo lv24-seo doctor
pipx install lv24-seo # or: uv tool install lv24-seo
# Node users: thin launcher over the same CLI
npx @lv24/seo doctor --json
lv24-seo init --property https://example.com # writes seo.toml + data/
lv24-seo auth set --provider gsc --stdin # token in the OS keychain
lv24-seo report weekly --json --out reports/
lv24-seo mcp serve # stdio MCP server
lv24-seo install --client claude|opencode|vscode|cursor
npx @lv24/seo需要 uv(或已安装的lv24-seo二进制文件):npm 包只是启动器,并非另一个实现。
查看效果
$ lv24-seo doctor
[OK ] python: 3.13.12
[OK ] platform: Windows 11
[OK ] config: C:\work\seo.toml
[OK ] cwd_writable: C:\work
[FAIL] tokens: not configured yet (gsc / yandex / metrika / bing / crux)
$ lv24-seo report weekly --days 7 --json --out reports/
# headline clicks +18.2%, impressions +6.4%, position -1.1
# traffic gsc 1 240 clicks · yandex 310 · metrika 92 sessions
# indexing 3 new "crawled - not indexed" URLs, 0 regressions
# actions 5 opportunities, expected +41 clicks/week
# honesty data_age_days=2, yandex: top_3000_queries, no_query_page_join
相同的数据也可通过 MCP 工具(seo_weekly_report、gsc_search_analytics、
yandex_query_stats、seo_indexing_triage 等)以及三个融入
审计 → 规划 → 修复 → 验证流程的技能使用。
功能
| 界面 | 示例 |
|---|---|
| 报告 | 每周搜索表现及变化、索引问题排查、排名临界机会、内容衰退、技术回归 |
| MCP 工具 | gsc_search_analytics、yandex_query_stats、yandex_indexing_state、crawl_site、seo_weekly_report、seo_indexing_triage、seo_opportunities、seo_recrawl_request(需授权) |
| 命令行 | init、doctor、auth、gsc、yandex、crawl、audit、report、schedule、mcp serve |
| 技能 | seo-weekly、seo-indexing-triage、seo-technical-audit — 决策树、工具用法和输出约定 |
| 自动化 | cron / systemd 定时器 / Windows 任务计划程序生成器、GitHub Actions 配方、nginx 日志导入 |
支持的数据源
| 数据源 | 免费套餐 | 用途 | 写入操作 |
|---|---|---|---|
| Google Search Console | 是(OAuth 或服务账号) | 查询、网页、国家/地区、设备、URL 检查、站点地图 | 提交站点地图(需授权) |
| Yandex Webmaster | 是(OAuth) | 查询、索引历史、诊断、站点地图、重新抓取 | 重新抓取队列(受配额限制) |
| Yandex Metrika | 是 | 自然搜索会话、着陆页、目标 | — |
| Bing Webmaster + IndexNow | 是 | 查询、抓取问题、即时 URL 通知 | 提交 IndexNow |
| Chrome UX Report | 是(API 密钥) | 来源级真实用户 CWV | — |
| PageSpeed Insights | 是 | 每个 URL 的实验室审计 | — |
| 你的网站 | — | 抓取、robots、站点地图、JSON-LD、hreflang、链接 | — |
| nginx 访问日志 | — | 机器人抓取预算、机器人遇到的 5xx 错误 | — |
文档
- 实施计划 — 阶段、工作包、完成定义(DoD)
- 架构 — 分层、数据模型、提供方约定
- 数据源与限制 — 各 API 能做和不能做的事
- MCP 工具接口 — 工具名称、输入、输出、注释
- 命令行参考 — 命令、JSON 封装、退出码
- 配置 —
seo.toml、环境变量、密钥存储 - 调度与交付 — cron/systemd/任务计划程序、SMTP、Telegram
- Agent 技能 — 技能格式和镜像
- 安全 — 令牌处理、默认只读、写入权限控制
- 2026 年研究 — API 限制、现有 MCP 服务、工具生态
面向 AI Agent
请先阅读 AGENTS.md。这是权威约定,说明了仓库布局、如何运行各项内容、哪些操作为只读,以及如何提出更改。机器可读的辅助资源:
schemas/tools.json— 生成的工具架构(无需 MCP 即可使用)llms.txt— 面向 LLM 爬虫的文档索引skills/*/SKILL.md— 可移植技能(Claude Code、OpenCode、Codex)- MCP Registry:
io.github.LevapVeeskela/lv24-seo
许可证
Apache-2.0。请参阅 LICENSE 和 TRADEMARKS.md。 从 Google/Yandex/Bing 获取的数据归资源所有者所有 — 本项目绝不转售这些数据。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。