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

# Korzystanie z DomScan z agentami AI

Poznaj dokumentację API Korzystanie z DomScan z agentami AI, parametry żądań, pola odpowiedzi, przykłady kodu i obsługę błędów w integracjach DomScan.

Połącz DomScan z Claude, ChatGPT, Cursor, VS Code, Codex i Windsurf przez MCP, daj agentom kodującym reguły API, których potrzebują, i zacznij od gotowych promptów.

### MCP czy REST API?

#### Użyj MCP, gdy decyduje asystent

Podłącz serwer MCP, gdy asystent sam wybiera, jakie sprawdzenia uruchomić w trakcie rozmowy. Sam znajduje narzędzia DomScan, loguje się na Twoje konto lub kluczem API i otrzymuje ustrukturyzowane wyniki z tą samą klasyfikacją, kosztami kredytów i kodami błędów co API.

#### Użyj REST, gdy decyduje Twój kod

Wywołuj REST API z kodu działającego bez asystenta: zaplanowanych zadań, potoków masowych, backendów i testów CI. Gdy agent kodujący pisze kod, który trafia do Twojego produktu, niech wywołuje REST API na podstawie opisu OpenAPI.

Wiele zespołów używa obu: MCP do eksplorowania i prototypowania w czacie lub edytorze oraz REST API w kodzie pisanym przez agenta. Oba korzystają z tego samego klucza API i salda kredytów.

### Połącz z narzędziem AI

Zainstaluj serwer MCP DomScan jednym kliknięciem lub uruchom jedno polecenie w terminalu. Przy pierwszym uruchomieniu sprawdzenia narzędzie poprosi Cię o zalogowanie się do DomScan.

