AIエージェントでDomScanを使う

AIエージェントでDomScanを使う

MCP経由でDomScanをClaude、ChatGPT、Cursor、VS Code、Codex、Windsurfに接続し、コーディングエージェントに必要なAPIルールを渡して、用意されたプロンプトからすぐに始められます。

MCPとREST API、どちらを使う?

多くのチームは両方を使っています。チャットやエディタでの調査とプロトタイプ作成にはMCP、エージェントが書くコードにはREST APIです。どちらも同じAPIキーとクレジット残高を使います。

お使いのAIツールに接続

ツール別セットアップ

どのツールも https://domscan.net/mcp にある同じMCPサーバーに接続します。サインインに対応したツールは、最初のチェック実行時にDomScanのログイン画面を開きます。それ以外のツールは、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"
      }
    }
  }
}

これらのリンクとコマンドにAPIキーは含まれません。サインインに対応したツールは、DomScanアカウントに直接接続します。代わりにキーを使う場合は、YOUR_API_KEY をお使いのAPIキーのキーに置き換えてください。

コーディングエージェント向けの指示

コーディングエージェントがDomScanを正しく呼び出せるように、AGENTS.md、CLAUDE.md、またはエディタのルールファイルに貼り付けてください。

## 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ドメインとして取得可能か確認してください: [名前を貼り付け]。まず、実行する前にクレジットコストを見積もって提示してください。その後、取得可能、取得済み、不明の結果を別々に一覧にし、不明の結果を取得可能として扱わないでください。

   Claudeで開くChatGPTで開くCursorで開く

2. DomScanを使って、example.comのメールセキュリティを監査してください。SPF、DKIM、DMARC、ブラックリストの状態を対象にします。各問題を平易な言葉で説明し、それを修正するDNSレコードを提案してください。

   Claudeで開くChatGPTで開くCursorで開く

3. example.comの購入を検討しています。DomScanを使って、WHOISと登録日、DNS、SSL証明書、評判、推定価値を確認し、リスクと支払い前に確認すべき点をまとめてください。

   Claudeで開くChatGPTで開くCursorで開く

4. DomScanを使って、example.comに似た、すでに登録されているタイポスクワッティングドメインを探してください。リスク順に並べ、Webサイトやメールサーバーを持つものを指摘してください。

   Claudeで開くChatGPTで開くCursorで開く

5. このプロジェクトにDomScanを追加してください。https://domscan.net/AGENTS.md と https://domscan.net/v1/openapi.json を読み、POST /v1/status/bulk 用の小さな型付きクライアントを書いてください。環境から DOMSCAN_API_KEY を読み取り、Idempotency-Key ヘッダーを送信し、不明の結果を取得可能な結果と分けて扱うようにします。テストも追加してください。

   Claudeで開くChatGPTで開くCursorで開く

機械可読リソース

ドキュメントをプロンプトにコピーする代わりに、これらの公開ファイルをエージェントに参照させてください。

• /AGENTS.md 公開エージェントガイド
• /llms.txt LLM向けのサイト概要
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json 旧MCPツール名と新MCPツール名の対応