MCP Screaming Frog

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

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

Что умеет

Инструмент	Описание
sf_crawl	Полный краул сайта через SF CLI
sf_get_issues	SEO-проблемы по категориям: titles, H1, meta, 404, редиректы, каноникалы, скорость
sf_get_page	SEO-данные по паттерну URL (например /uslugi/)
sf_list_crawls	История всех краулов
quick_seo_check	Быстрая проверка одной страницы без SF (2-3 сек)

Требования

• 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"
      }
    }
  }
}

Переменная	По умолчанию	Описание
SF_PATH	C:\Program Files (x86)\Screaming Frog SEO Spider\ScreamingFrogSEOSpiderCli.exe	Путь к CLI Screaming Frog
SF_RESULTS	./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