App desktop SEO

Un'app desktop nativa scritta in Python con PyQt5, sullo stesso core del CLI e del server MCP. Apre gli stessi progetti locali e le stesse scansioni conservate, senza web view e senza account ospitato.

Cosa fa

Tutto in una finestra

L'app ha due modalità. Progetti serve per lavorare con un agente AI: obiettivi, task, inbox, scansioni, confronto prima e dopo e report. Crawler per i controlli rapidi: inserisci una URL e premi Avvia, senza progetto. Entrambe leggono il registro dell'audit, quindi una segnalazione significa la stessa cosa che nel CLI.

  • Tabella URL con filtri, dettagli per URL, grafo dei link e confronto scansioni
  • Import dei log del server, playbook dei metodi, generatore di redirect ed editor dei task snippet
  • Temi chiaro, scuro e alto contrasto
  • Interfaccia in inglese e russo

Installazione e piattaforme

Oggi l'app gira dai sorgenti su qualsiasi sistema con Python 3.11 o successivo, e arriva con il core compatibile. Un pacchetto installatore macOS si può compilare: mette SpiderHead.app in Applicazioni e un wrapper del comando seohead in /usr/local/bin. I bundle Windows e Linux sono preparati negli script di build ma non hanno ancora un'accettazione su macchina pulita.

  • Sorgenti: installa in un ambiente virtuale, poi esegui seohead-desktop
  • macOS: un bundle PyInstaller e .pkg, firmato in locale, senza notarizzazione
  • Windows e Linux: gli script di build esistono, il runtime pacchettizzato non è ancora verificato
  • L'app non ripiega mai su un seohead globale sulla tua macchina

Stesso core, stessi file

L'app non porta un suo crawler. Chiama il core attraverso gli stessi contratti CLI e MCP locali che usano gli agenti, quindi una scansione avviata nel terminale compare nell'app e viceversa. Un agente può anche guidare la finestra, ma solo dopo che attivi il controllo locale.

  • Le scansioni avviate dall'app girano come processi separati, con una coda
  • L'interruttore del server MCP nell'app è condiviso con seohead mcp
  • Il controllo locale tramite seohead-desktop-agent è disattivo finché non lo abiliti

Tre passaggi, una scansione salvata

  1. Apri un progetto locale

    Punta l'app a una cartella di progetto. Apre gli stessi progetti locali e le stesse scansioni conservate del CLI.

  2. Scansiona o apri una scansione salvata

    Avvia una scansione dall'app oppure apri una scansione che hai già, poi leggi i risultati in una sola finestra.

  3. Lavora sui problemi

    Ogni segnalazione arriva dal registro dell'audit. Filtra la tabella URL, apri una URL e guardane i dettagli.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
REDIRECT_LOOPLa catena di redirect torna a una URL già visitataCriticalPercorso del redirect
TITLE_MISSINGLa pagina non ha l'elemento titleCriticalURL della pagina
REDIRECT_CHAINPiù di un hop di redirect prima della URL finaleImportantOgni hop con lo stato
CANONICAL_MISSINGUna pagina indicizzabile non ha URL canonicalImportantURL della pagina
ORPHAN_PAGEUna pagina non ha link interni che la puntanoImportantURL della pagina
HREFLANG_MISSING_RETURN_LINKL'hreflang di un'altra pagina punta qui, ma questa pagina non risponde con il link di ritornoImportantURL della pagina e insieme hreflang

Un solo comando

bash
seohead-desktop --project ./shop

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Una cartella di progetto locale esistente, aperta in sola lettura, oppure solo una URL in modalità Crawler
  • Python 3.11 o successivo, per eseguirla dai sorgenti
  • Il core compatibile, installato con l'app o incluso nel pacchetto macOS
  • Un CLI Screaming Frog con licenza non serve per la scansione nativa

Limiti

  • macOS è l'unica piattaforma con un test di fumata del pacchetto pronto. L'accettazione del runtime su Windows e Linux è ancora aperta
  • Gli installer precompilati non sono ancora pubblicati. Li compili dal repository
  • Le prestazioni della finestra su un milione di URL non sono dichiarate, e le finestre molto piccole sono ancora in verifica
  • La guida integrata usa attualmente etichette in russo

Domande

Serve la riga di comando per usarla?
Per installare dai sorgenti, sì: qualche comando in un terminale. Dopo, l'app è punta e clicca. Il pacchetto macOS offre anche un pulsante Installa strumento da riga di comando al primo avvio, e chiede i diritti di amministratore solo dopo che lo premi.
Serve un account, o i miei dati vanno a un server?
Non esiste alcun account ospitato. Progetti e scansioni restano sul tuo computer, nello stesso archivio locale che usano il CLI e il server MCP.
L'app desktop mostrerà gli stessi risultati del CLI?
Sì. L'app gira sullo stesso core e apre le stesse scansioni conservate, quindi una scansione fatta nel terminale compare nell'app.
Una scansione modifica il mio sito?
No. Le scansioni sono richieste in sola lettura. Le regole di redirect generate sono file che rivedi e pubblichi tu.
Su quali sistemi gira?
È scritta in Qt e l'installazione dai sorgenti è pensata per macOS, Windows e Linux. Finora solo macOS ha un pacchetto che ha passato un test di fumata. Su Linux, Qt può richiedere librerie di sistema per il display.
Qual è la licenza?
L'app desktop è GPL-3.0-or-later, perché PyQt5 lo richiede. Il toolkit core nello stesso repository è MIT.