Установка SpiderHead

Ядро устанавливается из репозитория в виртуальное окружение. Глобально ничего не ставится.

Нужны Python 3.10 или новее, pip и git. См. требования об опциональных компонентах.
  1. Быстрее всего: пусть агент установит

    Установщика пока нет, поэтому самый быстрый путь — отдать работу агенту. Скопируйте промпт, вставьте в агента (Claude Code, Codex, Cursor и похожие) и одобрьте команды, которые он выполнит.

    Промпт
    Install SpiderHead for me.
    1. Clone https://github.com/PavloSEO/spiderhead into ~/spiderhead.
    2. Create a Python 3.10+ virtual environment inside it and run python -m pip install -e ".[all]".
    3. Install Chromium: python -m playwright install chromium.
    4. Check it works: seohead --version.
    5. Register ~/spiderhead/.venv/bin/seohead mcp as an MCP server in this agent's configuration.
    Tell me what you did and anything that failed.
  2. ИИ-агент выполняет промпт установки, затем десктопное приложение при первом запуске.
    folder_zipПредпочитаете файл? Скачайте ZIP репозитория, распакуйте и откройте получившуюся папку. Выполните команды установки для вашей ОС, пропустив git clone и cd.Скачать ZIP
  3. Или установите вручную

  4. 1Клонирование и установка

    Экстра all включает все опциональные группы зависимостей.

    bash · macOS / Linux
    git clone https://github.com/PavloSEO/spiderhead.git
    cd spiderhead
    python -m venv .venv
    source .venv/bin/activate
    python -m pip install -e ".[all]"
    seohead --help
  5. 2Через uv

    uv sync создаёт то же окружение по зафиксированному uv.lock.

    bash
    uv sync --all-extras
    uv run seohead --help
  6. 3Windows PowerShell

    Вызывайте интерпретатор виртуального окружения явно; активация не обязательна.

    PowerShell
    py -3.12 -m venv .venv
    .\.venv\Scripts\python.exe -m pip install ".[mcp,reports]"
    .\.venv\Scripts\python.exe -m seohead --version
  7. Экономная установка. Экстры mcp, render, reports, pdf и gsc ставятся по отдельности. Инструмент без нужного экстра ответит точной командой установки.
  8. 4Браузер для рендеринга

    Нужен только для проверок с рендерингом JavaScript.

    bash
    python -m playwright install chromium
    Chromium занимает около 150 МБ. Пропустите, если разбираете только выгрузки Screaming Frog.
  9. 5Подключите источники данных (опционально)

    Откройте Настройки › Источники данных в десктопном приложении. У каждого провайдера видно состояние: подключён, нужен ключ или выключен.

    Настройки › Источники данных. Платные запросы требуют ваш ключ и явное подтверждение.

Открыть страницу на GitHubОбновлено 12.10.2026