domaintrack

domaintrack

domaintrack は、ドメインについて公開されている情報を調べます。 評判のスナップショット、robots.txt で設定されている AI クローラーのポリシー、 およびそれらの回答の基になっているデータソースの一覧を確認できます。

これはデータストアではなく、転送クライアントです。回答は Domduck の公開ストアに保存され、キー不要の公開エンドポイントから提供されます。このパッケージはエンドポイントの 3 つのツールを 提供し、ツール一覧をローカルで返して、各呼び出しを上流に転送し、 上流の回答を受け取ったままの形で返します。アカウントも API キーも不要です。公開エンドポイントが 提供するのはこれだけです。日付付きの履歴データを備えた Domduck の認証済みエンドポイントは別のものであり、ここでは使用しません。 このクライアントはいかなる認証情報も送信しません。

自動化に使う前に知っておくとよい動作が 1 つあります。 まだ誰も調べたことのないドメインを問い合わせても、 エラーにはなりません。スナップショットは hasReading が false に設定された状態で返されます。これは、その名前についての読み取り結果がまだ ストアにないことを、ストアが正直に示しているということです。

ツール

• lookup_domain — 1 つのドメインについて保存されている 評判のスナップショットです。Domain Rating、Tranco ランク、OpenPageRank、 登録日、TLS 証明書の状態、AI クローラーの ポリシーが含まれます。domain が必要です。
• get_ai_crawler_policy — 追跡対象の 8 種類の AI クローラーそれぞれについて、そのドメインの robots.txt が許可しているか、ブロックしているか、 または記載していないかを返します。また、llms.txt が 公開されているかどうかも確認できます。domain が必要です。
• list_sources — ほかの 2 つのツールが参照するソースのカタログと、それぞれの意味を返します。引数はありません。スナップショットの項目が不明な場合は、先にこちらをお読みください。

CLI

npx @reneturcios/domaintrack lookup_domain '{"domain":"example.com"}'
npx @reneturcios/domaintrack get_ai_crawler_policy '{"domain":"example.com"}'
npx @reneturcios/domaintrack list_sources
npx @reneturcios/domaintrack --version

各ツールのサブコマンドは 1 回の呼び出しを転送し、結果の内容を JSON として出力します。 終了コード：成功時は 0、上流の呼び出しがエラー結果を返した場合は 1、使用方法に 関するエラー（不明なサブコマンド、形式不正な JSON 引数）の場合は 2 です。

MCP サーバー

npx @reneturcios/domaintrack mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "domaintrack": {
      "command": "npx",
      "args": ["-y", "@reneturcios/domaintrack", "mcp"]
    }
  }
}

サーバーは tools/list に自ら応答し、すべての tools/call を Streamable HTTP セッション経由で公開エンドポイントに転送します（initialize、続いて notifications/initialized、その後に呼び出し）。 セッションを再利用し、エンドポイントが Mcp-Session-Id を発行した場合はそれも、プロセスの終了まで再利用します。

通信上の失敗は、このパッケージ独自の文言で報告されます。テキスト結果は domaintrack error: で始まり、 上流からの JSON-RPC エラー、2xx 以外の HTTP ステータス、解析できないレスポンス本文、 リクエストの失敗は、いずれもこのプレフィックスに続けて詳細を示します。

Docker

docker run -i ghcr.io/cloudcorprecords/domaintrack            # stdio MCP server
docker run --rm ghcr.io/cloudcorprecords/domaintrack lookup_domain '{"domain":"example.com"}'

設定

• DOMDUCK_MCP_URL — 上流エンドポイントを上書きします。デフォルトは https://domduck.com/api/mcp/public です。（この 上書きは、こちら側で再構成したものです。エンドポイント自体は、固定された公開エンドポイントです。）

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner via tsx; stubbed upstream, no network
npm run dev     # run the CLI from source

ライセンス

MIT — LICENSE を参照してください。