sherlock - 🔎 ソーシャル ネットワーク全体でユーザー名からソーシャル メディア アカウントを探し出す

(🔎 Hunt down social media accounts by username across social networks)

Created at: 2018-12-24 22:30:48
Language: Python
License: MIT


ソーシャル ネットワーク全体でユーザー名でソーシャル メディア アカウントを探し出す
Webサイト ドッカー イメージ

インストール    |    使い方    |    Docker に関する注意事項    |    貢献する

インストール

# clone the repo
$ git clone https://github.com/sherlock-project/sherlock.git

# change the working directory to sherlock
$ cd sherlock

# install the requirements
$ python3 -m pip install -r requirements.txt

使用法

$ python3 sherlock --help
usage: sherlock [-h] [--version] [--verbose] [--folderoutput FOLDEROUTPUT]
                [--output OUTPUT] [--tor] [--unique-tor] [--csv]
                [--site SITE_NAME] [--proxy PROXY_URL] [--json JSON_FILE]
                [--timeout TIMEOUT] [--print-all] [--print-found] [--no-color]
                [--browse] [--local]
                USERNAMES [USERNAMES ...]

Sherlock: Find Usernames Across Social Networks (Version 0.14.0)

positional arguments:
  USERNAMES             One or more usernames to check with social networks.

optional arguments:
  -h, --help            show this help message and exit
  --version             Display version information and dependencies.
  --verbose, -v, -d, --debug
                        Display extra debugging information and metrics.
  --folderoutput FOLDEROUTPUT, -fo FOLDEROUTPUT
                        If using multiple usernames, the output of the results
                        will be saved to this folder.
  --output OUTPUT, -o OUTPUT
                        If using single username, the output of the result
                        will be saved to this file.
  --tor, -t             Make requests over Tor; increases runtime; requires
                        Tor to be installed and in system path.
  --unique-tor, -u      Make requests over Tor with new Tor circuit after each
                        request; increases runtime; requires Tor to be
                        installed and in system path.
  --csv                 Create Comma-Separated Values (CSV) File.
  --site SITE_NAME      Limit analysis to just the listed sites. Add multiple
                        options to specify more than one site.
  --proxy PROXY_URL, -p PROXY_URL
                        Make requests over a proxy. e.g.
                        socks5://127.0.0.1:1080
  --json JSON_FILE, -j JSON_FILE
                        Load data from a JSON file or an online, valid, JSON
                        file.
  --timeout TIMEOUT     Time (in seconds) to wait for response to requests.
                        Default timeout is infinity. A longer timeout will be
                        more likely to get results from slow sites. On the
                        other hand, this may cause a long delay to gather all
                        results.
  --print-all           Output sites where the username was not found.
  --print-found         Output sites where the username was found.
  --no-color            Don't color terminal output
  --browse, -b          Browse to all results on default browser.
  --local, -l           Force the use of the local data.json file.

1 人のユーザーのみを検索するには:

python3 sherlock user123

複数のユーザーを検索するには:

python3 sherlock user1 user2 user3

見つかったアカウントは、対応するユーザー名 (例: ) とともに個別のテキスト ファイルに保存されます

user123.txt
。

アナコンダ (Windows) に関する注意事項

Windows で Anaconda を使用している場合、'python3' を使用しても機能しない可能性があります。代わりに「python」を使用してください。

Docker に関する注意事項

docker がインストールされている場合は、イメージをビルドしてコンテナーとして実行できます。

docker build -t mysherlock-image .

イメージがビルドされたら、次のコマンドを実行して sherlock を呼び出すことができます。

docker run --rm -t mysherlock-image user123

オプションの

--rm
フラグは、不完全なビルドアップを防ぐために、完了時にコンテナー ファイルシステムを削除します。参照: https://docs.docker.com/engine/reference/run/#clean-up---rm

オプションの

-t
フラグは、カラー出力を可能にする疑似 TTY を割り当てます。参照: https://docs.docker.com/engine/reference/run/#foreground

次のコマンドを使用して、保存された結果にアクセスします。

docker run --rm -t -v "$PWD/results:/opt/sherlock/results" mysherlock-image -o /opt/sherlock/results/text.txt user123

オプションは、現在の作業ディレクトリに

-v "$PWD/results:/opt/sherlock/results"
フォルダーを作成 (または使用)し、docker コンテナーにマウントするよう docker に指示します。オプションは、結果を出力するように指示します。
results
/opt/sherlock/results
-o /opt/sherlock/results/text.txt
sherlock

または、「Docker Hub」を使用して実行できます

sherlock
。

docker run theyahya/sherlock user123

使用する
docker-compose

docker-compose.yml
リポジトリのファイルを使用して、次のコマンドを使用できます。

docker-compose run sherlock -o /opt/sherlock/results/text.txt user123

貢献する

Sherlock の開発にご協力いただければ幸いです。一人一人の貢献は非常に高く評価されています!

以下の点について、ご協力をお願いいたします。

  • 新しいサイト サポートの追加¹
  • 誤検知により過去に削除されたサイトのサポートを復活させる

[1]問題を理解するには、新しいサイトの追加に関する Wiki エントリを参照してください。

テスト

シャーロックに貢献してくれてありがとう!

新しい開発でプル リクエストを作成する前に、テストを実行して、すべてがうまく機能していることを確認してください。また、開発を開始する前にテストを実行して、環境と Sherlock ソフトウェアの問題を区別することもお勧めします。

以下は、Sherlock のすべてのテストを実行するコマンド ラインの例です。この呼び出しにより、Sherlock が通常出力する進行状況テキストが非表示になり、代わりにテストの詳細な出力が表示されます。

$ cd sherlock/sherlock
$ python3 -m unittest tests.all --verbose

現在、100% のテスト カバレッジがあることに注意してください。残念ながら、Sherlock がチェックするサイトの一部は常に信頼できるとは限らないため、応答の問題が発生することがよくあります。接続の問題は、真のエラーではなく、テストで警告として表示されます。

接続の問題 (サイトがダウンしている、メンテナンス中など) が原因で一部のサイトが失敗している場合は、

tests/.excluded_sites
無視するサイトのリスト (1 行に 1 つのサイト名) を含むファイルを作成して、それらのサイトをテストから除外できます。

時間の経過とともにスターゲイザー

時間の経過とともにスターゲイザー

ライセンス

MIT © Sherlock Projectオリ​​ジナル
作成者 -シッダールス・ドゥシャンタ