SEO · GEO · CLI · MCP

Audit SEO + GEO per il tuo sito.
Decidi cosa correggere prima.

Q: Dove vengono salvati gli audit?

Osiris salva configurazione e audit localmente sotto ~/.osiris. L'utente può esportare i report in Markdown o JSON indicando un percorso di output.

Q: Come si installa Osiris?

Scarica dalla pagina Releases l'archivio per macOS Apple Silicon, macOS Intel, Linux x64 o Windows x64. Estrai il binario, aggiungilo al PATH e verifica l'installazione con osiris --version. I binari sono self-contained e non richiedono .NET.

Osiris esegue audit SEO e GEO approfonditi e trasforma i risultati in un piano d'azione ordinato per impatto, effort e priorità. Dal terminale o dal tuo agente AI.

Scarica Osiris Configura MCP

Un motore, due interfacce
Dati e audit in locale
Credenziali opzionali

terminal — esempio

$ osiris analyze start https://example.com \
  --depth 2 --max-pages 50 --wait

# Al termine, leggi il report e trova le priorità
$ osiris report get --format md
$ osiris issues list --quick-wins

# Controlla la visibilità AI del sito
$ osiris geo check --url https://example.com

CLI e MCP condividono gli stessi use case e risultati

01Pure C# / .NET 10

02CLI + server MCP stdio

03Report Markdown e JSON

04macOS · Linux · Windows

Un audit, più prospettive

Dal crawl alle azioni concrete.

Osiris raccoglie evidenze tecniche e contenutistiche, assegna priorità coerenti e rende ogni risultato consultabile da persone o agenti.

SEO tecnica e on-page

Controlla status, canonical, metadata, headings, link, robots, sitemap, immagini, sicurezza, accessibilità di base e struttura degli URL.

crawl controllato

Performance e contenuti

Misura peso e richieste delle risorse, cache, compressione, risorse render-blocking, TTFB, leggibilità, contenuti sottili e duplicati.

Core Web Vitals opzionali

GEO / visibilità AI

Valuta policy dei crawler AI, qualità di llms.txt, dati strutturati, citabilità, risposte dirette e segnali E-E-A-T.

score e raccomandazioni

Google Search Console

Collega query, landing page e stato di indicizzazione agli audit. L'integrazione è opzionale e degradabile se le credenziali non sono disponibili.

service account o OAuth

Keyword e content gap

Estrae topic dalle pagine e individua opportunità keyword e gap rispetto ai competitor. Senza DataForSEO usa suggerimenti autocomplete senza metriche di volume.

DataForSEO opzionale

Priorità che guidano il lavoro

Ogni rilievo ha severità, impatto, effort, score di priorità e banda P0–P3. Filtra i quick win o concentra l'analisi su una singola categoria.

roadmap prioritizzata

Un percorso semplice

Da URL a piano di lavoro.

Avvia un crawl bounded

Scegli URL iniziale, profondità e numero massimo di pagine. Osiris rispetta robots.txt e applica limiti al crawl e protezioni SSRF.

Leggi evidenze e priorità

Consulta lo score health, il riepilogo per severità, la roadmap P0–P3, le quick win e le evidenze associate a ogni rilievo.

Esporta o automatizza

Salva il report in Markdown o JSON, oppure collega Osiris a un client MCP e lascia che un agente legga audit, stato e issue.

Audit con analisi opzionali

osiris analyze start https://example.com \
  --use-gsc --use-keywords --wait

Report e quick win

osiris report get --format md --output ./audit.md
osiris issues list --quick-wins

Per agenti e client compatibili

Lo stesso audit.
Ora via MCP.

Avvia il server MCP su stdio per rendere audit e report disponibili al tuo agente AI. Le operazioni CLI e MCP condividono handler, parametri e modelli di risultato.

Trasporto stdioNessuna API pubblica da esporre. Il processo gira localmente nel client MCP.

Claude Code

claude mcp add osiris -- osiris mcp serve

Configurazione MCP stdio

{
  "osiris": {
    "type": "stdio",
    "command": "osiris",
    "args": ["mcp", "serve"]
  }
}

Altri esempi per OpenCode, Docker e override di configurazione sono nel README del progetto.

Interfaccia CLI

Una grammatica leggibile.

Osiris offre un solo motore di analisi con due interfacce: usa i comandi dal terminale oppure collega un client MCP. Gli audit possono essere esportati in Markdown o JSON.

