Server MCP per la SEO con agenti AI

Un server MCP stdio locale espone gli stessi strumenti a Claude Code, Claude Desktop, Codex, Cursor e altri client MCP. La registrazione è mostrata prima che qualsiasi file sia modificato.

Cosa fa

Profili

--profile full espone ogni strumento. I profili audit, infra, quick-check e router espongono insiemi più piccoli per sessioni mirate, così l'agente vede meno schemi. Il profilo router pubblicizza solo un doctor, l'ispezione URL, il flusso di audit e il catalogo degli strumenti, e l'agente può scoprire il resto tramite il catalogo. Un profilo più stretto blocca subito gli strumenti esclusi, mentre un client deve riavviarsi per vederne di nuovi attivati.

  • audit: strumenti limitati per l'audit Screaming Frog
  • infra: controlli su dominio, CDN, tecnologia, sicurezza, header, robots e sitemap
  • quick-check: piccoli controlli su URL, incluso il controllo in batch
  • seohead mcp status --json mostra il profilo e i conteggi esatti degli strumenti

Registrazione sicura

La registrazione è prima un piano. Esegui seohead mcp install con --dry-run per vedere il blocco di configurazione, il file che cambierebbe, un percorso di backup e lo SHA-256 dell'originale. Nulla viene scritto. Aggiungi --yes per applicarlo. La configurazione del client viene salvata, sostituita in modo atomico e riletta, e gli altri server che contiene restano.

  • Client: Claude Code, Claude Desktop, Codex e Cursor, scelti con --client
  • --expected-sha256 rifiuta l'installazione se il file è cambiato dopo l'anteprima
  • seohead mcp uninstall ripristina dal backup
  • seohead mcp disable impedisce al server di accettare chiamate

Agenti con memoria

I progetti conservano ambito, policy di scansione, scansioni e storico, quindi il prossimo agente continua dal progetto salvato invece che dalla chat. L'inbox di un progetto raccoglie le note dello specialista e gli obiettivi proposti. Un host può anche limitare un processo MCP a un nome consumer e a un elenco di cartelle di progetto ammesse.

  • workflow-status dice a un nuovo agente il prossimo passo registrato
  • Le scritture prendono la revisione corrente e falliscono su un conflitto
  • Le operazioni a pagamento richiedono conferma esplicita, come confirm_paid=true

Tre passaggi, una scansione salvata

  1. Anteprima della registrazione

    Esegui prima l'installazione con --dry-run. Stampa il blocco di configurazione esatto, il file che cambierebbe, un percorso di backup e uno sha256, e non scrive nulla.

  2. Installa con --yes

    Dopo aver letto il piano, aggiungi --yes. La configurazione precedente viene salvata accanto, e --expected-sha256 rifiuta l'installazione se il file è cambiato dopo l'anteprima.

  3. Gli agenti continuano il progetto salvato

    I progetti conservano ambito, policy di scansione, scansioni e storico. Il prossimo agente riprende il progetto salvato invece di partire dalla chat.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
REDIRECT_LOOPUna catena di redirect torna a una URL già visitata, quindi non si stabilizza maiCriticalPercorso del loop dalla catena di redirect (export SF Redirect Chains, o registrazioni di hop da una scansione nativa)
BROKEN_INTERNAL_LINKUn link interno punta a una URL che restituisce 4xxCriticalInlink Client Error (4xx): pagina di origine e posizione del link
REDIRECT_CHAINPiù di un hop prima della URL finaleImportantOgni hop con il suo codice di stato e la sua posizione
INTERNAL_LINK_TO_REDIRECTUn link interno punta a una URL 3xx invece che alla pagina finaleImportantInlink Redirection (3xx): pagina di origine e posizione nel DOM
BAD_REDIRECT_TYPEUn 302, 303 o 307 è usato dove è inteso uno spostamento permanenteTipCodice di stato per hop

Un solo comando

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

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

Cosa ti serve

  • Un client MCP: Claude Code, Claude Desktop, Codex, Cursor o qualsiasi client stdio
  • L'eseguibile seohead da un ambiente virtuale, come percorso assoluto
  • L'extra mcp del toolkit installato
  • Chiavi dei provider solo per gli strumenti a pagamento o con account

Limiti

  • È un server stdio locale. Non esiste un endpoint MCP ospitato
  • Non c'è ancora un giornale delle chiamate, quindi tieni il tuo log se serve una traccia di audit
  • Gli strumenti possono inviare richieste quando chiedi un controllo o una scansione. Leggi il catalogo per vedere quali
  • Installare la voce non attiva MCP da solo, e serve --yes per scrivere qualsiasi cosa

Domande

Registrare il server modifica la mia configurazione?
Non in anteprima. --dry-run non scrive nulla e mostra il file che cambierebbe (per Claude Code, ~/.claude.json), un percorso di backup e uno sha256. La modifica avviene solo con --yes.
Quali client sono supportati?
Claude Code, Claude Desktop, Codex e Cursor, selezionati con --client. Qualsiasi altro client MCP può usare lo stesso comando di server stdio.
Quanti strumenti vede un agente?
Dipende dal profilo. Il profilo full espone ogni strumento registrato, mentre audit, infra, quick-check e router espongono insiemi molto più piccoli. Esegui seohead mcp status --json per vedere il conteggio esatto per profilo nella tua installazione.
Il server gira nel cloud?
No. È un processo stdio locale. Le richieste di rete escono solo per i controlli che provochi tu, come una URL o una scansione. Una scansione scrive il suo file sotto ./scans/ per impostazione predefinita.
Un agente può spendere i miei soldi?
Non in silenzio. Le operazioni a pagamento richiedono conferma esplicita (confirm_paid=true) e le tue chiavi dei provider. tool-catalog segna quali strumenti possono spendere denaro.
Come lo spengo?
Esegui seohead mcp disable. Un server in esecuzione rifiuta allora le chiamate successive. uninstall rimuove la voce da una configurazione client e la ripristina dal backup.