mcp-seo-audit

atomno-mcp-seo-audit

用于技术 SEO 和 GEO 审计的 MCP（Model Context Protocol）服务，由 detail.web 引擎驱动——提供真实测量结果，而非大模型猜测。可从 Cursor、Claude Desktop 或任何 MCP 客户端运行。共 8 个工具： audit_site（确定性的 0–100 健康评分和字母等级，涵盖 8 个类别的 78 项检查，另有一个 GEO 子评分——衡量在 ChatGPT / Perplexity / Google AI Overviews 中的可见度）、audit_diff（与前一个快照进行比较）、robots.txt 和 sitemap.xml 验证器、JSON-LD 和 meta/OpenGraph 构建器，以及逐项检查的修复说明。探测 TLS、重定向、TTFB、AI 爬虫访问权限（GPTBot）和 llms.txt。提供免费套餐和 PRO+（深度爬取、GEO、40 多项更深入的检查）——在 PRO+ 及更高级别的套餐中，API 密钥可解锁更深入的引擎（参见免费版与 PRO+）。

为什么要与大模型搭配使用？

大模型本身只能根据训练数据推断网站情况，充其量也只能查看一个渲染后的页面——它无法直接读取 TLS 证书的到期时间、测量响应时间、解析 sitemap.xml，也无法检查 GPTBot 是否被 robots.txt 屏蔽。此服务会实际运行这些检查：发送真实的 HTTP 请求、检查安全标头和重定向链、验证结构化数据，并返回确定性评分（同一网站 → 同一分数），结果可复现到足以纳入客户报告。可以把它看作测量仪器，而大模型是解读读数的分析师——两者搭配使用效果最佳。

你将获得什么

• audit_site(url, depth=1, lang="ru") — 一次调用即可返回：
  • 0–100 的健康评分（越高越好）和 A–F 的字母等级；
  • 按类别分组的问题（安全、SEO 与索引、性能、GEO 等），每项都有 pass / warn / fail 状态；
  • 简短易懂的摘要。
• audit_diff(url, lang="ru") — 重新审计网站，并与上一次运行结果比较：健康度／评分变化，以及哪些检查变差或变好。首次调用会存储基线。这是一次性 LLM 提问无法做到的——持续跟踪网站变化。有状态功能——需要 PRO+ 或更高版本套餐的密钥。
• list_checks(lang="ru") — 按类别分组的完整引擎检查目录，每项都标有 free / PRO 徽章，让你和 Agent 清楚了解免费层级涵盖哪些内容，以及 PRO 解锁了哪些功能。
• explain_issue(check_id, lang="ru") — 深入解读单项检查：说明其重要性以及修复方法。传入 audit_site 或 list_checks 返回的 check_id。标题和类别已本地化；详细建议目前为俄语（advice_lang 字段会注明这一点）。
• validate_robots(content, lang="ru") — 粘贴 robots.txt 后即可查看语法问题、是否包含 Sitemap: 指令、CSS/JS 是否被禁止渲染机器人访问，以及哪些 AI 爬虫（GPTBot、ClaudeBot 等）被明确禁止访问。不获取外部内容——只验证你提供的文本。
• check_sitemap(url, lang="ru") — 根据 URL 获取站点地图，并报告其格式（urlset / sitemapindex）、URL 数量及常见问题（404、非 XML 内容类型、http:// 链接、缺少 <lastmod>、每个文件 50k 的上限）。服务器会防范 SSRF。
• build_jsonld(type, fields, lang="ru") — 生成可直接粘贴的 schema.org JSON-LD <script>（Organization、LocalBusiness、Article、Product、FAQPage、BreadcrumbList、WebSite），并指出缺少哪些必填／推荐字段。它不会编造数据——只使用你传入的内容。
• build_meta(fields, lang="ru") — 生成 <head> 元标签（标题、描述、规范链接、Open Graph、Twitter Card），并校验标题（50–60 个字符）和描述（120–160 个字符）的长度。

Free 与 PRO+ 对比

	Free（无需密钥）	PRO+ 及以上（需要 API 密钥）
检查项	核心技术基础检查	40+ 项深入检查（E-E-A-T、Schema.org、Goldmine title）
GEO	4 项 GEO 信号	GEO 就绪度子评分 + 深入 GEO 检查
爬取	单页	最多爬取 20 个页面（depth=2/3）

