> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/it/docs/ai-agents

# Usa DomScan con gli agenti IA

Consulta la documentazione API di Usa DomScan con gli agenti IA, i parametri delle richieste, i campi delle risposte, gli esempi di codice e la gestione degli errori per le integrazioni DomScan.

Collega DomScan a Claude, ChatGPT, Cursor, VS Code, Codex e Windsurf tramite MCP, fornisci agli agenti di programmazione le regole dell'API di cui hanno bisogno e parti da prompt già pronti.

### MCP o API REST?

#### Usa MCP quando decide l'assistente

Collega il server MCP quando un assistente sceglie quali controlli eseguire durante una conversazione. Trova da solo gli strumenti DomScan, accede con il tuo account o con una chiave API e ottiene risultati strutturati con la stessa classificazione, gli stessi costi in crediti e gli stessi codici di errore dell'API.

#### Usa REST quando decide il tuo codice

Chiama l'API REST da codice che gira senza un assistente: job pianificati, pipeline in blocco, backend e controlli di CI. Quando un agente di programmazione scrive codice che finisce nel tuo prodotto, fagli chiamare l'API REST partendo dalla descrizione OpenAPI.

Molti team usano entrambi: MCP per esplorare e fare prototipi in una chat o in un editor, e l'API REST nel codice scritto dall'agente. Entrambi usano la stessa chiave API e lo stesso saldo di crediti.

### Collega il tuo strumento di IA

Installa il server MCP di DomScan con un clic oppure esegui un solo comando nel terminale. Il tuo strumento ti chiede di accedere a DomScan la prima volta che esegue un controllo.

