Shodan Internetdb

Shodan InternetDB — IP のホスト名とサービスのインテリジェンス

Shodan の無料 InternetDB API です。任意の IP を検索すると、開いているポート、検出されたサービス、ホスト名、脆弱性、タグ（CDN、クラウド、ICS など）が得られます。「この IP では実際に何が動いているのか？」を知るためのデータで、Shodan が継続的にインターネットをスキャンして収集しています。無料で、認証も不要です。

Pipeworx の一部です。AI エージェントを 1683 以上の稼働中のデータソースに接続する MCP ゲートウェイです。

AI エージェントにとって重要な理由

セキュリティ分析、攻撃対象領域の偵察（自社の資産に限ります）、脅威ハンティングのコンテキストにおいて、Shodan のデータは信頼できる基準です。InternetDB は無料で軽量なサブセットです。Shodan の全機能（検索、履歴、アラート）を利用するには、有料の Shodan API が必要です。

一般的な利用例：

• IP の検索。「1.2.3.4 では何が動いていますか？」→ 開いているポート、サービス、脆弱性。
• 攻撃前の偵察（防御目的）。 自社のインフラが外部からどのように見えるかを監査します。
• 脅威インテリジェンスとの併用。 AbuseIPDB（レピュテーション）、PhishTank / URLhaus（URL の脅威）と照合します。

認証

不要です。InternetDB は無料で、キーも登録も不要です。レート制限にも余裕があります。

Shodan の全検索 API（過去のスキャン、詳細検索、リアルタイムアラート）を利用するには、Shodan のメンバーシップが必要です（ホビイスト向けプランで年間約 59 ドル）。InternetDB では静的スナップショットのサブセットを利用できます。

InternetDB が返す情報

照会した IP について：

{
  "ip": "1.2.3.4",
  "hostnames": ["example.com"],
  "ports": [22, 80, 443],
  "vulns": ["CVE-2021-44228"],
  "tags": ["cdn", "cloud"]
}

フィールド	意味
ports	Shodan のスキャナーが検出した開いているポート
vulns	検出されたサービスバナーに基づき、脆弱な可能性が高いと Shodan のヒューリスティクスが判定した CVE ID
hostnames	逆引き DNS またはホスト自身が報告したホスト名
tags	分類タグ（cdn、cloud、ics、vpn、tor など）
cpes	（一部のレスポンスに含まれる）検出されたソフトウェアのフィンガープリント

よくある落とし穴

• リアルタイムではなく、スナップショットです。 InternetDB のデータは数日から数週間古い場合があります。前回のスキャン以降に、その IP でポートが閉じられている可能性があります。「現在の状態」を確認するには、自社の資産をライブスキャンする必要があります。
• 脆弱性の判定はヒューリスティックです。 Shodan はサービスバナーとの照合に基づいて vulns を判定します。たとえば、nginx 1.18.0 → CVE-2021-23017 です。実際のインスタンスにはパッチが適用済みの可能性があります（パッチ適用後も、バナーに古いバージョン文字列が残ることがよくあります）。vulns だけを根拠に行動せず、必ず直接確認してください。
• CDN／プロキシの IP。 Cloudflare、Akamai、AWS CloudFront の IP は、多数のサイトを中継しているため、膨大なポート情報が表示されます。このデータは特定のウェブサイトのものではなく、プロキシインフラのものです。
• Tor の出口ノード。 InternetDB では tor タグが付けられます。レピュテーションシステムがこれらをブラックリストに登録することがありますが、プライバシーを重視する正規のユーザーも利用しています。
• 対象範囲の不足。 すべての IP がスキャンされるわけではありません。NAT 配下、IPv6、動的に割り当てられた IP には、Shodan の記録がない場合があります。
• 攻撃に使用しないでください。 Shodan のデータは、防御目的の偵察と調査のためのものです。所有していない脆弱なシステムを特定して攻撃することは違法であり、Shodan の利用規約にも違反します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "shodan-internetdb": {
      "url": "https://gateway.pipeworx.io/shodan-internetdb/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/shodan-internetdb/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントでは現在、パック独自のツールとあわせて約 30 個の共有ツールが一覧表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の状況についてはこれが正式な情報です。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックで扱わない質問にも、カタログ全体を検索する ask_pipeworx 経由で回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマがもたらすコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1683+ のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/shodan_internetdb_lookup_ip \
  -H 'Content-Type: application/json' \
  -d '{"ip":"8.8.8.8"}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/shodan_internetdb_lookup_ip を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

{
  "mcpServers": {
    "shodan-internetdb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-shodan-internetdb"]
    }
  }
}

また、起動することを確認するには、直接実行します。

npx -y @pipeworx/mcp-shodan-internetdb

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Shodan Internetdb data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT