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

# AI 에이전트에서 DomScan 사용하기

AI 에이전트에서 DomScan 사용하기 API 문서에서 요청 매개변수, 응답 필드, 코드 예제, DomScan 통합을 위한 오류 처리를 확인하세요.

MCP로 DomScan을 Claude, ChatGPT, Cursor, VS Code, Codex, Windsurf에 연결하고, 코딩 에이전트에 필요한 API 규칙을 제공하며, 준비된 프롬프트로 바로 시작하세요.

### MCP와 REST API 중 무엇을 쓸까요?

#### 어시스턴트가 판단할 때는 MCP

대화 중에 어시스턴트가 어떤 검사를 실행할지 직접 고르는 경우 MCP 서버를 연결하세요. 어시스턴트가 DomScan 도구를 스스로 찾고, 계정 또는 API 키로 로그인하며, API와 동일한 분류, 크레딧 비용, 오류 코드를 가진 구조화된 결과를 받습니다.

#### 코드가 판단할 때는 REST

어시스턴트 없이 실행되는 코드에서는 REST API를 호출하세요. 예약 작업, 대량 처리 파이프라인, 백엔드, CI 검사 등이 해당합니다. 코딩 에이전트가 제품에 배포될 코드를 작성할 때는 OpenAPI 설명을 기준으로 REST API를 호출하게 하세요.

많은 팀이 둘 다 사용합니다. 채팅이나 에디터에서 탐색하고 프로토타입을 만들 때는 MCP를, 에이전트가 작성하는 코드에서는 REST API를 씁니다. 둘 다 같은 API 키와 크레딧 잔액을 사용합니다.

### 사용 중인 AI 도구에 연결

DomScan MCP 서버를 한 번의 클릭으로 설치하거나 터미널에서 명령 하나를 실행하세요. 도구가 처음 검사를 실행할 때 DomScan 로그인을 요청합니다.

[Cursor에 추가](cursor://anysphere.cursor-deeplink/mcp/install?name=domscan&config=eyJ1cmwiOiJodHRwczovL2RvbXNjYW4ubmV0L21jcCJ9)[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)[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 (API 키 사용)

Codex

Codex 로그인

`codex mcp login domscan`

### 도구별 설정

모든 도구는 `https://domscan.net/mcp`의 동일한 MCP 서버에 연결됩니다. 로그인을 지원하는 도구는 처음 검사를 실행할 때 DomScan 로그인 창을 엽니다. 나머지 도구는 X-API-Key 헤더로 API 키를 전송합니다.

#### Claude Code

터미널에서 다음 명령을 실행하세요. Claude Code는 DomScan을 처음 사용할 때 로그인을 요청합니다. 모든 프로젝트에서 DomScan을 사용하려면 `--scope user`를 추가하세요.

Claude Code

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

Claude Code (API 키 사용)

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

#### Cursor

위의 Add to Cursor 버튼을 사용하거나, 모든 프로젝트에 적용하려면 `~/.cursor/mcp.json`에, 한 프로젝트에만 적용하려면 `.cursor/mcp.json`에 다음 항목을 추가하세요.

mcp.json

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

#### VS Code

위의 Add to VS Code 버튼을 사용하거나, 워크스페이스의 `.vscode/mcp.json`에 다음 항목을 추가하세요. 서버가 시작될 때 VS Code가 로그인을 요청합니다.

.vscode/mcp.json

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

#### Codex

서버를 추가한 다음 로그인하세요. 대신 API 키를 사용하려면 `~/.codex/config.toml`에 다음 블록을 추가하고 환경에 `DOMSCAN_API_KEY`를 설정하세요.

Codex

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

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

ChatGPT의 설정, 커넥터, 고급에서 개발자 모드를 켜세요. 그런 다음 이 URL로 커넥터를 만들고 OAuth를 선택합니다. 단계별 안내는 [MCP 설정 페이지](https://domscan.net/ko/mcp-domain-checker)에 있습니다.

MCP 서버 URL

`https://domscan.net/mcp`

#### Claude

웹 또는 Claude Desktop의 Claude에서 설정, 커넥터를 차례로 열고, 이 URL로 DomScan이라는 이름의 커스텀 커넥터를 추가하세요. Claude가 DomScan 로그인 창을 열어 설정을 마무리합니다.

MCP 서버 URL

`https://domscan.net/mcp`

#### Windsurf

Windsurf에서 MCP 설정을 열고 원본 구성을 표시한 다음, `mcp_config.json`에 다음 항목을 추가하세요. YOUR_API_KEY를 내 키로 바꾸세요.

mcp_config.json

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

이 링크와 명령에는 API 키가 포함되지 않습니다. 로그인을 지원하는 도구는 DomScan 계정에 직접 연결됩니다. 대신 키를 사용하려면 `YOUR_API_KEY`을(를) [내 API 키](https://domscan.net/ko/api-keys)의 키로 바꾸세요.

### 코딩 에이전트용 지침

코딩 에이전트가 DomScan을 올바르게 호출하도록 AGENTS.md, CLAUDE.md 또는 에디터 규칙 파일에 붙여 넣으세요.

AGENTS.md

```text
## DomScan API

도메인 사용 가능 여부, DNS, WHOIS 및 RDAP, SSL, 이메일 보안, 가치 평가 검사에는 DomScan (https://domscan.net)을 사용합니다.

- 기본 URL: `https://domscan.net`. 엔드포인트는 `/v1` 아래에 있습니다.
- 인증: `X-API-Key: $DOMSCAN_API_KEY`(또는 `Authorization: Bearer $DOMSCAN_API_KEY`)를 보냅니다. 키는 환경 변수에서 읽습니다. 코드에 직접 넣거나, 로그에 남기거나, URL에 포함하지 마세요.
- 계약: 엔드포인트나 파라미터를 고르기 전에 https://domscan.net/v1/openapi.json 의 OpenAPI 설명을 읽고, 파라미터 이름을 추측하지 마세요. LLM용 사이트 요약은 https://domscan.net/llms.txt 에 있습니다.
- MCP: 원격 서버는 https://domscan.net/mcp 입니다(스트리밍 가능한 HTTP, 로그인 또는 동일한 API 키 헤더).
- 크레딧: 대부분의 엔드포인트는 크레딧을 사용합니다. 대량 작업이나 반복 작업 전에 요청의 `method`, `path`, `query`, `body`와 함께 `POST /v1/estimate`를 호출하거나, bulk, compare, recipe, pricing 엔드포인트에 `dry_run=true`를 추가하세요. 둘 다 무료입니다. 응답 헤더 `X-Credits-Charged`와 `X-Credits-Remaining`을 추적하세요.
- 대량 처리: 단일 검사를 반복하는 대신, `POST /v1/status/bulk` 요청 한 번으로 최대 50개의 전체 도메인 이름을 검사하세요.
- 재시도: 크레딧이 차감되는 POST 요청에는 `Idempotency-Key` 헤더(예: UUID)를 보내세요. 24시간 이내에 같은 키로 같은 요청을 다시 보내면 다시 차감하지 않고 저장된 응답을 반환합니다. `error.retryable`이 true일 때만 재시도하고, 429에서는 `Retry-After`만큼 기다리세요.
- 오류: 모든 오류 본문은 `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}` 형식입니다. 메시지가 아니라 `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS`, `RATE_LIMITED` 같은 `error.code`로 분기하세요.
- 알 수 없음은 없음이 아닙니다: 결과에는 `present`, `absent`, `unknown` 중 하나인 `classification.status`가 포함됩니다. `unknown`은 "나중에 다시 시도"로 처리하고, 사용 가능하다거나 없다고 간주하지 마세요. 또한 부재를 그 이름을 등록하거나 선점할 수 있다는 증거로 취급하지 마세요.
- 최신성: 최근 데이터로 응답할 수 있는 엔드포인트는 초 단위의 `max_age`를 받으며(`max_age=0`은 새로운 검사를 요청), `cache_age_s`를 반환합니다. 비용은 달라지지 않습니다.
- 더 작은 응답: 쿼리 문자열에 `fields=a,b.c` 또는 `compact=true`를 추가하세요. 둘 다 비용은 달라지지 않습니다.
- 더 보기: https://domscan.net/AGENTS.md 및 https://domscan.net/docs.
```

### 시도해 볼 프롬프트

프롬프트를 복사하거나 어시스턴트에서 바로 여세요. 어시스턴트가 검사를 실행할 수 있도록 먼저 DomScan을 연결하세요.

1.

DomScan을 사용해서 다음 50개 이름을 .com 도메인으로 등록할 수 있는지 확인해 주세요: [이름 붙여넣기]. 아무것도 실행하기 전에 먼저 크레딧 비용을 추정해서 보여 주세요. 그런 다음 사용 가능, 이미 등록됨, 알 수 없음 결과를 따로 나열하고, 알 수 없음 결과를 사용 가능으로 취급하지 마세요.

2.

DomScan을 사용해서 example.com의 이메일 보안을 점검해 주세요. SPF, DKIM, DMARC, 블랙리스트 상태를 확인하고, 각 문제를 쉬운 말로 설명한 다음 이를 해결할 DNS 레코드를 제안해 주세요.

3.

example.com 구매를 고려하고 있습니다. DomScan을 사용해서 WHOIS와 등록일, DNS, SSL 인증서, 평판, 추정 가치를 확인하고, 위험 요소와 결제 전에 확인해야 할 사항을 요약해 주세요.

4.

DomScan을 사용해서 example.com과 비슷하게 보이는 이미 등록된 타이포스쿼팅 도메인을 찾아 주세요. 위험도 순으로 정렬하고, 웹사이트나 메일 서버가 있는 도메인을 알려 주세요.

5.

이 프로젝트에 DomScan을 추가해 주세요. https://domscan.net/AGENTS.md 와 https://domscan.net/v1/openapi.json 을 읽고, POST /v1/status/bulk용 작은 타입 클라이언트를 작성해 주세요. 환경에서 DOMSCAN_API_KEY를 읽고, Idempotency-Key 헤더를 보내며, 알 수 없음 결과를 사용 가능 결과와 분리해서 다루어야 합니다. 테스트도 추가해 주세요.

### 기계 판독용 리소스

문서를 프롬프트에 복사하는 대신, 에이전트가 이 공개 파일을 참조하도록 하세요.

- [`/AGENTS.md`](https://domscan.net/AGENTS.md) 공개 에이전트 가이드
- [`/llms.txt`](https://domscan.net/llms.txt) LLM용 사이트 요약
- [`/v1/openapi.json`](https://domscan.net/v1/openapi.json) OpenAPI 3.0
- [`/mcp/tool-mapping.json`](https://domscan.net/mcp/tool-mapping.json) 이전 및 새 MCP 도구 이름 대응표