[Aggiungi a Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[Aggiungi a VS Code](vscode:mcp/install?%7B%22name%22%3A%22domscan%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdomscan.net%2Fmcp%22%7D)[Aggiungi a VS Code Insiders](vscode-insiders:mcp/install?%7B%22name%22%3A%22domscan%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdomscan.net%2Fmcp%22%7D)

Claude Code

Claude Code con una chiave API

Codex

Accesso a Codex

`codex mcp login domscan`

### Configurazione per strumento

Ogni strumento si collega allo stesso server MCP all'indirizzo `https://domscan.net/mcp`. Gli strumenti che supportano l'accesso aprono un login DomScan la prima volta che eseguono un controllo. Gli altri inviano la tua chiave API nell'header X-API-Key.

#### Claude Code

Esegui questo nel terminale. Claude Code ti chiede di accedere la prima volta che usa DomScan. Aggiungi `--scope user` per rendere DomScan disponibile in ogni progetto.

Claude Code

`claude mcp add --transport http domscan https://domscan.net/mcp`

Claude Code con una chiave API

`claude mcp add --transport http domscan https://domscan.net/mcp --header "X-API-Key: YOUR_API_KEY"`

#### Cursor

Usa il pulsante Aggiungi a Cursor qui sopra, oppure aggiungi questa voce a `~/.cursor/mcp.json` per tutti i progetti o a `.cursor/mcp.json` per un solo progetto.

mcp.json

```json
{
  "mcpServers": {
    "domscan": {
      "url": "https://domscan.net/mcp"
    }
  }
}
```

#### VS Code

Usa il pulsante Aggiungi a VS Code qui sopra, oppure aggiungi questa voce a `.vscode/mcp.json` nel tuo workspace. VS Code ti chiede di accedere all'avvio del server.

.vscode/mcp.json

```json
{
  "servers": {
    "domscan": {
      "type": "http",
      "url": "https://domscan.net/mcp"
    }
  }
}
```

#### Codex

Aggiungi il server, poi accedi. Per usare invece una chiave API, aggiungi questo blocco a `~/.codex/config.toml` e imposta `DOMSCAN_API_KEY` nel tuo ambiente.

Codex

`codex mcp add domscan --url https://domscan.net/mcp`

Accesso a Codex

`codex mcp login domscan`

~/.codex/config.toml

```json
[mcp_servers.domscan]
url = "https://domscan.net/mcp"
env_http_headers = { "X-API-Key" = "DOMSCAN_API_KEY" }
```

#### ChatGPT

Attiva la modalità sviluppatore in ChatGPT da Impostazioni, Connettori, Avanzate. Poi crea un connettore con questo URL e scegli OAuth. Le istruzioni passo passo sono nella [pagina di configurazione MCP](https://domscan.net/it/mcp-domain-checker).

URL del server MCP

`https://domscan.net/mcp`

#### Claude

In Claude sul web o in Claude Desktop, apri Impostazioni, poi Connettori, e aggiungi un connettore personalizzato chiamato DomScan con questo URL. Claude apre un accesso a DomScan per completare la procedura.

URL del server MCP

`https://domscan.net/mcp`

#### Windsurf

Apri le impostazioni MCP in Windsurf, visualizza la configurazione grezza e aggiungi questa voce a `mcp_config.json`. Sostituisci YOUR_API_KEY con la tua chiave.

mcp_config.json

```json
{
  "mcpServers": {
    "domscan": {
      "serverUrl": "https://domscan.net/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
```

Questi link e comandi non contengono mai la tua chiave API. Gli strumenti che supportano l'accesso si collegano direttamente al tuo account DomScan. Per usare invece una chiave, sostituisci `YOUR_API_KEY` con una chiave da [le tue chiavi API](https://domscan.net/it/api-keys).

### Istruzioni per gli agenti di programmazione

Incolla questo in AGENTS.md, CLAUDE.md o nel file di regole del tuo editor, così gli agenti di programmazione chiamano DomScan correttamente.

AGENTS.md

```text
## DomScan API

Usa DomScan (https://domscan.net) per controlli di disponibilità dei domini, DNS, WHOIS e RDAP, SSL, sicurezza email e valutazione.

- URL base: `https://domscan.net`. Gli endpoint si trovano sotto `/v1`.
- Autenticazione: invia `X-API-Key: $DOMSCAN_API_KEY` (oppure `Authorization: Bearer $DOMSCAN_API_KEY`). Leggi la chiave dall'ambiente. Non scriverla mai nel codice, non registrarla nei log e non inserirla in un URL.
- Contratto: leggi la descrizione OpenAPI su https://domscan.net/v1/openapi.json prima di scegliere un endpoint o un parametro, e non indovinare i nomi dei parametri. Un riepilogo del sito per gli LLM è disponibile su https://domscan.net/llms.txt.
- MCP: il server remoto è https://domscan.net/mcp (HTTP streamable, accesso oppure gli stessi header con la chiave API).
- Crediti: la maggior parte degli endpoint costa crediti. Prima di operazioni in blocco o ripetute, chiama `POST /v1/estimate` con `method`, `path`, `query` e `body` della richiesta, oppure aggiungi `dry_run=true` agli endpoint bulk, compare, recipe e prezzi. Entrambi sono gratuiti. Tieni traccia degli header di risposta `X-Credits-Charged` e `X-Credits-Remaining`.
- Bulk: controlla fino a 50 nomi di dominio completi con una sola richiesta `POST /v1/status/bulk` invece di ripetere controlli singoli in un ciclo.
- Ripetizioni: invia un header `Idempotency-Key` (ad esempio un UUID) nelle richieste POST che addebitano crediti. Ripetere la stessa richiesta con la stessa chiave entro 24 ore restituisce la risposta memorizzata senza addebitare di nuovo. Riprova solo quando `error.retryable` è true e attendi `Retry-After` in caso di 429.
- Errori: ogni corpo di errore ha la forma `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Ramifica la logica su `error.code`, come `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` o `RATE_LIMITED`, non sul messaggio.
- Sconosciuto non significa assente: i risultati includono `classification.status` con valore `present`, `absent` o `unknown`. Tratta `unknown` come "riprova più tardi", mai come disponibile o inesistente, e non considerare mai l'assenza una prova che un nome possa essere registrato o rivendicato.
- Aggiornamento: gli endpoint che possono rispondere con dati recenti accettano `max_age` in secondi (`max_age=0` richiede un controllo aggiornato) e restituiscono `cache_age_s`. Non cambia il costo.
- Risposte più piccole: aggiungi `fields=a,b.c` o `compact=true` alla query string. Nessuno dei due cambia il costo.
- Altro: https://domscan.net/AGENTS.md e https://domscan.net/docs.
```

### Prompt da provare

Copia un prompt oppure aprilo nel tuo assistente. Collega prima DomScan, così l'assistente può eseguire i controlli.

1.

Usando DomScan, verifica se questi 50 nomi sono disponibili come domini .com: [incolla i nomi]. Prima stima il costo in crediti e mostramelo prima di eseguire qualsiasi cosa. Poi elenca separatamente i risultati disponibili, occupati e sconosciuti, e non trattare i risultati sconosciuti come disponibili.

2.

Usa DomScan per verificare la sicurezza email di example.com: SPF, DKIM, DMARC e stato nelle blacklist. Spiega ogni problema in modo semplice e suggerisci il record DNS che lo risolve.

3.

Sto valutando di acquistare example.com. Usa DomScan per controllare WHOIS e date di registrazione, DNS, certificato SSL, reputazione e valore stimato, poi riassumi i rischi e cosa dovrei verificare prima di pagare.

4.

Usa DomScan per trovare domini simili e di typosquatting di example.com già registrati. Ordinali per rischio e segnala quelli che hanno un sito web o un server di posta.

5.

Aggiungi DomScan a questo progetto. Leggi https://domscan.net/AGENTS.md e https://domscan.net/v1/openapi.json, poi scrivi un piccolo client tipizzato per POST /v1/status/bulk che legga DOMSCAN_API_KEY dall'ambiente, invii un header Idempotency-Key e tenga separati i risultati sconosciuti da quelli disponibili. Aggiungi dei test.

### Risorse leggibili da macchina

Indirizza gli agenti a questi file pubblici invece di copiare la documentazione nei prompt.

- [`/AGENTS.md`](https://domscan.net/AGENTS.md) Guida pubblica per agenti
- [`/llms.txt`](https://domscan.net/llms.txt) Riepilogo del sito per gli LLM
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) Nomi vecchi e nuovi degli strumenti MCP