Comando	Risultato
`osiris context`	Mostra workspace audit, configurazione e integrazioni.
`osiris analyze start <url> --wait`	Avvia il crawl e segue l'analisi fino al completamento.
`osiris analyze status --audit-id <id>`	Legge avanzamento e stato di un audit.
`osiris report get --format md\|json`	Ottiene il report Markdown o JSON.
`osiris issues list --quick-wins`	Filtra i rilievi prioritari e le quick win.
`osiris geo check --url <url>`	Valuta la visibilità AI e i segnali GEO del sito.
`osiris gsc queries --site-url <url>`	Consulta query Search Console, se configurata.
`osiris keywords ideas`	Esplora idee keyword a partire dai topic rilevati o da seed.
`osiris context set --audit-id <id>`	Imposta l'audit corrente: i comandi successivi possono omettere `--audit-id`.
`osiris config list\|get\|set`	Legge e scrive la configurazione utente; i segreti restano mascherati.
`osiris analyze list`	Elenca gli audit recenti, dal più recente.
`osiris analyze cancel`	Richiede l'annullamento di un audit in corso.
`osiris geo generate --output <cartella>`	Scrive `llms.txt`, aggiunte a `robots.txt` e JSON-LD consigliati.
`osiris gsc auth`	Verifica la credenziale Search Console e le proprietà leggibili.
`osiris gsc pages --site-url <url>`	Pagine di atterraggio principali di una proprietà.
`osiris gsc inspect --url <url>`	Stato di indicizzazione di un singolo URL.
`osiris keywords gap --competitor <dominio>`	Keyword dei concorrenti che il sito non copre (richiede DataForSEO).
`osiris mcp serve`	Avvia il server MCP su stdio.

Tutte le opzioni di ogni comando sono nel riferimento completo su GitHub. Gli audit vengono salvati in ~/.osiris/audits/. Le operazioni lunghe possono essere avviate senza attesa e seguite con il relativo ID.

Local-first, con limiti espliciti

I tuoi audit restano tuoi.

Osiris conserva audit e configurazione localmente sotto ~/.osiris. Il crawler ha limiti di profondità, pagine e concorrenza, rispetta robots.txt e blocca per impostazione predefinita gli indirizzi privati e locali. Le integrazioni esterne sono opzionali; il materiale segreto non viene mostrato dai comandi di configurazione.

Leggi la guida su GitHub

Download e installazione

Come installare Osiris?

Scarica l'archivio per il tuo sistema, estrai l'eseguibile e verifica la versione. La release 1.0.0 include quattro binari self-contained e i checksum SHA-256; non serve installare .NET.

Sistema	Download release stabile
macOS Apple Silicon	`osiris-osx-arm64.tar.gz`
macOS Intel	`osiris-osx-x64.tar.gz`
Linux x64	`osiris-linux-x64.tar.gz`
Windows x64	`osiris-win-x64.zip`

Scarica anche SHA256SUMS e verifica l'archivio prima di estrarlo: su macOS usa shasum -a 256 -c SHA256SUMS --ignore-missing, su Linux sha256sum --ignore-missing -c SHA256SUMS; su Windows confronta (Get-FileHash .\osiris-win-x64.zip -Algorithm SHA256).Hash con il valore in SHA256SUMS. Per altri dettagli consulta la guida ufficiale.

macOS e Linux

Installa il binario nel PATH

Seleziona dalla tabella l'archivio del tuo sistema. Esempio per macOS Apple Silicon:

tar -xzf osiris-osx-arm64.tar.gz
sudo install -m 0755 osiris /usr/local/bin/osiris
osiris --version

Su macOS, se Gatekeeper blocca il binario scaricato, segui il passaggio xattr nella guida ufficiale.

Windows x64

Estrai e aggiungi al PATH

Estrai lo ZIP, sposta osiris.exe in una cartella inclusa nel PATH e apri un nuovo terminale.

osiris.exe --version
osiris.exe analyze start https://example.com --wait

Per verificare l'archivio prima di estrarlo, confronta il checksum SHA-256 con il file SHA256SUMS della stessa release.

Dopo l'installazione, esegui il primo audit e consulta i comandi oppure collega Osiris a un client MCP.

Domande frequenti

Prima di eseguire il tuo audit.

Che cos'è Osiris?

Osiris è una piattaforma SEO e GEO in C# che analizza siti web, produce report prioritizzati e può essere usata sia da CLI sia come server MCP.

Qual è la differenza tra CLI e MCP?

CLI e MCP sono due interfacce sullo stesso livello applicativo: la CLI si usa dal terminale, mentre il server MCP espone le stesse capacità ad agenti e client AI compatibili.

Osiris richiede credenziali o servizi a pagamento?

Il crawl e gli audit principali funzionano senza credenziali. Google Search Console, DataForSEO e PageSpeed Insights sono integrazioni opzionali; alcune richiedono credenziali o hanno quote proprie.

Dove vengono salvati gli audit?

Osiris salva configurazione e audit localmente sotto ~/.osiris. Puoi esportare i report in Markdown o JSON indicando un percorso di output.

Come si installa Osiris?

Scarica dalla pagina delle release l'archivio per macOS Apple Silicon, macOS Intel, Linux x64 o Windows x64. Estrai il binario, aggiungilo al PATH e verifica l'installazione con osiris --version. I binari sono self-contained e non richiedono .NET.