Guida alla configurazione

Trova la tua lista di backlink e configura il monitoraggio mensile

Dieci minuti di configurazione ti garantiscono un registro datato di chi ti linka. Quando arrivano i problemi, confronta due file invece di indovinare.

Team di ricerca DarkSEO · Aggiornato 2026-10-28

Configurazione in sei passaggi

Accedi con Google

Usa la pagina dell'account per accedere. I nuovi account dispongono di $100 di credito, senza necessità di carta di credito.

Crea una chiave API

La chiave inizia con sk_. Tienila fuori dai repository pubblici; trattala come una password.

Prova la ricerca gratuita

action=overview&q=yourdomain.com non ha costi e conferma la tua chiave e l'ortografia del dominio.

Recupera le liste reali

Esegui refdomains, anchors e toppages, 1.000 righe per chiamata, 2 crediti ciascuna.

Salva con la data

Nomina i file come refdomains-2026-10.json. Non sovrascrivere mai il file del mese precedente.

Diff

Confronta le righe con quelle del mese precedente. I nuovi domini sono ciò che devi leggere.

Una chiamata, con ogni campo spiegato

Sostituisci il dominio e la chiave. Lo stesso pattern funziona per tutte le azioni.

bash

curl "https://darkseo.net/api.php?action=refdomains&q=yourdomain.com&per=1000&page=1&key=sk_live_..." \
  -o refdomains-2026-10.json

Riferimento dei parametri

Parametro	Significato	Note
action	Quale report eseguire	refdomains, backlinks, anchors, toppages e altri
q	Il dominio che stai analizzando	Dominio nudo, senza schema
key	La tua chiave API	Oppure invia Authorization: Bearer sk_...
page	Numero di pagina	La paginazione profonda è limitata a 50.000 righe
per	Righe per pagina	Da 10 a 5000; la fatturazione avviene una volta per chiamata
sort, order	Colonna di ordinamento e asc o desc	Utile per vedere i più recenti o i più grandi per primi

Nomina, archivia e confronta i file

Una lista di backlink trova è utile solo se i file possono essere confrontati senza aiuto. Una regola di denominazione chiara e una cartella per mese fanno la maggior parte del lavoro. Dedica dieci minuti alla regola ora, perché un'ora di ordinamento dopo è peggio. Poi non rinominarli mai.

Usa lo stesso pattern per ogni dominio e ogni chiamata, così un semplice ordinamento allinea i file per mese. Pattern misti rompono l'ordinamento, e un ordinamento rotto è il motivo per cui il file del mese precedente finisce per essere sovrascritto.

Nomi di file che si ordinano

Metti anno e mese per primi, poi il dominio, poi il nome della chiamata, come 2026-10 seguito dal dominio e refdomains. I mesi con zeri iniziali si ordinano correttamente e un nome in questo ordine si legge come un log.

Evita spazi e caratteri accentuati nei nomi. Gli script li gestiscono male e un copia fallito può sembrare un copia riuscito.

Una cartella per mese

Crea una cartella per ogni mese e copia i tre file per ogni dominio al suo interno. Una cartella per mese mantiene intatto il mese precedente, così un diff diventa un confronto tra due cartelle.

Imposta la cartella in sola lettura una volta chiuso il mese, se il tuo sistema lo permette. Un file salvato che non può essere modificato è un registro molto più solido.

Un breve changelog

Tieni un log in testo puro nella cartella principale. Scrivi una riga per ogni estrazione con la data, i domini e le chiamate effettuate. Un changelog ti permette di spiegare un'interruzione nella serie anni dopo, quando nessuno ricorda il motivo.

Aggiungi il costo in crediti da ogni risposta alla stessa riga, così il log diventa anche la fattura.

Registra ogni modifica alla lista dei domini nello stesso log, con il motivo. Un dominio aggiunto in un mese spiega un picco in quel mese e risparmia una lunga ricerca in seguito. Mantieni le righe in formato puro, così uno script può leggere il log se un giorno volessi un riepilogo automatico.

Errori e correzioni

Errore	Sintomo	Soluzione
Chiave mancante o errata	HTTP 401	Controlla la chiave e l'ortografia dell'intestazione
Saldo vuoto	HTTP 402	Ricarica con USDT (TRC-20) dalla pagina dell'account
Lettura di `ok` ignorata	File vuoto trattato come successo	Testa il flag ok nel tuo script prima di salvare
Sovrascrittura dell'ultimo mese	Impossibile eseguire il diff	Metti il mese nel nome del file
Ci si aspetta dati live	Nuovo link mancante	L'aggiornamento dell'indice avviene circa mensilmente; confronta mensilmente, non giornalmente

Automatizzarlo

Un'entry cron il primo del mese è sufficiente. Scrivi le tre chiamate curl in un unico script shell, aggiungi il mese a ogni nome di file e lascia che ti invii un'email solo quando il conteggio dei nuovi domini supera la tua soglia.

Le risposte autenticate includono _credits con il costo e il saldo residuo, così lo script può avvisarti prima che il saldo scenda troppo. Provalo una volta manualmente. Poi dimenticalo finché non arriva l'email.

Per un team, abbina l'estrazione mensile a le soglie di esempio, così tutti leggono la stessa regola.

Mantieni lo script noioso. Curl puro, un ciclo sui tuoi domini, una cartella per mese. Gli script noiosi sopravvivono ai cambiamenti del personale.

