getdr: controllo in blocco del DR di Ahrefs

01 Cosa fa

getdr controlla il Domain Rating (DR) di Ahrefs per un dominio, una lista, un file o lo stdin. È un unico binario statico per Linux, macOS e Windows, open source con licenza MIT. Il DR arriva dall'endpoint gratuito ufficiale di Ahrefs: i controlli non costano nulla e non consumano unità API, ti basta una chiave API Ahrefs gratuita.

  █  █ ▄▀▀▄     domain     saas.com
  █  █ █  █     rating     49 ▐█████████▌░░░░░░░░░░  /100
  ▀▀▀█  ▀▀█     trend      ▁▅█  +4 since Sep 17
     █    █     checked    2026-10-28 · 12 min ago, cached
     █  ▄▄▀     version    dr3

  Domain Rating by Ahrefs · getdr by Index Pages

Ogni controllo viene salvato con la sua data in una cache SQLite locale. Una ricerca ripetuta non costa nessuna richiesta, e la scheda mostra di quanto si è mosso il DR dall'ultimo controllo. Lancia getdr serve e lo stesso binario diventa una piccola API HTTP: una macchina tiene la chiave e la cache, e ogni script, portatile e agente della tua rete interroga lei.

getdr è fatto di tre parti, e tutte restituiscono lo stesso record JSON:

• getdr – lo strumento a riga di comando e l'API getdr serve.
• getdr-mcp – un server MCP con un solo strumento, get_dr, per Claude, Cursor e altri client MCP.
• getdr-skill – una skill per agenti. Il suo script bash funziona anche dove il binario non è installato.

02 Installazione

Con Go 1.24 o successivo:

go install -trimpath github.com/index-pages/getdr@latest

Il binario finisce in $(go env GOPATH)/bin; controlla che quella directory sia nel tuo PATH.

Senza Go, scarica un archivio da GitHub Releases. Ogni release contiene build per Linux, macOS e Windows, per amd64 e arm64, più il file checksums.txt:

tar -xzf getdr_0.1.0_linux_amd64.tar.gz
sha256sum -c --ignore-missing checksums.txt
sudo install getdr /usr/local/bin/
getdr -V

Il binario è statico: niente cgo, SQLite è compilato dentro, non c'è altro da installare. Per compilarlo da te:

git clone https://github.com/index-pages/getdr
cd getdr
CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o getdr .

Per getdr serve c'è un Dockerfile. L'immagine è costruita FROM scratch e contiene solo il binario e un bundle di CA. Gira come utente non privilegiato e tiene la cache in /data:

docker build -t getdr .
docker run -d -p 8080:8080 -e GETDR_KEY=your-key -v getdr-data:/data getdr

Sono previsti pacchetti Homebrew, npm e PyPI, ma non sono ancora pubblicati.

03 Chiave Ahrefs gratuita

Le richieste all'endpoint Domain Rating di Ahrefs sono gratuite e non consumano unità API. Ogni richiesta deve però portare una chiave API, e anche la chiave è gratuita:

• Registra un account gratuito su ahrefs.com, se non ne hai già uno.
• Apri Account settings → API keys.
• Crea una chiave e copiala.

getdr cerca la chiave in quattro posti e usa la prima che trova:

Verifica che funzioni con getdr key check. getdr config show ti dice da quale fonte arriva la chiave e ne stampa solo gli ultimi 4 caratteri. La chiave serve solo quando c'è qualcosa da scaricare: i valori ancora freschi in cache vengono mostrati anche senza.

Il codice di uscita 3 indica sempre un problema con la chiave. Se il messaggio è "no Ahrefs API key", nessuna delle fonti qui sopra ne contiene una. Se è "rejected by Ahrefs (HTTP 401)", la chiave è sbagliata o revocata, quindi creane una nuova. Con --api vuol dire che il server getdr non ha una chiave o che Ahrefs l'ha rifiutata, e il problema va risolto sul server.

Ahrefs non pubblica un rate limit per questo endpoint. In pratica passano circa 40–60 richieste al minuto. getdr mette fino a 1000 target in una sola richiesta, non invia più di rpm richieste al minuto (40 di default) e ripete con backoff esponenziale le richieste che ricevono 429 o 5xx.

