Repolode
projectdiscovery

projectdiscovery/uncover

複数のインターネット検索エンジンを照会し、他のツールにパイプできる形式で公開ホストを探すGo製CLI。

代替できる製品:Shodan

スター
3,086
フォーク
280
未解決の Issue
13
最終コミット
6 日前

これは何?

uncoverは、Shodan、Censys、FOFA、Hunter、Quake、ZoomEye、Netlas、Criminal IP、Googleなど、複数のインターネット検索エンジンのAPIを利用するGo製ラッパーです。各エンジン独自の構文でクエリを指定すると、一致するIPとポートの組み合わせ、ホスト名、または任意の形式で整形した行を返します。

自動化を前提に設計されています。入力元にはstdin、クエリを記載したファイル、または設定ファイルを指定でき、出力形式はプレーンテキスト、JSONL、またはAPIレスポンスそのものから選べます。結果はnaabu、httpx、nucleiなどのツールにそのままパイプできます。プロバイダーごとに複数のAPIキーを登録でき、実行ごとにランダムなキーが選ばれます。レート制限やリトライも設定可能です。

Goライブラリとしてインポートして使うこともできます。Shodan InternetDBはAPIキーなしで利用でき、IPまたはCIDRを入力すると、デフォルトでこれを使って開いているポートを一覧表示します。

主な機能

  • 01複数の検索エンジンを一度の実行で照会できます。
  • 02Shodan、Censys、FOFA、ZoomEye、Quake、Hunter、Netlasなど、約10種類の検索エンジンに対応しています。
  • 03stdin、ファイル、設定ファイルからクエリを読み込み、結果をstdoutまたはファイルに出力できます。
  • 04プロバイダーごとに登録した複数のAPIキーをランダムに切り替えて使えます。
  • 05プレーンテキスト、JSONL、APIレスポンスそのものを出力でき、出力フィールド(ip、port、host)も選択できます。
  • 06Goライブラリとして利用できます。

ユースケース

  • バグバウンティやペネトレーションテストにおけるアタックサーフェスの把握と偵察。
  • セキュリティ調査のため、特定の製品がインターネット上で公開されているインスタンスを探す。
  • 発見したホストをポートスキャナーやWeb調査ツールに渡す、自動化パイプラインの構築。

クイックスタート

  1. 1

    Go(go1.21 が必要)を使って uncover をインストールします

    go install -v github.com/projectdiscovery/uncover/cmd/uncover@latest
  2. 2

    provider config file で、使用する検索エンジンの API キーを設定します

  3. 3

    デフォルトの Shodan エンジンで検索クエリを実行します

    echo 'ssl:"Uber Technologies, Inc."' | uncover

使う前に知っておきたいこと

  • 検索エンジンの API キーが必要です。そのほとんどはサインアップが必要です。
  • ソースからインストールするには、Go 1.21 以降が必要です。

トピック

よくある質問

uncover とは?
複数のインターネット検索エンジンを照会し、他のツールにパイプできる形式で公開ホストを探すGo製CLI。 uncoverは、Shodan、Censys、FOFA、Hunter、Quake、ZoomEye、Netlas、Criminal IP、Googleなど、複数のインターネット検索エンジンのAPIを利用するGo製ラッパーです。各エンジン独自の構文でクエリを指定すると、一致するIPとポートの組み合わせ、ホスト名、または任意の形式で整形した行を返します。
uncover は無料で使えますか?ライセンスは?
uncover は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
uncover は今もメンテナンスされていますか?
活発にメンテナンス中。uncover の最終コミットは 2026年10月13日 です。
uncover は何に使えますか?
バグバウンティやペネトレーションテストにおけるアタックサーフェスの把握と偵察。 セキュリティ調査のため、特定の製品がインターネット上で公開されているインスタンスを探す。 発見したホストをポートスキャナーやWeb調査ツールに渡す、自動化パイプラインの構築。
uncover のインストール方法は?
Go(go1.21 が必要)を使って uncover をインストールします: go install -v github.com/projectdiscovery/uncover/cmd/uncover@latest provider config file で、使用する検索エンジンの API キーを設定します デフォルトの Shodan エンジンで検索クエリを実行します: echo 'ssl:"Uber Technologies, Inc."' | uncover
uncover はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/projectdiscovery/uncover

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト