Claude Code e DataForSEO: ricerca SEO e audit spendendo pochi dollari

Nella guida su OpenSEO ho spiegato come avere una dashboard SEO self-hosted su Cloudflare. Per il lavoro di tutti i giorni va benissimo. Ma da qualche mese la maggior parte della mia ricerca la faccio in un altro modo: chiedo a Claude Code di interrogare direttamente DataForSEO, salvare i dati e analizzarli. Con questo metodo ho fatto lo studio su local SEO e AI (352 domande, 1.684 schede Google, 810 siti) spendendo circa 5,6 dollari di dati.

Qui racconto come lo uso, quanto costa davvero e dove bisogna stare attenti.

I due strumenti

• Claude Code è l’agente di Anthropic che lavora sui file di un progetto: legge, scrive, esegue comandi e script, e usa strumenti esterni collegati tramite MCP (Model Context Protocol). Si usa dal terminale o dall’app desktop. Basta il piano Pro di Claude: io lo pago 21,96 euro al mese.
• DataForSEO è un fornitore di dati SEO via API: SERP di Google, Maps, volumi e difficoltà delle keyword, backlink, Lighthouse, risposte dei motori AI. Si paga a consumo, senza abbonamento, ma per cominciare la ricarica minima di 50 dollari è obbligatoria. Il credito non scade, e c’è 1 dollaro di prova per i nuovi account (listino DataForSEO).

Messi insieme, il modello di costo cambia: invece di un abbonamento mensile a una suite, paghi un piano Claude Pro e solo i dati che chiedi, e il lavoro di analisi lo fa l’agente.

Come li collego

1. Server MCP di DataForSEO: lo registro nella configurazione MCP del progetto in Claude Code (un file .mcp.json nella cartella), con le credenziali dell’API. Da quel momento posso chiedere in italiano «controlla volume e difficoltà di queste 15 keyword in Italia» e Claude Code chiama gli endpoint giusti.
2. Script per i lavori grandi: per raccolte da centinaia di richieste faccio scrivere a Claude Code piccoli script Python che chiamano l’API direttamente, salvano i risultati in JSON e si possono rilanciare. Restano nel progetto, documentati.
3. Credenziali fuori da git: il file con le chiavi non va mai committato né condiviso.

Cosa ci faccio, con i costi veri

Lo stesso controllo di visibilità nelle AI, fatto prima con lo strumento integrato di OpenSEO, mi era costato 1,04 dollari, e 36 risposte su 80 erano andate in errore per i limiti del Worker. Chiamando DataForSEO direttamente il costo è sceso a 0,36 dollari, con tutte le 80 risposte arrivate; il giro successivo, in coda, è costato 0,20 dollari per altre 80.

Claude Code fa anche gli audit che non richiedono dati a pagamento. Per esempio, dopo ogni pubblicazione di questo sito gli faccio confrontare tutti i 400 e passa file HTML della build con quelli online, controllare le risposte 404, gli hreflang e i link interni. Il crawler self-hosted di OpenSEO legge solo una parte delle pagine, quindi questi controlli li faccio così.

Come spendere ancora meno

• Usa la coda, non il «live»: molti endpoint hanno una modalità standard in coda (si invia il lavoro e si scarica il risultato dopo, gratis) molto più economica della risposta immediata. Nei miei conti una SERP o una ricerca Maps costa 0,0006 $ in coda contro 0,002 $ in diretta, una risposta di un motore AI 0,0012 $ contro 0,004 $.
• Raggruppa: i dati di DataForSEO Labs costano 0,012 $ a chiamata più 0,00012 $ per risultato, quindi 40 keyword in una chiamata costano quasi come una sola.
• Fatti dare una stima prima: chiedo sempre a Claude Code quanto costerà un lavoro prima di lanciarlo, e lo approvo io.
• Riusa i dati: tutto quello che scarico finisce in file nel progetto, e la volta dopo si parte da lì invece di richiamare l’API.

Dove stare attenti

• Controlla i numeri: l’agente può sbagliare un conto o leggere male un campo. Nello studio ho verificato a mano l’abbinamento dei nomi (50 su 51 corretti tra i più citati) e ogni cifra pubblicata torna ai file di dati.
• Leggi bene i dati mancanti: per molte keyword italiane la difficoltà risulta 0, che vuol dire «nessun dato», non «facile». Prima di decidere, guarda la SERP.
• Le code a volte si bloccano: mi è capitato con Gemini, ferma oltre mezz’ora. In quel caso si passa alla modalità diretta, sapendo che costa di più.
• Sicurezza: le credenziali restano sul tuo computer; l’agente lavora sui tuoi file, quindi tieni il progetto sotto controllo di versione.

Tre cose successe davvero, mentre scrivevo queste guide

• I dati Bing erano sbagliati. Per la guida sui motori alternativi a Google ho chiesto a DataForSEO i risultati di Bing per 20 ricerche come «dentista catania». In coda, 12 risultati su 17 non c’entravano niente con la ricerca (per «psicologo catania» uscivano calcolatrici online). Rifatte in diretta, più di metà erano ancora fuori tema: per «ristorante catania» uscivano pagine di Yahoo Finanza. Le ho scartate tutte. Senza controllare a campione avrei pubblicato numeri inventati da un errore.
• Il modello costa più del previsto. Una risposta di Claude Sonnet 5.5 con ricerca web è costata 0,056 $, perché il modello legge molte pagine (oltre 15.000 token). La stessa domanda con Claude Haiku 5.5 è costata 0,0126 $. Per 20 domande la differenza era tra 1,10 $ e 0,25 $: ho fatto una prova su una sola domanda, ho visto il costo vero e ho scelto prima di lanciare il resto.
• Quando PageSpeed dice no. Per misurare i punteggi da citare nella home del sito, la quota anonima di PageSpeed Insights era esaurita. Ho fatto girare Lighthouse tramite DataForSEO, con la data annotata accanto a ogni numero.

OpenSEO o Claude Code + DataForSEO?

Li uso tutti e due. OpenSEO per avere una dashboard sempre pronta: Search Console, posizionamenti, panoramica dei domini. Claude Code con DataForSEO per tutto quello che è su misura: una ricerca per un articolo, un controllo su un cliente, uno studio con migliaia di dati. Quando una domanda non entra in un pannello già pronto, la seconda strada costa meno e arriva più lontano.

Se vuoi un audit del tuo sito fatto con questo metodo, il primo è gratuito.