Gestire un'esecuzione fallita

Un'esecuzione fallita dovrebbe lasciare intatti i file del mese precedente e scrivere una riga nel changelog. La trappola comune è un download parziale: un file che esiste ma contiene un corpo di errore sembra dati a prima vista. Controlla la dimensione e il flag ok prima che venga spostato. Nulla raggiunge la cartella mensile senza essere verificato.

Se l'esecuzione fallisce due volte di fila, controlla prima la chiave e l'ortografia del dominio. La chiamata di panoramica gratuita testa entrambi senza costi, quindi un fallimento lì ti dice se il problema è la configurazione o la chiamata a pagamento.

Mantenere il monitoraggio entro un budget

Un monitoraggio è economico una volta che conosci la matematica. Ogni chiamata a pagamento viene fatturata una volta, indipendentemente dal numero di righe, fino a 1.000 righe per chiamata. Moltiplica le chiamate che fai per il loro costo in crediti, poi per $0,0001 per credito, e avrai la fattura mensile. Fallo prima.

Ecco la matematica per tre chiamate su un dominio. refdomains, anchors e toppages costano 2 crediti ciascuna, quindi sei crediti, che equivalgono a $0,0006 per il mese.

Stimare la fattura mensile

Aggiungi una chiamata bulk_dr per i nuovi arrivati a 1 credito, e il totale sale di un altro credito. La tabella nella pagina delle soglie calcola il caso di dieci siti, così puoi vedere come le cifre crescono con la lista.

Tieni la stima nello stesso log delle estrazioni. Una fattura che aumenta è più facile da spiegare quando la stima è stata scritta per prima.

Fermarsi prima che il saldo si esaurisca

Le risposte autenticate includono il costo e il saldo residuo. Leggile nello script, confronta il saldo con la stima del mese successivo e avvisati quando il margine è sottile. Una risposta con ok impostato a false dovrebbe fermare l'esecuzione prima che qualsiasi file venga salvato.

Un HTTP 402 significa che il saldo è esaurito. Ricarica con USDT (TRC-20) dalla pagina dell'account, poi riesegui le chiamate di quel mese piuttosto che saltare il mese.

Un ciclo mensile

Una bozza, non un prodotto. Salva tre report per dominio con il mese nel nome. Regola la lista e la chiave.

bash

#!/bin/bash
M=$(date +%Y-%m)
for D in yourdomain.com second-site.org; do
  for A in refdomains anchors toppages; do
    curl -s "https://darkseo.net/api.php?action=$A&q=$D&per=1000&key=$DARKSEO_KEY" -o "$D-$A-$M.json"
  done
done

Cosa fare con i file

Apri i file refdomains del mese scorso e di questo mese fianco a fianco e elenca i domini che sono solo nel nuovo. Quella lista è la tua lettura del mese.

Invia la lista attraverso bulk_dr per un punteggio di qualità rapido, controlla il file degli anchors per qualsiasi frase che è cresciuta e leggi le pagine top per gli URL che non riconosci. Se tutto sembra ordinario, scrivi una riga nel tuo log e chiudi la scheda.

Se qualcosa sembra sbagliato, apri il runbook e la tabella decisionale per il disavow. L'estrazione mensile costa una frazione di centesimo, quindi il vero costo è la tua attenzione.

Scrivere la nota mensile

Scrivi una breve nota alla fine di ogni mese. Nomina i domini, il conteggio dei nuovi domini, la quota massima di anchor e la decisione. Quattro righe sono sufficienti. Una nota scritta lo stesso giorno vale più di una lunga scritta dopo.

Tieni la nota accanto ai file, non al loro interno. Un lettore futuro dovrebbe trovare la decisione in un unico punto, con i numeri che la giustificano. Quel lettore potresti essere tu, tra un anno, senza ricordi di quel mese.

Domande sul monitoraggio mensile

Ho bisogno di un piano a pagamento per eseguire questo?

Non ci sono abbonamenti né minimi mensili, perché il servizio si basa su credito prepagato. I nuovi account ricevono $100 di credito gratuito senza bisogno di carta. Le ricerche gratuite non hanno costi, così puoi testare la configurazione prima di estrarre qualsiasi lista a pagamento.

Perché non eseguire lo script ogni giorno?

L'indice si aggiorna circa una volta al mese, quindi un lavoro giornalioso scaricherebbe di nuovo la stessa immagine. Le esecuzioni giornaliastiche spendono anche crediti per nessuna nuova informazione. Il mensile è il ritmo onesto per questi dati.

Cosa devo fare se il file nuovo è molto più grande?

Controlla il conteggio delle righe rispetto alla tua baseline, poi apri i nuovi arrivati nel diff. Un file più grande può derivare da un vero picco o da un limite di righe modificato. Escludi la seconda causa per prima, perché è il controllo più economico.

Uno script può monitorare più domini?

Sì. Il ciclo mensile sopra gestisce un elenco di domini, e ognuno ottiene i propri file. Tieni l'elenco abbastanza breve in modo che ogni dominio riceva una lettura reale ogni mese, perché un monitoraggio che nessuno legge è solo un costo di archiviazione.

Due limiti da ricordare

L'indice si aggiorna circa una volta al mese, quindi un lavoro cron giornalioso scaricherebbe solo la stessa immagine. E una lista di link non è un verdetto: abbina ogni segnale con il rapporto dei link della Search Console prima di agire.