[Dodaj do Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[Dodaj do 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)[Dodaj do 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 z kluczem API

Codex

Logowanie w Codex

`codex mcp login domscan`

### Konfiguracja według narzędzia

Każde narzędzie łączy się z tym samym serwerem MCP pod adresem `https://domscan.net/mcp`. Narzędzia obsługujące logowanie otwierają logowanie do DomScan przy pierwszym sprawdzeniu. Pozostałe wysyłają Twój klucz API w nagłówku X-API-Key.

#### Claude Code

Uruchom to w terminalu. Claude Code poprosi o zalogowanie się przy pierwszym użyciu DomScan. Dodaj `--scope user`, aby udostępnić DomScan w każdym projekcie.

Claude Code

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

Claude Code z kluczem API

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

#### Cursor

Użyj przycisku Add to Cursor powyżej lub dodaj ten wpis do `~/.cursor/mcp.json` dla wszystkich projektów albo do `.cursor/mcp.json` dla jednego projektu.

mcp.json

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

#### VS Code

Użyj przycisku Add to VS Code powyżej lub dodaj ten wpis do `.vscode/mcp.json` w swoim obszarze roboczym. VS Code poprosi o zalogowanie się po uruchomieniu serwera.

.vscode/mcp.json

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

#### Codex

Dodaj serwer, a następnie zaloguj się. Aby zamiast tego użyć klucza API, dodaj ten blok do `~/.codex/config.toml` i ustaw `DOMSCAN_API_KEY` w swoim środowisku.

Codex

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

Logowanie w 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

Włącz tryb programisty w ChatGPT w sekcji Settings, Connectors, Advanced. Następnie utwórz connector z tym adresem URL i wybierz OAuth. Instrukcje krok po kroku znajdziesz na stronie: [stronie konfiguracji MCP](https://domscan.net/pl/mcp-domain-checker).

Adres URL serwera MCP

`https://domscan.net/mcp`

#### Claude

W Claude w przeglądarce lub w Claude Desktop otwórz Settings, następnie Connectors, i dodaj własny connector o nazwie DomScan z tym adresem URL. Claude otworzy logowanie do DomScan, aby dokończyć konfigurację.

Adres URL serwera MCP

`https://domscan.net/mcp`

#### Windsurf

Otwórz ustawienia MCP w Windsurf, wyświetl surową konfigurację i dodaj ten wpis do `mcp_config.json`. Zastąp YOUR_API_KEY swoim kluczem.

mcp_config.json

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

Te linki i polecenia nigdy nie zawierają Twojego klucza API. Narzędzia obsługujące logowanie łączą się bezpośrednio z Twoim kontem DomScan. Aby zamiast tego użyć klucza, zastąp `YOUR_API_KEY` kluczem z sekcji [Twoje klucze API](https://domscan.net/pl/api-keys).

### Instrukcje dla agentów kodujących

Wklej to do AGENTS.md, CLAUDE.md lub pliku reguł swojego edytora, aby agenci kodujący poprawnie wywoływali DomScan.

AGENTS.md

```text
## DomScan API

Używaj DomScan (https://domscan.net) do sprawdzania dostępności domen, DNS, WHOIS i RDAP, SSL, bezpieczeństwa poczty e-mail oraz wyceny.

- Bazowy URL: `https://domscan.net`. Endpointy znajdują się pod `/v1`.
- Uwierzytelnianie: wysyłaj `X-API-Key: $DOMSCAN_API_KEY` (lub `Authorization: Bearer $DOMSCAN_API_KEY`). Odczytuj klucz ze zmiennej środowiskowej. Nigdy nie wpisuj go na stałe w kodzie, nie loguj go i nie umieszczaj w URL.
- Kontrakt: przed wyborem endpointu lub parametru przeczytaj opis OpenAPI pod adresem https://domscan.net/v1/openapi.json i nie zgaduj nazw parametrów. Streszczenie witryny dla LLM znajduje się pod adresem https://domscan.net/llms.txt.
- MCP: zdalny serwer to https://domscan.net/mcp (streamable HTTP, logowanie lub te same nagłówki z kluczem API).
- Kredyty: większość endpointów kosztuje kredyty. Przed pracą masową lub powtarzalną wywołaj `POST /v1/estimate` z polami `method`, `path`, `query` i `body` żądania albo dodaj `dry_run=true` do endpointów masowych, porównań, recipe i cen. Oba rozwiązania są bezpłatne. Śledź nagłówki odpowiedzi `X-Credits-Charged` i `X-Credits-Remaining`.
- Masowo: sprawdzaj do 50 pełnych nazw domen jednym żądaniem `POST /v1/status/bulk` zamiast wywoływać pojedyncze sprawdzenia w pętli.
- Ponowienia: wysyłaj nagłówek `Idempotency-Key` (na przykład UUID) w żądaniach POST, które pobierają kredyty. Ponowienie tego samego żądania z tym samym kluczem w ciągu 24 godzin zwraca zapisaną odpowiedź bez ponownego naliczenia opłaty. Ponawiaj tylko wtedy, gdy `error.retryable` ma wartość true, a przy 429 poczekaj zgodnie z `Retry-After`.
- Błędy: każde ciało błędu ma postać `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Rozgałęziaj logikę według `error.code`, na przykład `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` lub `RATE_LIMITED`, a nie według komunikatu.
- Nieznane nie znaczy nieobecne: wyniki zawierają `classification.status` o wartości `present`, `absent` lub `unknown`. Traktuj `unknown` jako "spróbuj ponownie później", nigdy jako dostępne ani brakujące, i nigdy nie traktuj braku jako dowodu, że nazwę można zarejestrować lub zająć.
- Aktualność: endpointy, które mogą odpowiadać na podstawie świeżych danych, przyjmują `max_age` w sekundach (`max_age=0` żąda nowego sprawdzenia) i zwracają `cache_age_s`. Nie zmienia to kosztu.
- Mniejsze odpowiedzi: dodaj `fields=a,b.c` lub `compact=true` do query stringa. Żadne z nich nie zmienia kosztu.
- Więcej: https://domscan.net/AGENTS.md i https://domscan.net/docs.
```

### Prompty do wypróbowania

Skopiuj prompt lub otwórz go w swoim asystencie. Najpierw połącz DomScan, aby asystent mógł uruchamiać sprawdzenia.

1.

Użyj DomScan, aby sprawdzić, czy te 50 nazw jest dostępnych jako domeny .com: [wklej nazwy]. Najpierw oszacuj koszt w kredytach i pokaż mi go, zanim cokolwiek uruchomisz. Następnie wypisz osobno wyniki dostępne, zajęte i nieznane i nie traktuj nieznanych wyników jako dostępnych.

2.

Użyj DomScan, aby sprawdzić bezpieczeństwo poczty e-mail dla example.com: SPF, DKIM, DMARC i status na czarnych listach. Wyjaśnij każdy problem prostym językiem i zaproponuj rekord DNS, który go naprawi.

3.

Rozważam kupno example.com. Użyj DomScan, aby sprawdzić jego WHOIS i daty rejestracji, DNS, certyfikat SSL, reputację i szacowaną wartość, a następnie podsumuj ryzyka i to, co powinienem zweryfikować przed zapłatą.

4.

Użyj DomScan, aby znaleźć już zarejestrowane domeny podobne do example.com oraz domeny typosquattingowe. Uszereguj je według ryzyka i wskaż te, które mają stronę internetową lub serwer pocztowy.

5.

Dodaj DomScan do tego projektu. Przeczytaj https://domscan.net/AGENTS.md i https://domscan.net/v1/openapi.json, a następnie napisz mały typowany klient dla POST /v1/status/bulk, który odczytuje DOMSCAN_API_KEY ze środowiska, wysyła nagłówek Idempotency-Key i oddziela nieznane wyniki od dostępnych. Dodaj testy.

### Zasoby czytelne maszynowo

Kieruj agentów do tych publicznych plików zamiast kopiować dokumentację do promptów.

- [`/AGENTS.md`](https://domscan.net/AGENTS.md) Publiczny przewodnik dla agentów
- [`/llms.txt`](https://domscan.net/llms.txt) Streszczenie witryny dla LLM
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) Stare i nowe nazwy narzędzi MCP