> 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/ja/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サーバーをワンクリックでインストールするか、ターミナルでコマンドを1つ実行してください。ツールが最初にチェックを実行するとき、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ヘッダーでキーを送信します。

#### 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`、1つのプロジェクトだけなら `.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/ja/mcp-domain-checker)にあります。

MCPサーバーURL

`https://domscan.net/mcp`

#### Claude

WebのClaudeまたはClaude Desktopで、設定、コネクタの順に開き、この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/ja/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` を記録してください。
- 一括処理: 単一チェックをループするのではなく、1回の `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に似た、すでに登録されているタイポスクワッティングドメインを探してください。リスク順に並べ、Webサイトやメールサーバーを持つものを指摘してください。

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ツール名と新MCPツール名の対応