Repo del giorno: OpenSEO, la SEO open source con un server MCP per il tuo agente AI

💡 Cos'è: una suite SEO che ti self-hosti

OpenSEO si presenta senza mezzi termini come alternativa open source a Semrush e Ahrefs: gli stessi flussi di lavoro di una suite SEO — ricerca keyword, rank tracking, analisi dei competitor, backlink, audit tecnico — ma con codice MIT che giri sulla tua infrastruttura. Niente abbonamento mensile: l'app costa zero, e i dati li paghi a consumo tramite una chiave DataForSEO che porti tu.

La filosofia dichiarata è l'opposto della suite «fa tutto ma è pesante»: workflow mirati invece di un pannello sovraccarico. E siccome il sorgente è aperto, il progetto ti invita a forkarlo e a vibe-codarti il tuo strumento su misura — un dettaglio non casuale, visto che l'intero front-end è TypeScript su Cloudflare Workers, lo stesso stack su cui gira questo blog.

# 1. clona e prepara le variabili
cp .env.example .env

# 2. inserisci la tua chiave dati in .env
#    DATAFORSEO_API_KEY=...

# 3. su con Docker e apri il browser
docker compose up -d
#    http://localhost:3001

🧠 La svolta: pensata per te e per il tuo agente

Qui sta il motivo per cui OpenSEO finisce nel nostro repo del giorno. Il progetto non è solo una web-app: espone un server MCP che mette i dati SEO a disposizione di qualsiasi agente — Claude Code, Codex e simili — insieme a un set di skill pronte all'uso. In pratica il tuo agente smette di «parlare di SEO» e comincia a interrogare keyword, backlink e SERP reali mentre lavora.

È la differenza fra chiedere consigli generici a un modello e dargli i dati veri su cui ragionare. Una skill come keyword-research o competitor-analysis guida l'agente in un flusso ripetibile: raccoglie i numeri via MCP, li raggruppa in cluster, e produce raccomandazioni che puoi verificare riga per riga. La SEO entra nel processo, non resta un cruscotto da guardare.

🧰 I workflow coperti: dalla keyword all'AI visibility

Sul fronte funzionale OpenSEO copre le voci che ti aspetti da una suite, ma tenute snelle. La roadmap pubblica aggiunge audit schedulati, report per i clienti e SEO locale — segno che il progetto punta all'uso reale in agenzia e in azienda, non alla demo.

Una voce merita attenzione perché è nuova rispetto alle suite classiche: l'AI visibility, cioè capire se e come il tuo sito viene citato dalle risposte dei motori AI. È il terreno della GEO (Generative Engine Optimization): con sempre più ricerche che finiscono dentro un assistente, sapere se compari nelle risposte generate conta quanto il posizionamento su Google.

• Ricerca keyword e rank tracking per volumi, difficoltà e posizioni nel tempo.
• Competitor insights e backlink per mappare chi ti supera e perché.
• Site audit tecnico per gli errori on-page che frenano l'indicizzazione.
• AI visibility per misurare la presenza nelle risposte dei motori generativi.

⚙️ Come si usa: self-hosting e connessione all'agente

Per l'uso personale la via consigliata è Docker: parte in modalità single-user senza autenticazione, perfetta in locale. Se invece vuoi usarlo in team o da più dispositivi, c'è il deploy su Cloudflare Workers — compatibile col piano gratuito, con backup del database e un'esperienza in stile SaaS. La Search Console è opzionale e si collega con un tuo client OAuth Google in una decina di minuti.

Attivato il pannello, colleghi l'agente dalla sezione AI & Agents: OpenSEO ti dà la configurazione del server MCP da incollare in Claude Code o Codex, poi installi le skill dalla documentazione ufficiale. Da quel momento le keyword e i backlink del tuo progetto sono un contesto che l'agente può interrogare quando serve.

seo-project-setup     # imposta il progetto e gli obiettivi
seo-coach             # guida passo-passo sulle priorita
keyword-research      # volumi, difficolta, intento
keyword-clustering    # raggruppa le keyword per tema
competitive-landscape # panoramica dei competitor
competitor-analysis   # confronto puntuale con un rivale
link-prospecting      # trova opportunita di backlink

💰 Quanto costa davvero: il modello pay-as-you-go

«Gratis» va spiegato con onestà. L'applicazione OpenSEO è a costo zero perché la self-hosti; i dati, però, arrivano da DataForSEO, un servizio a pagamento indipendente. Paghi solo le chiamate che fai: un nuovo account include 1$ di credito di prova e la ricarica minima è 50$, quindi puoi testare tutto prima di decidere se mettere mano al portafoglio.

Gli ordini di grandezza sono bassi per chi non è un'agenzia enterprise: tracciare 100 keyword a settimana costa attorno a 1,20$ al mese, cento ricerche keyword circa 3,50$, cento panoramiche di dominio circa 4$. Il vantaggio non è solo il prezzo: è la prevedibilità. Niente scatti di tier o funzioni bloccate dietro il piano superiore — paghi il dato, punto.

repo      every-app/open-seo
stelle    ~3.600 · licenza MIT
attivita  ultima release v0.0.21 (24-06-2026)
stack     TypeScript · Cloudflare Workers · Drizzle
dati      DataForSEO (pay-as-you-go, min. 50$)

⚖️ OpenSEO o le suite chiuse: i compromessi

Non raccontiamola facile: Semrush e Ahrefs restano strumenti maturi, con dataset proprietari enormi, funzioni avanzate e supporto. OpenSEO non le sostituisce in tutto e per tutto, e da progetto giovane va validato sul proprio caso prima di affidarci lavoro critico.

Il punto è che per moltissimi scenari — la PMI che monitora poche decine di keyword, il freelance che fa qualche audit, il team dev che vuole i dati SEO dentro l'agente — il modello self-hosted a consumo è semplicemente più adatto. Controlli i dati, spendi solo quello che usi, e hai un aggancio MCP che le suite chiuse oggi non offrono.

🏢 Perché è interessante per sviluppatori e PMI

Per chi sviluppa, OpenSEO è un caso di studio prima ancora che un tool: un'app reale in TypeScript su Cloudflare Workers che impacchetta un server MCP e delle skill d'agente ben fatte. È esattamente il pattern che raccontiamo quando spieghiamo come si porta un dato di business dentro un flusso agentico — qui puoi leggerne il codice, forkarlo e adattarlo.

Per una PMI il valore è concreto: la SEO smette di essere un abbonamento opaco e diventa un processo controllabile, dove i dati restano tuoi e il costo segue l'uso. E l'aggancio all'agente cambia la scala: invece di leggere report, chiedi al tuo assistente di analizzare i competitor o pulire un cluster di keyword, con i numeri veri sotto. È la differenza fra «abbiamo un tool SEO» e «la SEO è dentro il nostro modo di lavorare»

🗺️ Da dove partire

Il percorso che suggeriamo è a basso rischio: avvia OpenSEO in locale con Docker, crea un account DataForSEO e spendi il credito di prova su un progetto reale ma non critico — il tuo sito o quello di un cliente amico. Lancia una keyword-research dal pannello, poi collega il server MCP a Claude Code e ripeti la stessa ricerca chiedendola all'agente: è lì che capisci se il flusso agentico ti fa risparmiare tempo davvero.

Da lì, guarda le skill di clustering e competitor-analysis e prova l'AI visibility: è la parte più attuale, quella che ti dice se esisti anche nelle risposte generate dagli assistenti. Studiare come OpenSEO cuce insieme dati, MCP e skill è, di per sé, un'ottima lezione di ingegneria agentica — replicabile ben oltre la SEO.

Altri articoli del blog