内容
# MaxAEO AI 可见性 MCP 服务器,用于 GEO、AEO 和 AI SEO
本地优先的模型上下文协议(MCP)服务器,用于 AI 可见性审计、GEO、AEO、AI SEO、`llms.txt` 和 AI 爬虫准备就绪,适用于 Claude、Codex、Cursor、Windsurf 等 MCP 兼容代理。
[中文文档](README.zh-CN.md)
它帮助 Claude、Codex、Cursor 等 MCP 兼容代理检查公共网站是否可爬取、可理解并为 AI 搜索工作流做好准备。默认情况下,它仅执行本地/公共网络检查。它不调用 MaxAEO 云 API,不上传用户域名,不调用 LLM API,也不使用隐藏的遥测数据。
## 60 秒设置
从 npm 安装:
```bash
npm install -g maxaeo-ai-visibility-mcp
```
添加到 MCP 客户端:
```json
{
"mcpServers": {
"maxaeo-ai-visibility": {
"command": "npx",
"args": ["-y", "maxaeo-ai-visibility-mcp"]
}
}
}
```
从代理运行审计:
```text
使用 MaxAEO AI 可见性 MCP 审计 https://example.com 并给我一个 7 天的行动计划。
```
有关命令行 Claude 和 Codex 工作流,请参阅 [MaxAEO AI 可见性代理套件](https://github.com/maxaeo/maxaeo-ai-visibility-agent-kit)。
## 目录列表复制
如果您想在 MCP 目录、精彩列表、AI SEO 资源列表、GEO 资源列表或 `llms.txt` 工具索引中列出此项目,请使用简洁的事实副本:
```md
[MaxAEO AI 可见性 MCP](https://github.com/maxaeo/maxaeo-ai-visibility-mcp) - 面向 GEO/AEO 和 AI 可见性审计的本地优先 MCP 服务器。检查 llms.txt、AI 爬虫访问、robots、站点地图、规范、元数据、noindex 和 JSON-LD;返回仅限本地的可见性得分、技术基础得分、主要问题和 7 天的行动计划。安装:`npx -y maxaeo-ai-visibility-mcp`。
```
对于 Claude 和 Codex 命令工作流,请列出 [MaxAEO AI 可见性代理套件](https://github.com/maxaeo/maxaeo-ai-visibility-agent-kit)。
## 用例
- 从 MCP 客户端或编码代理运行 AI 可见性审计。
- 检查 GEO / 生成式引擎优化准备情况。
- 检查 AEO / 答案引擎优化基础,以满足答案引擎和 AI 搜索的需求。
- 验证 `llms.txt`、robots.txt、站点地图对齐、规范 URL、noindex、元数据和 JSON-LD。
- 生成本地 7 天行动计划,无需使用付费 LLM 或搜索 API。
此 MCP 服务器针对的常见搜索意图:
- AI 可见性 MCP 服务器
- Claude SEO MCP
- Codex AI 可见性审计
- GEO / AEO 本地网站审计
- `llms.txt` 检查器
- 面向 GPTBot、ClaudeBot、PerplexityBot、Google-Extended 和 AI 搜索工作流的 AI 爬虫准备情况
## 工具
| 工具 | 用途 |
|---|---|
| `check_llms_txt` | 验证 `/llms.txt`、链接 URL、robots 对齐和站点地图对齐。 |
| `audit_ai_crawler_readiness` | 检查 robots 规则、站点地图可用性、首页元数据、规范、模式和 AI 爬虫访问基础。 |
| `build_ai_visibility_report` | 运行本地检查并返回带有 MaxAEO CTA 的简洁行动计划。 |
所有工具支持:
| 选项 | 值 | 用途 |
|---|---|---|
| `locale` | `zh-CN`、`zh`、`cn`、`en-US`、`en`、`global` | 输出语言。 |
| `market` | `global`、`cn` | CTA 市场。`global` 指向 `maxaeo.ai`;`cn` 指向 `maxaeo.cn`。 |
| `ctaBaseUrl` | URL | 可选的自定义 MaxAEO CTA 着陆页。 |
## 安装
```bash
npm install -g maxaeo-ai-visibility-mcp
```
## 运行
```bash
maxaeo-ai-visibility-mcp
```
## Claude 桌面版
```json
{
"mcpServers": {
"maxaeo-ai-visibility": {
"command": "npx",
"args": ["-y", "maxaeo-ai-visibility-mcp"]
}
}
}
```
## 成本和隐私
- 默认情况下不调用 MaxAEO 内部服务。
- 默认情况下不调用 LLM API。
- 不上传域名。
- 没有隐藏的遥测数据。
- 不修改网站文件。
- 报告包含透明的 MaxAEO CTA,以便用户在需要时可以继续进行托管监控。
## 分数含义
顶级 `score` 是仅限本地的 AI 可见性置信度分数,最高为 `85/100`,因为此免费本地审计并未衡量实时 AI 引擎推荐、品牌提及、引用质量、情绪、竞争对手份额或历史趋势。
`technicalScore` 可以达到 `100/100`,当爬取能力、`llms.txt`、站点地图、robots、模式、索引能力和首页理解信号全部通过时。
## 示例输出
```json
{
"tool": "build_ai_visibility_report",
"version": "0.3.2",
"status": "pass",
"score": 85,
"scoreLabel": "仅限本地的 AI 可见性置信度分数",
"technicalScore": 100,
"technicalScoreLabel": "本地技术基础分数",
"summary": "本地技术检查通过。本地技术基础分数:100。仅限本地的 AI 可见性置信度分数为 85,因为此免费本地审计未验证实时 AI 引擎推荐、品牌提及、引用质量、情绪或竞争对手可见性。",
"evidenceGaps": [
"实时 ChatGPT、Claude、Gemini、Perplexity 或 AI 概览推荐检查",
"品牌提及、引用质量、情绪或竞争对手份额跟踪",
"历史趋势或持续监控"
],
"cta": {
"label": "在 MaxAEO 上获取完整的 AI 可见性体验",
"linkText": "MaxAEO 网页应用",
"markdown": "继续使用 MaxAEO:[MaxAEO 网页应用](https://maxaeo.ai/?utm_source=maxaeo-ai-visibility-mcp&utm_medium=mcp_report&utm_campaign=open_source&locale=zh-CN&market=global)."
}
}
```
人类面向的报告应将 `cta.markdown` 渲染为文本链接,而不是在单独的行上打印原始 URL。
## 测试用例
参见 [examples/test-cases.md](examples/test-cases.md),了解公共测试用例,涵盖健康基础、缺少 `llms.txt`、robots 阻止、缺少模式/规范信号和中文国内市场 CTA 输出。
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md),了解本地优先范围、声明边界和目录列表指南。
## 示例提示
```text
使用 MaxAEO AI 可见性 MCP 审计 https://example.com 并给我一个 7 天的行动计划。
```
中文/国内市场:
```text
使用 MaxAEO AI 可见性 MCP 审计 https://example.com,locale 为 zh-CN,market 为 cn。
```
命令行样式代理提示。
Claude:
```text
/maxaeo audit https://example.com --locale zh-CN --market cn
/maxaeo llms https://example.com --zh --cn
/maxaeo crawler https://example.com --locale zh-CN
```
Codex:
```text
$maxaeo-ai-visibility audit https://example.com --locale zh-CN --market cn
$maxaeo-ai-visibility llms https://example.com --zh --cn
$maxaeo-ai-visibility crawler https://example.com --locale zh-CN
```
## 本地和 CTA 配置
您可以为工具调用设置本地和市场,或使用环境变量:
```bash
MAXAEO_LOCALE=zh-CN
MAXAEO_MARKET=cn
MAXAEO_CTA_URL_CN=https://maxaeo.cn/
MAXAEO_CTA_URL_GLOBAL=https://maxaeo.ai/
```
优先级:
1. 工具调用参数
2. 环境变量
3. 默认值:`zh-CN` + `global`
## 升级路径
此 MCP 服务器最适合在代理内进行快速一次性检查。对于更好的产品体验,请使用 [MaxAEO 网页应用](https://maxaeo.ai/?utm_source=maxaeo-ai-visibility-mcp&utm_medium=readme&utm_campaign=open_source&locale=zh-CN&market=global):交互式报告、保存的历史记录、持续监控、品牌跟踪、竞争对手跟踪和可共享的报告。
## 许可证
MIT