Per usare una sola chiave su più macchine, lancia getdr serve su una di esse e indica alle altre il suo indirizzo con api (vedi API HTTP). Ai client, a quel punto, non serve nessuna chiave.

04 Utilizzo

I target vengono normalizzati prima di qualsiasi invio. Un URL diventa il suo host, www. viene tolto, tutto passa in minuscolo, le etichette punycode (xn--…) vengono decodificate in Unicode e i duplicati spariscono. Così xn--e1afmkfd.xn--p1ai e ПРИМЕР.РФ vengono controllati entrambi come пример.рф. Con --raw i target partono esattamente come sono scritti.

Una riga sbagliata non rovina la lista. Un input senza host, con spazi o con caratteri di controllo viene scartato prima dell'invio. Quando Ahrefs rifiuta un target (localhost, a..com), getdr lo toglie dal batch e reinvia il resto. Per ognuno di questi target compare getdr: invalid target: X su stderr e il risultato resta vuoto; l'esecuzione termina con codice di uscita 2 e niente di tutto questo finisce in cache.

-f, --file FILE        read targets from FILE ("-" for stdin)
-o, --out FILE         write the result to FILE instead of stdout
    --format F         card, tsv, csv or json
-b, --bare             only the DR values
    --fields LIST      domain,dr,version,checked_at,delta,cached
    --sort             sort by DR (card always sorts)
    --all              card: show all rows
    --min N, --max N   filter by DR; exit 1 if any target fails
    --raw              no target normalization
    --version V        dr3 (default) or dr4
    --fresh            refetch and update the cache
    --no-cache         neither read nor write the cache
    --ttl DUR          cache TTL for this run (7d, 12h, 30m)
    --api URL          use a getdr server instead of Ahrefs
    --key KEY          Ahrefs API key
    --config PATH      config file
    --listen ADDR      serve: listen address
    --token T          serve: required token; with --api: token to send
-q, --quiet            no progress, attribution or warnings on stderr
-v, --verbose          cache hits, API calls and batches on stderr
-V                     print the getdr version

Comandi: getdr serve, getdr cache stats | clear | purge, getdr config show, getdr key check.

05 Output

In un terminale getdr stampa la scheda. Quando stdout è una pipe o un file, passa a tsv. --format e -b hanno la precedenza in entrambi i casi.

--fields sceglie le colonne di tsv e csv tra domain,dr,version,checked_at,delta,cached; il default è domain,dr. Un record json è sempre completo, e delta si aggiunge quando lo indichi. Il record JSON è lo stesso nella CLI, nel server, nello strumento MCP e nella skill:

{"target":"saas.com","dr":49,"version":"dr3","checked_at":"2026-10-28T12:00:00Z","cached":true}

Per i domini che non conosce Ahrefs risponde 0, quindi 0 è un valore normale. Un DR null con una data null significa che il target non era valido o che questa volta non ha avuto risposta. Un DR null accompagnato da una data significa che Ahrefs ha dichiarato esplicitamente di non avere dati.

La scheda rispetta NO_COLOR. Con TERM=dumb o con un locale senza UTF-8 ripiega su ASCII semplice, senza cifre grandi né barre. Una lista di più di 200 righe mostra le prime 200; --all le mostra tutte.

06 Configurazione

Ogni impostazione viene presa dal primo posto che la contiene: un flag da riga di comando, poi una variabile d'ambiente GETDR_*, poi il file di configurazione, infine il default integrato. La chiave si legge anche da AHREFS_KEY, che ha priorità più bassa di GETDR_KEY. Una variabile d'ambiente vuota conta come non impostata.

getdr usa il primo file di configurazione che trova: --config PATH, poi $GETDR_CONFIG, poi $XDG_CONFIG_HOME/getdr/config.toml (~/.config/getdr/config.toml se XDG_CONFIG_HOME non è impostata), poi /etc/getdr/config.toml. Un file indicato con --config o GETDR_CONFIG deve esistere. Un'impostazione sconosciuta è un errore, così un refuso non passa inosservato. ~/ all'inizio di un percorso viene espanso.

key = ""
api = ""
version = "dr3"

