@rog0x/mcp-seo-tools

mcp-seo-tools

一个 MCP（Model Context Protocol）服务，为 AI Agent 提供一套 SEO 分析工具。无需外部 API 密钥，即可分析任意公开网页的元标签、标题结构、失效链接、关键词密度、页面速度和站点地图健康状况。

工具

工具	描述
seo_meta_analyze	审核元标签、Open Graph 和 Twitter Card 标签，并进行评分
seo_heading_check	验证 H1-H6 层级，检测跳级和重复项
seo_link_check	查找失效链接、重定向和缺失的锚文本
seo_keyword_density	测量关键词频率并检查目标关键词的位置
seo_page_speed	测量 TTFB、加载时间、HTML 大小和资源数量
seo_sitemap_parse	解析 sitemap.xml，检查新鲜度、重复项和合规性

要求

• Node.js 18+
• 无需 API 密钥 — 所有工具均使用直接 HTTP 请求和 HTML 解析

安装

git clone <repo-url>
cd mcp-seo-tools
npm install
npm run build

在 Claude Code 中使用

将以下内容添加到 Claude Code MCP 配置中：

claude mcp add seo-tools node D:/products/mcp-servers/mcp-seo-tools/dist/index.js

在 Claude Desktop 中使用

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "seo-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-seo-tools/dist/index.js"]
    }
  }
}

工具详情

seo_meta_analyze

获取 URL 并检查所有与元数据相关的元素。检查标题长度（最佳：30-60 个字符）、元描述长度（最佳：120-160 个字符）、规范 URL、视口标签、语言属性、Open Graph 完整性和 Twitter Card 设置。返回 0-100 分。

Input: { "url": "https://example.com" }

seo_heading_check

解析页面上的所有标题并构建可视化层级树。标记：缺少 H1、存在多个 H1、标题级别跳级、空标题、过长标题（>70 个字符）和重复标题。

Input: { "url": "https://example.com" }

seo_link_check

从页面提取所有锚标签，解析相对 URL，去重，并使用 HEAD 请求检查每个链接（必要时回退到 GET）。将链接分类为正常、失效、重定向、超时或错误。报告内部链接与外部链接的比例。

Input: { "url": "https://example.com", "max_links": 100 }

seo_keyword_density

剔除脚本、样式和导航后，对剩余正文进行分词。计算单词、二元词组和三元词组的频率与密度（过滤停用词）。提供目标关键词时，检查其是否出现在标题、H1、元描述和首段中。

Input: { "url": "https://example.com", "target_keyword": "seo tools" }

seo_page_speed

从服务端角度测量首字节时间和总下载时间。统计外部脚本、样式表、图片和 iframe 的数量。检测渲染阻塞脚本（缺少 async/defer）、缺少 alt 文本或尺寸的图片、缺少压缩以及未使用延迟加载的情况。

Input: { "url": "https://example.com" }

seo_sitemap_parse

接受站点地图 URL 或任意页面 URL（自动追加 /sitemap.xml）。如果未找到，则检查 robots.txt 中的 Sitemap 指令。支持 <sitemapindex> 和 <urlset> 两种格式。验证 URL 数量限制、lastmod 新鲜度、重复条目、协议一致性和尾随斜杠模式。

Input: { "url": "https://example.com" }

许可证

MIT