Usa DomScan con gli agenti IA

Usa DomScan con gli agenti IA

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?

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

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.

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

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

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

{
  "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.

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.

## 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.

   Apri in ClaudeApri in ChatGPTApri in Cursor

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.

   Apri in ClaudeApri in ChatGPTApri in Cursor

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.

   Apri in ClaudeApri in ChatGPTApri in Cursor

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.

   Apri in ClaudeApri in ChatGPTApri in Cursor

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.

   Apri in ClaudeApri in ChatGPTApri in Cursor

Risorse leggibili da macchina

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

• /AGENTS.md Guida pubblica per agenti
• /llms.txt Riepilogo del sito per gli LLM
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json Nomi vecchi e nuovi degli strumenti MCP