[cache]
path = "~/.cache/getdr/cache.db"
ttl = "7d"
ttl_none = "1d"
max_age = "30d"

[ahrefs]
batch = 1000
rpm = 40
timeout = "30s"
retries = 3

[serve]
listen = "127.0.0.1:8080"
token = ""
max_targets = 10000

Le durate accettano i giorni con il suffisso d (7d, 1.5d) e le durate di Go (36h, 90m, 30s). getdr config show stampa tutti i valori risultanti e da dove arriva ciascuno. Dei segreti (key, serve.token) mostra solo gli ultimi 4 caratteri.

Altre variabili d'ambiente che getdr legge:

• NO_COLOR disattiva i colori nella scheda.
• TERM=dumb, oppure un locale senza UTF-8 in LC_ALL, LC_CTYPE o LANG, dà una scheda in ASCII semplice.
• COLUMNS fissa la larghezza della scheda quando il terminale non la comunica.
• HOME, XDG_CONFIG_HOME e XDG_CACHE_HOME determinano dove stanno i file per default.
• HTTP_PROXY, HTTPS_PROXY e NO_PROXY vengono rispettate. Se passi da un proxy e usi come api un server getdr nella tua LAN, aggiungi quel server a NO_PROXY.

07 Cache e storico

Ogni controllo viene salvato come riga a sé (dominio, versione, DR, data). Da questo storico la scheda disegna il trend e getdr calcola delta. Un valore resta fresco finché l'ultimo controllo è più recente di ttl, o di ttl_none per "nessun dato"; dopo, getdr lo scarica di nuovo. I valori dr3 e dr4 sono tenuti separati. I target rimasti senza risposta non finiscono in cache.

getdr cache purge elimina i controlli più vecchi di max_age e conserva sempre l'ultimo di ogni dominio. getdr cache stats mostra percorso e dimensione del file, quanti controlli e quanti domini contiene, il controllo più vecchio e il più recente. getdr cache clear elimina tutti i controlli. La CLI e il server possono lavorare sullo stesso file di cache nello stesso momento.

08 API HTTP

getdr serve è una piccola API HTTP davanti ad Ahrefs, con una cache condivisa. La avvii una volta con una chiave Ahrefs e poi ci colleghi CLI, script e agenti. A loro non serve una chiave propria, e i controlli ripetuti arrivano dalla cache.

GETDR_KEY=your-key getdr serve --listen 0.0.0.0:8080 --token s3cret
curl -H 'Authorization: Bearer s3cret' 'http://lan-host:8080/dr?target=saas.com'

Ogni risposta porta l'header Server: getdr/<version> (index-pages.com). Gli errori sono in JSON: {"error":"…"}. Se è impostato un token, /dr e /stats richiedono Authorization: Bearer <token> e senza di esso rispondono 401. /, /healthz e /teapot sono sempre aperti.

POST /dr accetta esattamente quattro campi:

{"targets":["saas.com","https://www.example.com/page"],"version":"dr3","fresh":false,"raw":false}

{"results":[
  {"target":"saas.com","dr":49,"version":"dr3","checked_at":"2026-10-28T12:00:00Z","cached":true},
  {"target":"example.com","dr":93,"version":"dr3","checked_at":"2026-10-28T12:03:11Z","cached":false}
]}

I target vengono normalizzati e deduplicati, e i risultati seguono il loro ordine. Il server divide il lavoro in batch Ahrefs fino a 1000 target e rispetta il rate limit. Un client può chiedere fresh, ma non può cambiare il TTL del server. I target non validi non fanno mai fallire la richiesta: tornano dentro un normale 200 con dr e checked_at a null.

/stats risponde così; lookups conta i target dall'avvio del server, rows sono i controlli salvati e domains i domini distinti:

{
  "cache": {"size_bytes":45328,"rows":1200,"domains":950,
            "versions":{"dr3":900,"dr4":50},"oldest":"2026-10-01T09:00:00Z","newest":"2026-10-28T12:03:11Z"},
  "lookups": {"hits":1830,"misses":120,"hit_rate":0.9385},
  "ahrefs_requests_last_hour": 3
}

