> 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/nl/docs/ai-agents

# DomScan gebruiken met AI-agents

Bekijk de API-documentatie voor DomScan gebruiken met AI-agents, aanvraagparameters, responsvelden, codevoorbeelden en foutafhandeling voor DomScan-integraties.

Koppel DomScan via MCP aan Claude, ChatGPT, Cursor, VS Code, Codex en Windsurf, geef coderingsagents de API-regels die ze nodig hebben en begin met kant-en-klare prompts.

### MCP of REST API?

#### Gebruik MCP wanneer de assistent beslist

Koppel de MCP-server wanneer een assistent tijdens een gesprek zelf kiest welke controles hij uitvoert. Hij vindt de DomScan-tools zelf, logt in met je account of een API-sleutel en krijgt gestructureerde resultaten met dezelfde classificatie, kredietkosten en foutcodes als de API.

#### Gebruik REST wanneer je code beslist

Roep de REST API aan vanuit code die zonder assistent draait: geplande taken, bulkpipelines, backends en CI-controles. Als een coderingsagent code schrijft die in je product wordt uitgeleverd, laat die dan de REST API aanroepen op basis van de OpenAPI-beschrijving.

Veel teams gebruiken beide: MCP om te verkennen en te prototypen in een chat of editor, en de REST API in de code die de agent schrijft. Beide gebruiken dezelfde API-sleutel en hetzelfde tegoed.

### Koppel aan je AI-tool

Installeer de DomScan MCP-server met één klik, of voer één opdracht uit in je terminal. Je tool vraagt je de eerste keer dat hij een controle uitvoert om in te loggen bij DomScan.

