MCP Seo

MCP-SEO

面向AI代理的开源SEO分析工具包。

MCP-SEO为任何LLM代理或人类提供了一套完整的SEO审计工具，可以作为 命令行界面 作为a 模型上下文协议（MCP）服务器。将其指向URL，即可获得关于元标签、标题、链接、图像、性能、移动友好性、结构化数据等的结构化、Markdown格式的报告。

特性

• 21个CLI命令 涵盖页面SEO、技术SEO、性能、可访问性和内容分析
• 18个MCP工具 将相同的功能暴露给任何兼容MCP的客户端（Claude Desktop、Cursor、OpenCode等）
• 无头浏览器渲染 通过Playwright/Chromium处理JavaScript繁重的页面
• 灯塔风格评分 （0-100）按类别细分
• 多页面网站爬虫 具有重复检测和robots.txt功能
• 结构化输出 --每个分析器都返回Pydantic模型（JSON）和Markdown报告
• 可配置的 --所有超时和阈值都可以通过以下方式覆盖 MCP_SEO_* 环境变量
• pip可安装 — pip install mcp-seo 你已经准备好了

安装

pip install mcp-seo

# Or with pipx for isolated CLI usage
pipx install mcp-seo

# Or directly from GitHub
pip install git+https://github.com/g-battaglia/mcp-seo.git

安装后，设置无头浏览器（一次性）：

mcp-seo setup

快速开始

# Lighthouse-style audit with scoring
mcp-seo lighthouse https://example.com

# Full comprehensive report (all analyzers combined)
mcp-seo report https://example.com

# Individual analyzers
mcp-seo meta https://example.com           # Title, description, OG, Twitter, canonical
mcp-seo headings https://example.com       # Heading hierarchy (h1-h6)
mcp-seo links https://example.com          # Internal/external, nofollow, anchors
mcp-seo images https://example.com         # Alt text, lazy loading, dimensions, format
mcp-seo content https://example.com        # Word count, readability, keywords, n-grams
mcp-seo headers https://example.com        # Caching, security, compression, redirects
mcp-seo sitemap https://example.com        # XML sitemap discovery and validation
mcp-seo robots https://example.com         # robots.txt rules and directives
mcp-seo structured-data https://example.com # JSON-LD, Microdata, RDFa
mcp-seo performance https://example.com    # Core Web Vitals (TTFB, FCP, LCP)
mcp-seo mobile https://example.com         # Viewport, tap targets, font sizes
mcp-seo url-structure https://example.com   # URL length, depth, tracking params
mcp-seo accessibility https://example.com   # ARIA, landmarks, skip-nav, score

# Site crawler
mcp-seo crawl-site https://example.com     # Crawl site, find duplicates

# Page fetching
mcp-seo crawl https://example.com          # Rendered HTML (JS executed)
mcp-seo fetch https://example.com          # Raw HTTP response (JSON)

# Utilities
mcp-seo screenshot https://example.com
mcp-seo og-image -t "Title" -s "Subtitle" -o output.png

MCP服务器

MCP-SEO包括一个内置 模型上下文协议 该服务器将所有SEO工具暴露给任何兼容MCP的AI客户端。

mcp-seo mcp

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-seo": {
      "command": "mcp-seo",
      "args": ["mcp"]
    }
  }
}

开源代码

添加到您的 opencode.json:

{
  "mcpServers": {
    "mcp-seo": {
      "command": "mcp-seo",
      "args": ["mcp"]
    }
  }
}

如果从源代码安装 uv 而不是 pip，使用 "command": "uv" 随着 "args": ["run", "--directory", "/path/to/mcp-seo", "mcp-seo", "mcp"].

可用的MCP工具

LLM代理

MCP-SEO被设计为由AI代理自主使用。所有工具都会生成易于解析、引用和推理的结构化Markdown输出。

看 代理商.md 对于推荐的工作流程：快速审核、全面审核、竞争分析和技术审核。

克劳德代码技能

MCP-SEO可作为 Claude代码技能:

npx @anthropic-ai/claude-code skills add g-battaglia/mcp-seo

这安装了mcp-seo技能，使Claude Code可以直接访问所有18个具有推荐审计工作流程的seo分析工具。该技能会自动触发与SEO相关的提示，并指导代理为每次分析使用正确的工具。

发展

git clone https://github.com/g-battaglia/mcp-seo.git
cd mcp-seo
uv sync --group dev
uv run mcp-seo setup
uv run mcp-seo --help

技术栈

许可证

GNU Affero通用公共许可证v3.0