# 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](https://www.screamingfrog.co.uk/seo-spider/) с лицензией + CLI
- Claude Code, Cursor или другой MCP-совместимый клиент

## Установка

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

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

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

```bash
pip install -r requirements.txt
```

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

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

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

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

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

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

```json
{
  "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](https://github.com/jlowin/fastmcp)
- Screaming Frog SEO Spider CLI
- httpx + BeautifulSoup (для quick_seo_check)

## Лицензия

MIT