Installazione

GEO Optimizer si installa come progetto Python locale con un ambiente virtuale isolato. Nessun pacchetto di sistema viene modificato.

Requisiti

Requisito	Versione minima	Note
Python	3.8+	Python 3.10+ consigliato
Git	Qualsiasi	Usato per clonare e aggiornare il repository
OS	macOS, Linux, WSL	Windows solo tramite WSL

Verifica i prerequisiti:

python3 --version   # Deve restituire 3.8 o superiore
git --version        # Qualsiasi versione va bene

Installazione consigliata

L'approccio più sicuro è scaricare lo script di installazione, esaminarlo e poi eseguirlo:

# Scarica l'installer
curl -sSL https://raw.githubusercontent.com/auriti-web-design/geo-optimizer-skill/main/install.sh -o install.sh

# Esamina lo script (buona pratica)
less install.sh

# Eseguilo
bash install.sh

Questo installa in ~/geo-optimizer-skill per impostazione predefinita e:

1. Clona il repository da GitHub
2. Crea un ambiente virtuale Python isolato (.venv)
3. Installa le dipendenze (requests, beautifulsoup4, lxml)
4. Genera uno script wrapper ./geo per una facile esecuzione

Perché esaminare prima?

Non eseguire mai alla cieca script scaricati da internet nella tua shell. Scaricare e controllare lo script prima di eseguirlo è una buona pratica di sicurezza.

Installazione rapida (un solo comando)

Se hai già esaminato lo script in precedenza o ti fidi della fonte:

curl -sSL https://raw.githubusercontent.com/auriti-web-design/geo-optimizer-skill/main/install.sh | bash

Percorso di installazione personalizzato

Per installare in una directory diversa da ~/geo-optimizer-skill, usa il flag --dir:

# Sintassi con uguale
bash install.sh --dir=/opt/geo-optimizer

# Sintassi con spazio
bash install.sh --dir /opt/geo-optimizer

Quando si usa il piping con percorsi personalizzati

Se usi il metodo curl su una riga, devi passare il flag in modo diverso:

curl -sSL https://raw.githubusercontent.com/auriti-web-design/geo-optimizer-skill/main/install.sh | bash -s -- --dir=/opt/geo-optimizer

Cosa viene installato

Dopo l'installazione, la struttura delle directory si presenta così:

~/geo-optimizer-skill/
├── geo                        # Script wrapper (esegue comandi senza attivare il venv)
├── install.sh                 # Installer (può essere rieseguito senza problemi)
├── update.sh                  # Aggiornamento
├── requirements.txt           # Dipendenze Python
├── scripts/
│   ├── geo_audit.py           # Audit del sito (punteggio 0-100)
│   ├── generate_llms_txt.py   # Generatore llms.txt
│   └── schema_injector.py     # Strumenti per schema JSON-LD
├── ai-context/                # File di contesto per piattaforme AI
│   ├── claude-project.md
│   ├── chatgpt-custom-gpt.md
│   ├── chatgpt-instructions.md
│   ├── cursor.mdc
│   ├── windsurf.md
│   └── kiro-steering.md
├── tests/                     # Suite di test
├── docs/                      # Documentazione interna
├── references/                # Metodologia e template
└── .venv/                     # Ambiente virtuale Python

Esecuzione degli script

Il wrapper ./geo permette di eseguire qualsiasi script senza attivare manualmente l'ambiente virtuale:

cd ~/geo-optimizer-skill

# Usando il wrapper (consigliato)
./geo scripts/geo_audit.py --url https://example.com

# Oppure attivando il venv manualmente
source .venv/bin/activate
python scripts/geo_audit.py --url https://example.com

Aggiornamento

Per aggiornare GEO Optimizer all'ultima versione:

cd ~/geo-optimizer-skill
bash update.sh

Lo script di aggiornamento:

1. Verifica che l'installazione sia un repository Git valido
2. Mostra la versione attuale (hash del commit)
3. Scarica il codice più recente da main
4. Reinstalla le dipendenze (cerca .venv/bin/pip, poi pip3 o pip)
5. Mostra la nuova versione

Rieseguire install.sh

Puoi anche aggiornare rieseguendo install.sh. Se il repository esiste già nel percorso di destinazione, esegue un git pull origin main anziché un clone da zero.

Disinstallazione

Per rimuovere completamente GEO Optimizer:

rm -rf ~/geo-optimizer-skill

Nessun file di sistema, modifica al PATH o pacchetto globale viene toccato durante l'installazione, quindi la rimozione è pulita.

Risoluzione dei problemi

Python non trovato

Se python3 non è disponibile, installalo tramite il tuo gestore di pacchetti:

# macOS (Homebrew)
brew install python

# Ubuntu/Debian
sudo apt update && sudo apt install python3 python3-venv python3-pip

# Fedora
sudo dnf install python3 python3-pip

Permesso negato su install.sh

chmod +x install.sh
bash install.sh

La creazione dell'ambiente virtuale fallisce

Assicurati che il modulo venv sia disponibile:

# Ubuntu/Debian potrebbe richiedere questo pacchetto
sudo apt install python3-venv

Il clone Git fallisce dietro un proxy

git config --global http.proxy http://proxy.example.com:8080
bash install.sh

---

Prossimo: Utilizzo -- esegui il tuo primo audit e genera le risorse di ottimizzazione.