FAQ
Installazione, Chrome e rendering JavaScript, robots.txt in 5xx, vecchi file .json, privacy, uso responsabile e dove chiedere.
Arachnide è davvero gratuito?
Sì. Arachnide SEO Spider è pubblicato con licenza MIT: sei libero di usarlo, modificarlo e condividerlo, anche per lavori commerciali. Non esiste un piano a pagamento, nessuna chiave di licenza e nessun account. Gli unici costi che puoi scegliere di sostenere sono quelli dei servizi di terzi che colleghi tu stesso: una chiave API di Anthropic o OpenAI per le correzioni IA, oppure un progetto Google Cloud per le API di PageSpeed e Search Console (gratuite entro le loro quote).
Quali sistemi e versioni di Node.js sono supportati?
macOS, Windows e Linux, con Node.js 18.17 o successivo; la suite di test gira su Node 18, 20 e 22. Installa l’ultima LTS da nodejs.org e controlla con node -v.
Il launcher non si apre su macOS
La prima volta, fai clic destro su start-mac.command e scegli Apri, perché macOS blocca gli script non firmati. Il launcher installa poi le dipendenze e apre il browser su http://localhost:4000.
Ottengo «cd: no such file or directory» o «npm ERR! enoent … package.json»
Non sei nella cartella di Arachnide. Usa cd seguito dal percorso della cartella estratta, per esempio cd ~/Downloads/arachnide-seo-spider, poi npm install e npm start.
«--disable-warning= is not allowed in NODE_OPTIONS»
La tua shell imposta un’opzione che la tua versione di Node non supporta. Esegui unset NODE_OPTIONS (macOS, Linux) oppure aggiorna Node.js all’ultima LTS. I launcher la rimuovono già.
Il rendering JavaScript non è disponibile
Installa Google Chrome, Microsoft Edge, Chromium o Brave. Se il browser è installato in una posizione insolita, avvia Arachnide con CHROME_PATH="/path/to/chrome" npm start. Arachnide stesso non scarica nulla: usa il browser già presente sul tuo computer tramite puppeteer-core.
Alcune pagine non mostrano H1 né contenuto
Probabilmente il sito costruisce il contenuto con JavaScript. Attiva il Rendering JavaScript in Impostazioni → Rendering e ripeti il crawl. La scheda JavaScript mostra allora cosa è cambiato tra l’HTML grezzo e quello renderizzato.
Il crawl si ferma subito: «robots.txt non disponibile, tutto vietato»
Il robots.txt del sito ha risposto con un errore 5xx o non era raggiungibile. La RFC 9309 richiede che un crawler lo tratti come vieta tutto, e Arachnide lo fa, con un avviso esplicito. Se sei sicuro di essere autorizzato a scansionare il sito, imposta robots.txt non disponibile → consenti (--robots-unavailable allow nella CLI) oppure usa la modalità robots segnala o ignora. Un robots.txt in 4xx, invece, significa che tutto è consentito.
I miei vecchi crawl sono file .json; posso ancora aprirli?
Sì. Dalla 3.18 i crawl sono salvati come NDJSON gzip (.jsonl.gz), ma le vecchie esportazioni .json (formati 1 e 2) vengono rilevate e si aprono ancora dalla cronologia o dal pulsante Importa. I crawl della 1.x si aprono con meno dettagli.
Arachnide invia i miei dati da qualche parte?
No. L’applicazione non ha account, telemetria né cloud; l’interfaccia è in ascolto solo su 127.0.0.1. Contatta i siti che scansioni, e solo i servizi che configuri tu stesso: Anthropic o OpenAI per le correzioni IA (l’estratto della pagina necessario a scrivere un title o una description), il tuo CMS tramite il suo connettore, le API di Google, il tuo server SMTP per gli avvisi. Chiavi API e credenziali sono salvate cifrate sul tuo disco (AES-256-GCM) e mai restituite al browser, registrate o esportate.
L’IA può modificare il mio sito senza di me?
No. L’IA propone, tu rivedi il prima / dopo e approvi, un connettore applica, Arachnide riscansiona per verificare, e ogni modifica può essere annullata dalla cronologia. La modalità simulazione è attiva per impostazione predefinita e un avviso esplicito precede la prima scrittura reale. Per gli agenti IA (MCP, REST), gli strumenti di scrittura sono contrassegnati come consequenziali, così Claude Code, Claude Desktop e ChatGPT chiedono il permesso, e ogni sito ha le sue regole (campi consentiti, dimensione dei lotti, sola lettura).
Quante pagine può scansionare?
Il budget predefinito è di 500 pagine: alzalo in Impostazioni → Limiti. Arachnide è stato testato su un sito sintetico locale di 200 000 pagine e 19,9 milioni di link; vedi Siti grandi per i valori misurati e cosa aspettarti sulla tua macchina.
Sostituisce Screaming Frog?
Copre lo stesso lavoro, un crawl desktop trasformato in un audit tecnico, e aggiunge correzioni applicate al CMS e strumenti per agenti IA, ma non fa tutto ciò che fa un prodotto commerciale maturo (analisi dei file di log, controllo ortografico, autenticazione tramite form…). Vedi il confronto onesto.
Cos’è l’uso responsabile?
Esegui il crawl solo dei siti di tua proprietà o che sei autorizzato ad analizzare. Sui siti dei clienti, mantieni da 2 a 5 richieste simultanee e aggiungi una pausa sugli hosting condivisi; rispetta il robots.txt a meno che tu non abbia un motivo e il diritto di fare altrimenti.
Dove segnalo un bug o faccio una domanda?
Apri una issue su GitHub con il tuo sistema operativo e la versione di Node.js, i passaggi per riprodurlo, l’URL scansionato se è pubblico e l’errore mostrato nel terminale o nella console del browser. Le pull request sono benvenute; vedi Informazioni.