内容
<!-- mcp-name: io.github.atomno-mcp/mcp-seo-audit -->
# atomno-mcp-seo-audit
[](https://pypi.org/project/atomno-mcp-seo-audit/)
[](https://pypi.org/project/atomno-mcp-seo-audit/)
[](LICENSE)
[](https://modelcontextprotocol.io)
MCP（模型上下文协议）服务器，用于**技术SEO和GEO审计**，由 [detail.web](https://audit.detailweb.ru) 引擎提供支持 — **真实测量，而非LLM猜测**。可从Cursor、Claude Desktop或任何MCP客户端运行。**8种工具：** `audit_site`（确定性`0–100`健康评分 + 等级评定，78项检查，涵盖8个类别，以及 **GEO** 子评分 — 在ChatGPT / Perplexity / Google AI概览中的可见性），`audit_diff`（与上一次快照比较），`robots.txt`和`sitemap.xml`验证器，JSON-LD和meta/OpenGraph构建器，以及每项检查的修复解释器。探测TLS、重定向、TTFB、AI爬虫访问（GPTBot）和`llms.txt`。免费套餐 + **PRO**（深度爬取、GEO、40+项深入检查）。
## 为什么与LLM结合使用？
语言模型本身仅凭训练数据推断网站，在最佳情况下也只能推断出一个渲染的页面 — 它无法直接读取您的TLS证书的到期时间，测量响应时间，解析`sitemap.xml`，或检查`robots.txt`中是否阻止了`GPTBot`。此服务器真正运行这些检查：实际的HTTP请求，安全标头，重定向链，结构化数据验证 — 并返回 **确定性** 分数（相同网站 → 相同数字），足以复制并放入客户端报告中。可以将其视为仪器，而LLM则是解释读数的分析师 — 两者协同工作效果最佳。
## 您将获得
- **`audit_site(url, depth=1, lang="zh")`** — 一次调用返回：
- 健康评分`0–100`（越高越好）和等级评定`A–F`；
- 按类别（安全、SEO和索引、性能、GEO等）分组的问题，每个问题都有`pass / warn / fail`状态；
- 简短的人类可读摘要。
- **`audit_diff(url, lang="zh")`** — 重新审计网站并与上一次运行进行比较：健康/评分差异以及哪些检查变差或变好。第一次调用存储基准线。这是仅凭一次LLM问题无法实现的 — 跟踪网站随时间的变化。**PRO**功能（需要API密钥）具有状态。
- **`list_checks(lang="zh")`** — 按类别分组的引擎检查完整目录，每个检查都有`free` / `PRO`徽章 — 这样您（和代理）可以清楚地看到免费套餐涵盖的内容和PRO解锁的内容。
- **`explain_issue(check_id, lang="zh")`** — 深入了解单个检查：为什么重要以及如何修复。传递`audit_site`或`list_checks`中的`check_id`。标题和类别本地化；详细建议目前以中文提供（`advice_lang`字段报告）。
- **`validate_robots(content, lang="zh")`** — 粘贴`robots.txt`并返回语法问题、`Sitemap:`指令是否存在、是否阻止CSS/JS渲染机器人，以及哪些AI爬虫（GPTBot、ClaudeBot等）被明确阻止。无需获取 — 验证您提供的文本。
- **`check_sitemap(url, lang="zh")`** — 通过URL获取网站地图并报告其格式（`urlset` / `sitemapindex`）、URL数量和常见问题（404、非XML内容类型、`http://`链接、缺少`<lastmod>`、每文件50k限制）。服务器上的获取受到SSRF保护。
- **`build_jsonld(type, fields, lang="zh")`** — 生成可粘贴的schema.org JSON-LD `<script>`（Organization、LocalBusiness、Article、Product、FAQPage、BreadcrumbList、WebSite）并告诉您哪些必填/推荐字段缺失。它从不发明数据 — 仅使用您传递的数据。
- **`build_meta(fields, lang="zh")`** — 生成`<head>`元标签（标题、描述、规范、Open Graph、Twitter Card）并验证标题（50–60字符）和描述（120–160字符）的长度。
### 免费 vs PRO
| | 免费（无密钥） | PRO（带API密钥） |
|---|---|---|
| 检查 | 核心技术基础 | 40+深入检查（E-E-A-T、Schema.org、金矿标题） |
| GEO | 4个GEO信号 | GEO准备度子评分 + 深入GEO检查 |
| 爬取 | 单个页面 | 深入爬取最多20页（`depth=2/3`） |
审计引擎本身保留在服务器上 — 此软件包是一个薄客户端（仅限HTTP调用和格式化）。
## 安装
```bash
uvx atomno-mcp-seo-audit
```
或添加到您的MCP客户端配置（`mcp.json`）：
```json
{
"mcpServers": {
"seo-audit": {
"command": "uvx",
"args": ["atomno-mcp-seo-audit"]
}
}
}
```
## 配置
所有配置均通过环境变量完成：
| 变量 | 默认值 | 用途 |
|---|---|---|
| `DETAILWEB_API_BASE` | `https://api.detailweb.ru` | 后端基准URL |
| `DETAILWEB_API_KEY` | — | PRO密钥（`dwa_...`）。无密钥 → 免费套餐 |
| `DETAILWEB_TIMEOUT` | `60` | HTTP超时（秒） |
| `DETAILWEB_LANG` | `zh` | 默认问题标题语言（`zh` / `en`） |
**免费套餐无需密钥和注册** — 只需运行上述命令即可。 **PRO** 套餐（40+深入检查、GEO子评分、深度爬取、`audit_diff`）目前需要申请：请发送电子邮件至 **kir@detailweb.ru** 或通过 [audit.detailweb.ru](https://audit.detailweb.ru) 联系。我们激活您的帐户后，您在 **仪表盘 → 帐户 → API密钥**（`dwa_...`，仅显示一次）中创建密钥，并将密钥放入`DETAILWEB_API_KEY`中。
## 示例
> "审计 https://example.com"
代理调用`audit_site("https://example.com")`并获得健康评分、等级和需要修复的问题列表。
## 许可证
MIT © atomno-mcp。开源客户端与专有托管后端通信。
---
## 🇷🇺 На русском
MCP服务器的技术SEO审计，使用 [detail.web](https://audit.detailweb.ru) 引擎。直接从AI代理（Cursor，Claude Desktop和任何MCP客户端）运行审计：**健康评分**，8个类别的问题和 **GEO** 子评分（在ChatGPT，Perplexity，AI概览中的可见性）。
**为什么与神经网络结合使用。** 语言模型本身根据训练数据判断网站，在最佳情况下也只能判断一个渲染的页面 — 它无法直接读取SSL证书的到期时间，测量响应时间，解析`sitemap.xml`，或检查`robots.txt`中是否阻止了`GPTBot`。该服务器真正运行这些检查：HTTP请求，头部，重定向，微标记 — 并给出 **确定性** 分数（相同的网站 → 相同的数字），足以复制并放入客户端报告中。可以将其视为仪器，而神经网络是解释读数的分析师 — 两者协同工作效果最佳。
**工具：** `audit_site`（审计 + 评分 + GEO），`audit_diff`（与上一次检查相比 — 有状态PRO），`list_checks`（免费/PRO检查目录），`explain_issue`（为什么重要 + 如何修复），`validate_robots`，`check_sitemap`，`build_jsonld`，`build_meta`.
**安装：**
```bash
uvx atomno-mcp-seo-audit
```
在MCP客户端配置（`mcp.json`）中：
```json
{
"mcpServers": {
"seo-audit": {
"command": "uvx",
"args": ["atomno-mcp-seo-audit"],
"env": { "DETAILWEB_LANG": "zh" }
}
}
}
```
免费套餐（基本检查，一个页面） **无需密钥和注册即可立即使用**。PRO模式（40+深入检查，GEO子评分，深度爬取最多20页，`audit_diff`）目前按需提供：请发送电子邮件至 **kir@detailweb.ru** 或通过 [audit.detailweb.ru](https://audit.detailweb.ru) 联系。激活帐户后，在 **帐户 → API密钥**（显示一次）中创建密钥（`dwa_...`）并将其放入`DETAILWEB_API_KEY`中。工具和设置的完整描述请参见上面的英文版本。