[Toevoegen aan Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[Toevoegen aan 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)[Toevoegen aan 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 met een API-sleutel

Codex

Inloggen bij Codex

`codex mcp login domscan`

### Installatie per tool

Elke tool maakt verbinding met dezelfde MCP-server op `https://domscan.net/mcp`. Tools die inloggen ondersteunen, openen de eerste keer dat ze een controle uitvoeren een DomScan-login. De andere sturen je API-sleutel mee in de X-API-Key-header.

#### Claude Code

Voer dit uit in je terminal. Claude Code vraagt je de eerste keer dat het DomScan gebruikt om in te loggen. Voeg `--scope user` toe om DomScan in elk project beschikbaar te maken.

Claude Code

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

Claude Code met een API-sleutel

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

#### Cursor

Gebruik de knop Add to Cursor hierboven, of voeg dit item toe aan `~/.cursor/mcp.json` voor alle projecten of aan `.cursor/mcp.json` voor één project.

mcp.json

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

#### VS Code

Gebruik de knop Add to VS Code hierboven, of voeg dit item toe aan `.vscode/mcp.json` in je werkruimte. VS Code vraagt je in te loggen wanneer de server start.

.vscode/mcp.json

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

#### Codex

Voeg de server toe en log daarna in. Wil je in plaats daarvan een API-sleutel gebruiken, voeg dan dit blok toe aan `~/.codex/config.toml` en stel `DOMSCAN_API_KEY` in in je omgeving.

Codex

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

Inloggen bij 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

Schakel de ontwikkelaarsmodus in ChatGPT in onder Settings, Connectors, Advanced. Maak vervolgens een connector met deze URL en kies OAuth. Stapsgewijze instructies staan op de [MCP-installatiepagina](https://domscan.net/nl/mcp-domain-checker).

MCP-server-URL

`https://domscan.net/mcp`

#### Claude

Open in Claude op het web of in Claude Desktop Settings, dan Connectors, en voeg een aangepaste connector met de naam DomScan toe met deze URL. Claude opent een DomScan-login om het af te ronden.

MCP-server-URL

`https://domscan.net/mcp`

#### Windsurf

Open de MCP-instellingen in Windsurf, bekijk de ruwe configuratie en voeg dit item toe aan `mcp_config.json`. Vervang YOUR_API_KEY door je sleutel.

mcp_config.json

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

Deze links en opdrachten bevatten nooit je API-sleutel. Tools die inloggen ondersteunen, koppelen rechtstreeks aan je DomScan-account. Wil je in plaats daarvan een sleutel gebruiken, vervang dan `YOUR_API_KEY` door een sleutel van [je API-sleutels](https://domscan.net/nl/api-keys).

### Instructies voor coderingsagents

Plak dit in AGENTS.md, CLAUDE.md of het regelbestand van je editor, zodat coderingsagents DomScan correct aanroepen.

AGENTS.md

```text
## DomScan API

Gebruik DomScan (https://domscan.net) voor controles op domeinbeschikbaarheid, DNS, WHOIS en RDAP, SSL, e-mailbeveiliging en waardering.

- Basis-URL: `https://domscan.net`. Endpoints staan onder `/v1`.
- Authenticatie: stuur `X-API-Key: $DOMSCAN_API_KEY` (of `Authorization: Bearer $DOMSCAN_API_KEY`). Lees de sleutel uit de omgeving. Zet hem nooit hardcoded in code, log hem niet en zet hem niet in een URL.
- Contract: lees de OpenAPI-beschrijving op https://domscan.net/v1/openapi.json voordat je een endpoint of parameter kiest en raad parameternamen niet. Een sitesamenvatting voor LLM's staat op https://domscan.net/llms.txt.
- MCP: de externe server is https://domscan.net/mcp (streamable HTTP, inloggen of dezelfde API-sleutelheaders).
- Credits: de meeste endpoints kosten credits. Roep vóór bulk- of herhaald werk `POST /v1/estimate` aan met de `method`, `path`, `query` en `body` van het verzoek, of voeg `dry_run=true` toe aan bulk-, vergelijk-, recipe- en prijsendpoints. Beide zijn gratis. Volg de responsheaders `X-Credits-Charged` en `X-Credits-Remaining`.
- Bulk: controleer tot 50 volledige domeinnamen met één `POST /v1/status/bulk`-verzoek in plaats van over losse controles te lussen.
- Nieuwe pogingen: stuur een `Idempotency-Key`-header (bijvoorbeeld een UUID) mee bij POST-verzoeken die credits kosten. Als je hetzelfde verzoek met dezelfde sleutel binnen 24 uur opnieuw verstuurt, krijg je de opgeslagen respons terug zonder opnieuw af te rekenen. Probeer alleen opnieuw als `error.retryable` waar is en wacht op `Retry-After` bij 429.
- Fouten: elke foutbody is `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Vertak op `error.code`, zoals `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` of `RATE_LIMITED`, niet op het bericht.
- Onbekend is niet afwezig: resultaten bevatten een `classification.status` van `present`, `absent` of `unknown`. Behandel `unknown` als "probeer het later opnieuw", nooit als beschikbaar of ontbrekend, en beschouw afwezigheid nooit als bewijs dat een naam geregistreerd of geclaimd kan worden.
- Versheid: endpoints die uit recente data kunnen antwoorden, accepteren `max_age` in seconden (`max_age=0` vraagt om een verse controle) en geven `cache_age_s` terug. Dit verandert de kosten niet.
- Kleinere responsen: voeg `fields=a,b.c` of `compact=true` toe aan de querystring. Geen van beide verandert de kosten.
- Meer: https://domscan.net/AGENTS.md en https://domscan.net/docs.
```

### Prompts om uit te proberen

Kopieer een prompt of open hem in je assistent. Koppel eerst DomScan, zodat de assistent de controles kan uitvoeren.

1.

Controleer met DomScan of deze 50 namen beschikbaar zijn als .com-domein: [plak namen]. Schat eerst de kredietkosten in en laat die aan mij zien voordat je iets uitvoert. Toon daarna beschikbare, bezette en onbekende resultaten apart en behandel onbekende resultaten niet als beschikbaar.

2.

Gebruik DomScan om de e-mailbeveiliging van example.com te controleren: SPF, DKIM, DMARC en blacklist-status. Leg elk probleem in gewone taal uit en stel het DNS-record voor dat het oplost.

3.

Ik overweeg example.com te kopen. Gebruik DomScan om de WHOIS- en registratiedata, DNS, het SSL-certificaat, de reputatie en de geschatte waarde te controleren. Vat daarna de risico's samen en wat ik moet verifiëren voordat ik betaal.

4.

Gebruik DomScan om lookalike- en typosquatting-domeinen van example.com te vinden die al geregistreerd zijn. Rangschik ze op risico en wijs aan welke een website of mailserver hebben.

5.

Voeg DomScan toe aan dit project. Lees https://domscan.net/AGENTS.md en https://domscan.net/v1/openapi.json en schrijf daarna een kleine getypeerde client voor POST /v1/status/bulk die DOMSCAN_API_KEY uit de omgeving leest, een Idempotency-Key-header meestuurt en onbekende resultaten gescheiden houdt van beschikbare. Voeg tests toe.

### Machineleesbare bronnen

Wijs agents naar deze openbare bestanden in plaats van documentatie in prompts te kopiëren.

- [`/AGENTS.md`](https://domscan.net/AGENTS.md) Openbare agentgids
- [`/llms.txt`](https://domscan.net/llms.txt) Sitesamenvatting voor LLM's
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) Oude en nieuwe MCP-toolnamen