Nuova ricercaTechnical SEO & AI Search · 2027Scopri il framework

Collegare Crawlens a Claude e agli altri strumenti di AI

Crawlens include un server MCP. Una volta collegato, l’app di AI che usi già può leggere le tue scansioni e i tuoi audit, spiegare i problemi, dare priorità alle correzioni e scrivere i ticket. Il tutto con il tuo abbonamento AI, senza chiave API.

Per ora l’interfaccia di Crawlens è solo in inglese. Per questo i nomi di impostazioni, pulsanti, strumenti e prompt restano in inglese, così li ritrovi subito nell’app.

Funziona conClaude DesktopClaude CodeCodexCursorVS Codee le altre app MCP

A cosa serve

MCP (Model Context Protocol) è il modo standard con cui le app di AI usano strumenti esterni. Quando l’app di AI ha bisogno dei dati di Crawlens, avvia il server MCP di Crawlens sul tuo computer. Il server legge le scansioni e gli audit salvati e restituisce risultati compatti e paginati.

  • Sola lettura. Non può avviare scansioni, modificare le impostazioni né eliminare nulla.
  • Locale. Gira sul tuo computer e non apre porte di rete. Crawlens stesso non carica nulla online.
  • Crawlens non deve essere aperto. L’app di AI avvia il server quando serve, con il runtime incluso in Crawlens. Non devi installare Node.js.

1. Attivalo in Crawlens

La condivisione è disattivata per impostazione predefinita. Gli strumenti di AI non vedono nulla finché non la attivi.

  1. Apri Crawlens e vai in Settings → Integrations → AI tools (MCP).
  2. Attiva Share audits with AI tools.
  3. In Projects AI tools can read, mantieni All projects oppure scegli Only these projects.
  4. Facoltativo: attiva Hide Search Console and Analytics data per nascondere agli strumenti di AI clic, impressioni, sessioni e risultati del controllo URL.

Ti serve almeno un progetto con una scansione già sottoposta ad audit. Se non hai ancora scansionato nulla, comincia da lì: fino ad allora l’AI non ha niente da leggere.

2. Collega lo strumento di AI

Nella stessa scheda delle impostazioni, ogni app ha un pulsante Copy setup for. Usalo: inserisce i percorsi esatti della tua installazione. Gli esempi qui sotto mostrano come appare la configurazione, con percorsi di esempio.

Claude Desktop

  1. Fai clic su Add to Claude Desktop.
  2. Esci da Claude Desktop e riaprilo. Chiudere la finestra non basta: esci dall’app dall’area di notifica della barra delle applicazioni.
  3. In una nuova chat, apri il menu degli strumenti. Dovresti vedere crawlens.

Crawlens si aggiunge a claude_desktop_config.json mantenendo gli altri server MCP. Se il file esiste già, Crawlens salva prima una copia di backup con data accanto. Sono supportate sia la versione classica di Claude Desktop sia quella del Microsoft Store.

Preferisci modificare la configurazione da solo?

Aggiungi questo a %APPDATA%\Claude\claude_desktop_config.json, unendolo agli eventuali mcpServers già presenti:

{
  "mcpServers": {
    "crawlens": {
      "command": "C:\\path\\to\\Crawlens.exe",
      "args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

Claude Code

  1. Fai clic su Copy setup for → Claude Code.
  2. Incolla il comando in un terminale ed eseguilo.
  3. Avvia claude ed esegui /mcp per verificare che crawlens sia collegato.

Il comando registra Crawlens per il tuo account utente (--scope user), quindi è disponibile in tutti i tuoi progetti:

claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"

Codex

Una sola configurazione vale per la CLI di Codex, l’estensione per IDE e l’app.

  1. Fai clic su Copy setup for → Codex.
  2. Incollala alla fine di ~/.codex/config.toml (crea il file se non esiste).
  3. Riavvia Codex.
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']

[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'

La configurazione copiata contiene anche, come commento, il comando codex mcp add … equivalente, se preferisci eseguirlo.

Cursor

  1. Fai clic su Copy setup for → Cursor.
  2. Apri ~/.cursor/mcp.json e incollala. Se il file contiene già dei server, aggiungi la voce crawlens dentro i mcpServers esistenti.
  3. Controlla Cursor Settings → MCP: crawlens deve risultare attivo.
{
  "mcpServers": {
    "crawlens": {
      "command": "C:\\path\\to\\Crawlens.exe",
      "args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

VS Code

  1. Fai clic su Copy setup for → VS Code.
  2. Incollala in .vscode/mcp.json nella tua area di lavoro. In alternativa esegui MCP: Add Server dal riquadro comandi.
  3. Apri Copilot Chat in modalità Agent e cerca crawlens nell’elenco degli strumenti.
{
  "servers": {
    "crawlens": {
      "type": "stdio",
      "command": "C:\\path\\to\\Crawlens.exe",
      "args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

Altre app MCP: funziona qualsiasi app che supporti i server MCP stdio. Usa lo stesso comando, gli stessi argomenti e la stessa variabile d’ambiente ELECTRON_RUN_AS_NODE=1 mostrati sopra.

3. Prova la connessione

In Crawlens, fai clic su Test connection. Crawlens avvia il server esattamente come farà la tua app di AI e ti dice cosa ha trovato, per esempio:

Working: 8 tools, 3 prompts · 2 projects shared

Se la prova riesce ma l’app di AI non mostra Crawlens, il problema è nell’app. Riavviala e consulta la sezione risoluzione dei problemi.

Cosa chiedere

Indica il progetto per nome o per dominio. Puoi fare le domande in italiano. Alcuni prompt che funzionano bene:

Riassumi l’ultimo audit Crawlens di example.com e dammi un elenco di correzioni in ordine di priorità.
Scrivi nuovi title per le pagine che non ce l’hanno.
Spiega le catene di redirect al nostro sviluppatore.
Cosa è peggiorato dall’ultima scansione?
Quali pagine ricevono clic dalla ricerca ma restituiscono errori o sono in noindex?
Trova le pagine indicizzabili nelle posizioni 11–20 e suggerisci come portarle in prima pagina.

Strumenti e prompt

Ecco cosa vede la tua app di AI. I risultati sono paginati (50 righe per impostazione predefinita), così i siti grandi non intasano la conversazione.

StrumentoCosa restituisce
list_projectsI progetti che Crawlens condivide, con la loro ultima scansione.
list_crawlsLe scansioni di un progetto, dalla più recente, con punteggio di salute e numero di problemi.
get_overviewIl riepilogo di una scansione sottoposta ad audit: punteggio di salute, problemi per gravità, problemi principali, codici di stato, indicizzabilità, Core Web Vitals e totali di Search Console, Analytics e log del server quando presenti.
list_issuesOgni controllo non superato: cosa significa, come risolverlo e quanti URL sono interessati (i più gravi per primi).
get_issue_urlsGli URL colpiti da un problema, con i dettagli per ciascuno.
query_urlsFiltrare, ordinare e scorrere gli URL scansionati come nella tabella degli URL, comprese le colonne di Search Console, GA4 ed estrazione personalizzata.
get_url_detailsTutto su un URL: campi SEO, problemi, link, redirect, header, dati strutturati, HTML originale o renderizzato, Core Web Vitals e dati di ricerca.
compare_crawlsCosa è cambiato tra due scansioni: punteggio di salute, problemi nuovi e risolti per controllo, e modifiche agli URL.

Se l’app di AI lo supporta, nel menu dei prompt o dei comandi slash compaiono dei prompt pronti all’uso:

PromptCosa fa
Summarise the audit & prioritise fixesUna sintesi dell’ultimo audit e un piano di correzioni ordinato per impatto e impegno, con un responsabile e URL di esempio per ogni voce.
Rewrite titles & meta descriptionsNuovi title (30–60 caratteri) e description (70–160) per le pagine con problemi di title o description, ciascuno nella lingua della pagina.
Explain an issue for developersUn problema spiegato con gli URL e i valori reali di questo sito: causa, verifica, correzione e una checklist.

Privacy e sicurezza

  • Disattivato finché non lo attivi, e puoi disattivarlo in qualsiasi momento. A quel punto il server rifiuta ogni richiesta.
  • Sola lettura. Il server apre i tuoi dati in sola lettura. Non può scansionare, modificare le impostazioni né eliminare nulla.
  • Nessuna porta di rete. Comunica con l’app di AI solo tramite standard input e output, sul tuo computer.
  • Scegli tu cosa è visibile: tutti i progetti o solo alcuni, con o senza i dati di Search Console e Analytics.

Crawlens non carica nulla online, ma la tua app di AI invia ciò che legge al proprio servizio di AI, come parte della conversazione. Valgono quindi le regole sulla privacy dell’app di AI: controllale prima di condividere dati dei clienti.

Risoluzione dei problemi

Crawlens non compare nella mia app di AI
Riavvia completamente l’app dopo la configurazione. Claude Desktop resta attivo nell’area di notifica: esci da lì. Per Cursor e VS Code, verifica che il JSON sia ancora valido dopo averlo incollato: una virgola mancante rende inutilizzabile l’intero file.
“Sharing audits with AI tools is turned off”
Attiva Share audits with AI tools in Settings → Integrations → AI tools (MCP).
“No shared project matches …”
Il progetto non è nell’elenco che gli strumenti di AI possono leggere, oppure il nome non corrisponde. Il messaggio di errore elenca i progetti disponibili. Aggiungi il progetto in Projects AI tools can read, oppure rifai la domanda usando uno di quei nomi.
“This project has no audited crawl yet”
Prima scansiona il sito in Crawlens. L’AI legge gli audit, quindi serve almeno una scansione completata e sottoposta ad audit.
“This data was saved by an older Crawlens”
Apri una volta il progetto in Crawlens. I suoi dati vengono aggiornati e l’app di AI può di nuovo leggerli.
Ha smesso di funzionare dopo che ho spostato o reinstallato Crawlens
La configurazione contiene il percorso di Crawlens.exe. Copia di nuovo la configurazione da Crawlens (o fai di nuovo clic su Add to Claude Desktop) per aggiornare i percorsi. Spostare la cartella dei dati da Crawlens invece non crea problemi: il server la segue in automatico.
“… is not valid JSON, so Crawlens left it untouched”
Il tuo claude_desktop_config.json conteneva già un errore di sintassi, quindi Crawlens non l’ha modificato. Correggi o elimina il file, poi fai di nuovo clic su Add to Claude Desktop.

Non hai ancora Crawlens?

Scaricalo, scansiona un sito e poi torna qui per collegare i tuoi strumenti di AI.

Scarica gratis per Windows