内容
# seo-mcp
[](https://github.com/Mehmoodqureshi/seo-mcp/actions/workflows/ci.yml)
**SEO MCP 服务器** — 一个_stdio_[模型上下文协议](https://modelcontextprotocol.io) 服务器，为 AI 主机提供一套 SEO 工具。最低可行产品（MVP）**完全免费且无密钥限制**：页面/技术审计、robots.txt、站点地图、结构化数据、损坏链接检查和关键词建议。
构建在与 [`chrome-mcp`](https://github.com/Mehmoodqureshi/chrome-mcp) 相同的成熟脚手架上：SDK `服务器` → `标准输入输出服务器传输`，一个扁平的工具注册表和一个永不抛异常的分派防火墙。
## 工具（全部免费，无 API 密钥）
| 工具 | 功能 |
|------|--------------|
| `audit_page` | 完整的页面审计：标题、元描述、规范、robots、视口、OG/Twitter、标题大纲、字数、图像替代文本覆盖、链接数量、结构化数据存在 → 问题 + 0–100 分数。传递 `pagespeed: true` 还附带 PageSpeed 指标 |
| `check_robots` | 获取和解析 `/robots.txt` — 用户代理组、允许/禁止、声明的站点地图 |
| `check_sitemap` | 发现和总结站点地图（索引 vs urlset、URL 数量、样本） |
| `extract_schema` | 拉取 JSON-LD 结构化数据并列出 schema.org `@type`s（+ 微数据、解析错误） |
| `find_broken_links` | HEAD 检查页面上的链接；报告 4xx/5xx/无法访问 |
| `keyword_ideas` | 通过 Google 建议（无容量）为种子词获取相关查询 |
| `pagespeed` | Google PageSpeed Insights（Lighthouse）：性能得分、实验室核心网页生命指标 + 真实用户 CrUX 字段数据 + 顶级机会。无密钥（限速）；设置 `PAGESPEED_API_KEY` 以提高配额 |
## 安装和构建
```bash
npm install
npm run build # → dist/src/cli.js
```
## 将其用作 MCP 服务器
将以下内容添加到您的 MCP 主机配置文件中（例如，项目 `.mcp.json`）：
```json
{
"mcpServers": {
"seo-mcp": {
"type": "stdio",
"command": "node",
"args": ["/Users/mehmoodqureshi/Work/seo-mcp/dist/src/cli.js"]
}
}
}
```
然后询问类似 *"审计 https://example.com 的 SEO"* 或 *"example.com 的 robots.txt 阻止了什么？"*。
## 快速烟雾测试（无需 MCP 主机）
```bash
node -e "require('./dist/src/seo/audit').auditPage('https://example.com').then(r=>console.log(JSON.stringify(r,null,2)))"
```
## 开发
```bash
npm run typecheck # tsc --noEmit
npm run build # → dist/
```
CI（`.github/workflows/ci.yml`）在 Node 18/20/22 上运行 typecheck → build。
## PageSpeed（可选密钥）
`pagespeed` 工具无密钥工作，但 Google 对匿名请求有限速。 要提高配额，请获取一个免费的 [PageSpeed Insights API 密钥](https://developers.google.com/speed/docs/insights/v5/get-started) 并在您的 MCP 主机配置文件中设置：
```json
{
"mcpServers": {
"seo-mcp": {
"type": "stdio",
"command": "node",
"args": ["/Users/mehmoodqureshi/Work/seo-mcp/dist/src/cli.js"],
"env": { "PAGESPEED_API_KEY": "your-key-here" }
}
}
}
```
## 路线图（需要密钥 - 不在免费 MVP 中）
- `serp_rank` — 真实的 SERP 位置检查（驱动浏览器或付费 SERP API）
- `domain_authority` — OpenPageRank（免费密钥）用于权威分数
- `backlinks` — 真实的反向链接配置文件（付费：Ahrefs / SEMrush / DataForSEO）
## 许可证
MIT
