MCP Screaming Frog

MCP-сервер для управления Screaming Frog SEO Spider через AI-ассистентов (Claude Code, Cursor, VS Code Copilot).

Вместо кликов по GUI — текстовые команды. Один файл, 5 инструментов.

Что умеет

Требования

• Python 3.10+
• Screaming Frog SEO Spider с лицензией + CLI
• Claude Code, Cursor или другой MCP-совместимый клиент

Установка

1. Клонируй репозиторий

git clone https://github.com/boris0024/mcp-screaming-frog.git
cd mcp-screaming-frog

2. Установи зависимости

pip install -r requirements.txt

3. Подключи к Claude Code

Добавь в файл .mcp.json в корне проекта, где используешь Claude Code:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "python",
      "args": ["<полный_путь>/mcp-screaming-frog/server.py"]
    }
  }
}

Или для Cursor — в .cursor/mcp.json аналогично.

4. (опционально) Настрой пути

Если Screaming Frog установлен не по стандартному пути, задай переменные окружения:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "python",
      "args": ["<полный_путь>/mcp-screaming-frog/server.py"],
      "env": {
        "SF_PATH": "D:\\Program Files\\Screaming Frog SEO Spider\\ScreamingFrogSEOSpiderCli.exe",
        "SF_RESULTS": "D:\\seo\\crawl-results"
      }
    }
  }
}

Примеры использования

После подключения просто пиши в Claude Code / Cursor:

• Просканируй https://example.com и покажи проблемы
• Покажи все страницы с дублями Title из последнего краула
• Найди все 404 на сайте
• Покажи SEO-данные для страниц /uslugi/
• Быстро проверь SEO на https://example.com/page

Стек

• Python + FastMCP
• Screaming Frog SEO Spider CLI
• httpx + BeautifulSoup (для quick_seo_check)

Лицензия

MIT