内容
# seo-gaca-mcp
**SEO GACA MCP** — **G**EO · **A**udit · **C**rawl · **A**nalyze
```
___ ___ ___ ___ ___ ___ ___
/ __| | __| / _ \ / __| / \ / __| / \
\__ \ | _| | (_) | _ | (_ | | - | | (__ | - |
|___/ |___| \___/ (_) \___| |_|_| \___| |_|_|
GEO · Audit · Crawl · Analyze
```
最全面的SEO / 性能 / GEO / 用户体验MCP服务器。
**37种工具**集成在一个MCP中 — 技术SEO，Lighthouse性能（CWV + INP + TTFB），GEO（AI搜索优化），内容分析，可访问性，安全性，用户体验审计等。
## 功能
| 领域 | GACA测量内容 |
|------|-------------------|
| **性能** | Lighthouse得分（移动设备 + 台式机），核心网页生命指标：LCP，FCP，CLS，TBT，SI，TTI，**INP**，**TTFB**。当Lighthouse不可用时，备用基本计时 |
| **技术SEO** | 元标签，robots.txt，站点地图，可爬行性，HTTP头部，规范，hreflang |
| **GEO** | AI搜索优化 — 普林斯顿9种方法，AI爬虫robots.txt，AI引用准备，优化检查清单 |
| **内容** | 可读性（Flesch-Kincaid，Gunning Fog，FRE），关键词密度，E-E-A-T信号，主题集群 |
| **模式** | JSON-LD验证与谷歌要求，10种模板，Rich Results资格 |
| **安全性** | SSL/TLS审计，7+安全头部，混合内容检测 |
| **链接** | BFS爬行 + 内部链接图，损坏链接扫描 |
| **可访问性** | WCAG 2.2 级别AA，颜色对比度，轻敲目标，字体大小 |
| **用户体验** | 导航，搜索，语义结构，响应式设计，移动菜单，跳过链接 |
| **竞争对手** | 并排比较（最多3个URL），可选Lighthouse基准测试 |
| **国际** | Hreflang验证，本地SEO，NAP提取 |
| **媒体** | 图片/视频SEO审计，格式检测 |
| **报告** | 结构化JSON + 品牌PDF（EN/PL） |
## 状态
> **Alpha** — 37种工具已完全实现。
> 欢迎贡献！
## 快速开始
```bash
# 通过pip安装
pip install seo-gaca-mcp
# 或通过uv安装
uv pip install seo-gaca-mcp
```
## 与Claude Desktop一起使用
将以下内容添加到您的 `claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"gaca": {
"command": "seo-gaca-mcp"
}
}
}
```
## 与Claude Code一起使用
```json
{
"mcpServers": {
"gaca": {
"command": "uvx",
"args": ["seo-gaca-mcp"]
}
}
}
```
## Docker
```bash
docker build -t seo-gaca-mcp .
# 通过MCP stdio测试：
echo '...' | docker run -i seo-gaca-mcp
```
## 工具参考
### 性能（1）
| 工具 | 描述 |
|------|-------------|
| `seo_check_performance` | Lighthouse得分 + 核心网页生命指标：LCP，FCP，CLS，TBT，SI，TTI，INP，TTFB（移动设备 + 台式机） |
### 技术SEO（4）
| 工具 | 描述 |
|------|-------------|
| `seo_audit_technical` | 完整的13步SEO + 用户体验审计，11类评分（1-10） |
| `seo_check_meta` | 快速元标签分析 |
| `seo_check_crawlability` | robots.txt + 站点地图验证 |
| `seo_check_headers` | HTTP响应头部检查 |
### GEO — AI搜索优化（7）
| 工具 | 描述 |
|------|-------------|
| `seo_audit_geo` | 普林斯顿9种方法GEO审计 |
| `seo_optimize_geo` | GEO优化建议 |
| `seo_check_ai_robots` | AI爬虫robots.txt分析（13种爬虫跟踪） |
| `seo_generate_ai_robots` | 生成AI优化的robots.txt |
| `seo_check_ai_visibility` | AI引用准备检查 |
| `seo_get_geo_checklist` | GEO优化检查清单（P0/P1/P2） |
| `seo_get_seo_checklist` | 传统SEO检查清单（P0/P1/P2） |
### 内容分析（3）
| 工具 | 描述 |
|------|-------------|
| `seo_analyze_content` | 可读性（FK，Fog，FRE）+ 关键词密度 |
| `seo_check_eeat` | E-E-A-T信号检测 |
| `seo_audit_topic_clusters` | 主题集群结构分析 |
### 模式/结构化数据（3）
| 工具 | 描述 |
|------|-------------|
| `seo_validate_schema` | JSON-LD验证与谷歌要求 |
| `seo_generate_schema` | 从10种模板生成JSON-LD |
| `seo_check_rich_results` | Rich Results资格检查 |
### 安全性（2）
| 工具 | 描述 |
|------|-------------|
| `seo_audit_ssl` | 完整的SSL/TLS审计（证书链，TLS版本，密码） |
| `seo_check_security_headers` | 7+安全头部分析 |
### 链接（2）
| 工具 | 描述 |
|------|-------------|
| `seo_audit_links` | BFS爬行 + 内部链接图分析 |
| `seo_check_broken_links` | 快速损坏链接扫描 |
### 可访问性（1）
| 工具 | 描述 |
|------|-------------|
| `seo_audit_accessibility` | WCAG 2.2 级别AA审计 |
### 国际和本地（3）
| 工具 | 描述 |
|------|-------------|
| `seo_check_hreflang` | Hreflang验证 + 互惠链接检查 |
| `seo_audit_local` | 本地SEO + NAP提取 |
| `seo_audit_media` | 图片/视频SEO审计 |
### 竞争对手（1）
| 工具 | 描述 |
|------|-------------|
| `seo_compare_competitors` | 并排比较（最多3个），可选Lighthouse基准测试 |
### 高级（4）
| 工具 | 描述 |
|------|-------------|
| `seo_check_js_rendering` | SPA/JS渲染检测（React，Next.js，Vue，Angular，Nuxt） |
| `seo_analyze_logs` | 服务器访问日志分析 |
| `seo_analyze_gsc` | Google Search Console CSV数据分析 |
| `seo_compare_audits` | 审计差异和历史趋势 |
### 报告（1）
| 工具 | 描述 |
|------|-------------|
| `seo_generate_report` | 结构化JSON报告 + 品牌PDF生成（EN/PL） |
### 实用工具（1）
| 工具 | 描述 |
|------|-------------|
| `seo_get_config` | 服务器状态，功能可用性，版本信息 |
## GEO：AI搜索优化
GEO（生成式引擎优化）帮助您的内容被AI搜索引擎（ChatGPT，Perplexity，SGE，Claude，Copilot）引用。
基于普林斯顿研究（arXiv:2311.09735，KDD 2024）：
| 方法 | 提升 | 描述 |
|--------|--------|-------------|
| 引用来源 | +40% | 权威引用和引文 |
| 统计数据 | +37% | 具体数字，百分比，数据 |
| 引语 | +30% | 专家引语并注明出处 |
| 权威语气 | +25% | 自信，专家语言 |
| 易懂语言 | +20% | 清晰，易懂的解释 |
| 技术术语 | +18% | 行业特定词汇 |
| 独特词汇 | +15% | 词汇多样性 |
| 流畅度 | +15% | 自然流畅的结构 |
| 关键词堆砌 | **-10%** | 积极避免！ |
## 性能指标
GACA测量所有核心网页生命指标，包括最新的指标：
| 指标 | 全名 | 良好 | 需要改进 | 差劲 |
|--------|-----------|------|-------------------|------|
| **LCP** | 最大内容加载时间 | <2.5s | 2.5–4.0s | >4.0s |
| **INP** | 交互到下一帧时间 | <200ms | 200–500ms | >500ms |
| **CLS** | 累积布局偏移 | <0.1 | 0.1–0.25 | >0.25 |
| **FCP** | 首次内容加载时间 | <1.8s | 1.8–3.0s | >3.0s |
| **TTFB** | 首次字节时间 | <800ms | 800–1800ms | >1800ms |
| **TBT** | 总阻塞时间 | <200ms | 200–600ms | >600ms |
| **SI** | 速度指数 | <3.4s | 3.4–5.8s | >5.8s |
| **TTI** | 交互时间 | <3.8s | 3.8–7.3s | >7.3s |
## 配置
```bash
# 可选：Lighthouse超时（默认：120s）
export GACA_LIGHTHOUSE_TIMEOUT=120
```
## 许可证
MIT许可证 — Bartosz Gaca
---
使用Anthropic的[MCP](https://modelcontextprotocol.io/)（模型上下文协议）构建。
