screaming-frog-mcp

MCP-сервер, позволяющий Claude запускать Screaming Frog SEO Spider в headless-режиме (без графического интерфейса), экспортировать данные и управлять хранилищем сканирований.

Введите URL в Claude. Screaming Frog запустится в фоновом режиме. Вы получите данные обратно. Вот и всё.

Форк bzsasson/screaming-frog-mcp v0.1.0 с исправлениями ошибок. Оригинал имел проблемы, делавшие его практически непригодным для использования: взаимные блокировки каналов (pipe deadlocks), из-за которых сканирования зависали, ложное обнаружение графического интерфейса, блокировавшее всё после первого запуска, и команда удаления, которая могла стереть всю базу данных сканирований. Всё исправлено.

Что исправлено

Требования

• Screaming Frog SEO Spider с платной лицензией — для headless-сканирований требуется лицензия.

• Python 3.10+

• uv (рекомендуется) или pip

Установка

Mac

uvx --from git+https://github.com/marykovziridze/screaming-frog-mcp screaming-frog-mcp

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"]
    }
  }
}

Windows

Сначала установите uv:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Добавьте в C:\Users\[имя]\AppData\Roaming\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"],
      "env": {
        "SF_CLI_PATH": "C:\\Program Files (x86)\\Screaming Frog SEO Spider\\ScreamingFrogSEOSpiderCli.exe"
      }
    }
  }
}

После редактирования конфигурации перезапустите Claude Desktop.

Инструменты

Конфигурация

Известные ограничения

• Путь к зависшим сканированиям на Windows — автоочистка работает на Mac. На Windows, если сканирования завершаются ошибкой после прерывания, проверьте наличие файла crawl.seospider в директории установки SF и удалите его вручную.

• Нет процента прогресса сканирования — headless CLI SF не сообщает прогресс во время сканирования. Вы знаете только, когда оно началось и когда закончилось.

• Большие сайты — протестировано на сайтах до ~160 страниц. Стресс-тестирование на сайтах с 10 000+ страниц не проводилось.

Лицензия

MIT — см. LICENSE

Авторы

Оригинальный MCP-сервер от Boaz Sasson.