哪个套餐可以解锁 API/MCP？ 程序化访问（此服务、audit_diff、深度爬取、GEO 子评分）适用于 PRO+（pro_plus）、Business 和 Enterprise。入门级 PRO 套餐和 Free 层级仅支持网页控制面板——在这些套餐下签发的 API 密钥可以通过身份验证，但仍只会返回 free 结果。如需程序化访问，请选择 PRO+ 或更高版本。

审计引擎本身运行在服务器上——此软件包只是一个轻量客户端 （仅负责 HTTP 调用和格式化）。

安装

uvx atomno-mcp-seo-audit

或者添加到 MCP 客户端配置（mcp.json）：

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"]
    }
  }
}

配置

所有配置均通过环境变量设置：

变量	默认值	用途
DETAILWEB_API_BASE	https://api.detailweb.ru	后端基础 URL
DETAILWEB_API_KEY	—	来自 PRO+ 或更高套餐的 API 密钥（dwa_...）。没有密钥（或使用 Free/PRO 套餐）→ 免费版
DETAILWEB_TIMEOUT	60	HTTP 超时时间（秒）
DETAILWEB_LANG	ru	默认问题标题语言（ru / en）

免费版无需密钥，也无需注册——只需运行上面的命令。 程序化访问（40 多项深度检查、GEO 子评分、深度爬取、audit_diff） 需要 PRO+ 或更高套餐的密钥——入门级 PRO 套餐仅限 Web 控制面板使用，其密钥返回的是免费版结果。目前需申请开通：发送邮件至 [email protected]，或通过 audit.detailweb.ru 联系。账户激活后，你可以在 Dashboard → Account → API keys 中自行创建密钥（dwa_…，仅显示一次）， 并将密钥填入 DETAILWEB_API_KEY。

示例

“审计 https://example.com”

Agent 会调用 audit_site("https://example.com")，并获取健康 评分、等级以及待修复问题列表。

许可证

MIT © atomno-mcp。开源客户端连接的是专有托管后端。

---

🇷🇺 俄语版

基于 detail.web 引擎的技术 SEO 审计 MCP 服务。可直接从 AI Agent （Cursor、Claude Desktop 及任何 MCP 客户端）启动审计：health-score、8 个类别的问题，以及 GEO 子评分（在 AI 搜索中的可见度——ChatGPT、Perplexity、 AI Overviews）。

为什么要与神经网络配合使用。 语言模型本身会根据训练数据判断网站，最多也只能查看一个渲染后的页面——它无法直接读取 SSL 证书的有效期、测量响应时间、解析 sitemap.xml，也无法检查 GPTBot 是否被 robots.txt 屏蔽。此服务会实际执行这些检查：发送 HTTP 请求、检查标头和重定向、分析微数据标记，并提供确定性评分（同一网站 → 同一个分数），可用于向客户提交报告。它是测量仪器，而神经网络则是读取测量结果的分析师。两者搭配效果最佳。

工具： audit_site（审计 + 评分 + GEO）、audit_diff（与上次检查相比的变化——有状态，适用于 PRO+ 及更高套餐）、list_checks（免费版/PRO 检查目录）、explain_issue（为何重要 + 如何修复）、 validate_robots、check_sitemap、build_jsonld、build_meta。

安装：

uvx atomno-mcp-seo-audit

在 MCP 客户端配置文件（mcp.json）中：

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"],
      "env": { "DETAILWEB_LANG": "ru" }
    }
  }
}

免费版（基础检查、单页）开箱即用，无需密钥或注册。程序化访问（40 多项深度检查、GEO 子评分、最多 20 页的深度爬取、audit_diff）需要 PRO+（pro_plus）或更高套餐的密钥——包括 Business、Enterprise。入门级 PRO 套餐（1290 ₽）和 Free 套餐仅限 Web 控制面板使用：密钥可以通过身份验证，但结果仍为免费版。目前需申请开通：发送邮件至 [email protected]，或通过 audit.detailweb.ru 联系。账户激活后，在控制面板 → 账户 → API 密钥中创建密钥（dwa_…，仅显示一次），并将其填入 env 中的 DETAILWEB_API_KEY。工具和设置的完整说明请见上方英文版。