Se più client chiedono nello stesso momento lo stesso dominio con la stessa versione, il server fa una sola richiesta ad Ahrefs per tutti. La CLI si collega a un server così:

getdr --api http://lan-host:8080 --token s3cret -f domains.txt

Funziona allo stesso modo con api e serve.token nel file di configurazione, oppure con GETDR_API e GETDR_SERVE_TOKEN. La CLI invia un solo POST /dr per i target che la sua cache non copre e inoltra --fresh. Anche questa richiesta segue le variabili del proxy, quindi aggiungi a NO_PROXY un server che sta nella LAN.

09 Agenti AI

getdr-mcp è un server MCP con un solo strumento, get_dr. Non fa richieste ad Ahrefs per conto suo: interroga un server getdr o il binario getdr. Funziona su stdio, non ha dipendenze a runtime e richiede Node.js 18 o successivo. Aggiungilo a Claude Desktop, Claude Code, Cursor o a un altro client MCP:

{
  "mcpServers": {
    "getdr": {
      "command": "npx",
      "args": ["-y", "getdr-mcp"]
    }
  }
}

Con questa configurazione usa il binario getdr nel tuo PATH, con la sua configurazione, la sua cache e la sua chiave. Per usare invece un server getdr della tua rete, aggiungi "env": {"GETDR_API": "http://lan-host:8080", "GETDR_SERVE_TOKEN": "s3cret"}. Il server MCP guarda prima GETDR_API, poi il binario; se non trova nessuno dei due, lo strumento restituisce un errore con le istruzioni per configurarlo.

Lo strumento restituisce un array JSON di record seguito dalla riga di attribuzione. I client con protocollo MCP 2025-06-18 o successivo ricevono anche structuredContent con un outputSchema. Se alcuni target non hanno avuto risposta, il risultato arriva comunque, con tutti i record e una nota che elenca quei target.

getdr-skill è una cartella con un SKILL.md e uno script bash, per qualsiasi agente che carichi le Agent Skills. Per Claude Code:

git clone https://github.com/index-pages/getdr-skill ~/.claude/skills/getdr

Lo script scripts/dr.sh usa il primo backend disponibile: un server getdr in GETDR_API, poi il binario getdr nel PATH, poi direttamente l'endpoint gratuito di Ahrefs con GETDR_KEY o AHREFS_KEY. Se non ne trova nessuno, esce con codice 3 e rimanda a come ottenere una chiave gratuita. Richiede bash, curl e jq 1.6 o successivo; con il binario installato basta bash. Qualunque strada prenda, l'output è lo stesso NDJSON.

10 Attribuzione e privacy

I dati Domain Rating provengono da Ahrefs e sono soggetti alla Domain Rating License, che richiede l'attribuzione "Domain Rating by Ahrefs". getdr la stampa nel piè di pagina della scheda e, con i formati per le macchine, una volta per esecuzione su stderr, mai su stdout (-q la disattiva). Mantienila quando pubblichi i numeri. getdr non è affiliato ad Ahrefs.

getdr si collega solo a due destinazioni: api.ahrefs.com e il server getdr che imposti in api. Non ha telemetria, controlli degli aggiornamenti o analytics, e rifiuta i redirect verso qualsiasi altro host. Ogni richiesta porta questo User-Agent:

Puoi verificarlo nel codice sorgente: tutte le richieste in uscita partono da internal/ahrefs e internal/remote. getdr-mcp si collega solo al server in GETDR_API, altrimenti avvia il binario. Lo script della skill comunica con GETDR_API o con api.ahrefs.com e passa le chiavi a curl in un file temporaneo con permessi 600, mai sulla riga di comando.

11 Chi lo sviluppa

getdr è sviluppato da Index Pages. Il nostro prodotto principale è un servizio di indicizzazione degli URL: spinge le pagine in Google, Bing, Yandex e in più di 10 altri motori, cioè negli indici da cui attingono le risposte di ChatGPT, Claude, Perplexity e AI Overviews. Un controllo del DR ti dice su quali domini conviene avere un link. Index Pages fa indicizzare le pagine che contengono quei link.

Il servizio è descritto nella home page, e la sua API REST per script e agenti nella pagina API. Bug e idee per getdr vanno nelle issue su GitHub.