Installa SpiderHead

Il nucleo si installa dal repository in un ambiente virtuale. Nulla viene installato globalmente.

Richiede Python 3.10 o successivo, pip e git. Vedi i requisiti per i componenti opzionali.
  1. Più veloce: lascia fare al tuo agente IA

    Non c'è ancora un installer, quindi la via più rapida è affidare il lavoro a un agente. Copia il prompt, incollalo nel tuo agente (Claude Code, Codex, Cursor o simili) e approva i comandi che esegue.

    Prompt
    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. Un agente IA esegue il prompt di installazione; poi l'app desktop al primo avvio.
    folder_zipPreferisci un file? Scarica lo ZIP del repository, decomprimilo e apri la cartella estratta. Segui i comandi di installazione del tuo sistema operativo, saltando git clone e cd.Scarica lo ZIP
  3. Oppure installa a mano

  4. 1Clona e installa

    L'extra all include tutti i gruppi di dipendenze opzionali.

    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. 2Con uv

    uv sync crea lo stesso ambiente a partire dall'uv.lock presente nel repository.

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

    Usa esplicitamente l'interprete dell'ambiente virtuale; attivarlo è opzionale.

    PowerShell
    py -3.12 -m venv .venv
    .\.venv\Scripts\python.exe -m pip install ".[mcp,reports]"
    .\.venv\Scripts\python.exe -m seohead --version
  7. Installazioni più leggere. Gli extra mcp, render, reports, pdf e gsc si possono installare separatamente. Un tool a cui manca il suo extra risponde con il comando di installazione esatto.
  8. 4Browser per il rendering

    Serve solo per i controlli con rendering JavaScript.

    bash
    python -m playwright install chromium
    Chromium occupa circa 150 MB. Salta questo passo se analizzi solo le esportazioni di Screaming Frog.
  9. 5Collega le fonti dati (opzionale)

    Apri Impostazioni › Fonti dati nell'app desktop. Ogni provider indica se è collegato, se serve una chiave o se è spento.

    Impostazioni › Fonti dati. Le richieste a pagamento richiedono la tua chiave e una conferma esplicita.

Modifica questa pagina su GitHubAggiornato 12.10.2026