このリポジトリはアーカイブされ、メンテナンスされていません。
2026年7月から8月にかけて、Google は検索結果の返し方を変更し、pagodo が利用している yagooglesearch ライブラリが信頼できなくなりました。yagooglesearch の基となったライブラリ googlesearch は、2026年2月13日にアーカイブされました。そのイシュートラッカーにも、検索結果が表示されなくなった問題が記録されています。
その結果、このリポジトリは2026年11月1日にアーカイブされ、メンテナンスされていません。
背景情報:
pagodo は、インターネット上に存在する潜在的に脆弱な Web ページやアプリケーションを対象とした Google 検索を自動化します。Web GUI ブラウザで手動で行っていた Google dork 検索を置き換えるものです。
構成は2つの部分からなります。1つ目は最新の Google dork を取得する ghdb_scraper.py、2つ目は ghdb_scraper.py が収集した情報を活用する pagodo.py です。
コアとなる Google 検索ライブラリは、googlesearch の代わりに、より柔軟な yagooglesearch を使用するようになりました。ライブラリの違いと機能についてより詳しい説明は、yagooglesearch の README を参照してください。
このバージョンの pagodo はネイティブの HTTP(S) および SOCKS5 アプリケーションサポートも備えているため、プロキシサポートが必要な場合でも proxychains4 のようなツールでラップする必要はありません。-p スイッチでカンマ区切りのプロキシ文字列を指定することで、複数のプロキシをラウンドロビン方式で使用できます。
Offensive Security は、Google Hacking Database (GHDB) を https://www.exploit-db.com/google-hacking-database で維持しています。これは dork と呼ばれる Google 検索のコレクションであり、Google の検索ボットに拾われる潜在的に脆弱なマシンやその他の有用な情報を見つけるために使用できます。
pagodo の利用規約は、yagooglesearch に記載されている利用規約と同じです。
このコードは現状のまま提供され、その使用方法についてはすべて利用者の責任となります。Google 検索結果のスクレイピングは、Google の利用規約に違反する可能性があります。別の Python 製 Google 検索ライブラリには、これに関する興味深い情報や議論がありました:
Google が推奨する方法は、彼らの API を使用することです。
スクリプトは Python 3.6+ 向けに書かれています。git リポジトリをクローンし、依存関係をインストールしてください。
git clone https://github.com/opsdisk/pagodo.git
cd pagodo
python3 -m venv .venv # If using a virtual environment.
source .venv/bin/activate # If using a virtual environment.
pip install --upgrade pip setuptools
pip install -r requirements.txt
まず最初に、pagodo.py は現在のすべての Google dork のリストを必要とします。リポジトリには、ghdb_scraper.py が最後に実行された時点の dork を含む dorks/ ディレクトリがあります。pagodo.py を実行する前に、最新のデータを取得するために ghdb_scraper.py を実行することをお勧めします。dorks/ ディレクトリには以下が含まれます:
all_google_dorks.txt ファイルall_google_dorks.json ファイルDork カテゴリ:
categories = {
1: "Footholds",
2: "File Containing Usernames",
3: "Sensitives Directories",
4: "Web Server Detection",
5: "Vulnerable Files",
6: "Vulnerable Servers",
7: "Error Messages",
8: "File Containing Juicy Info",
9: "File Containing Passwords",
10: "Sensitive Online Shopping Info",
11: "Network or Vulnerability Data",
12: "Pages Containing Login Portals",
13: "Various Online devices",
14: "Advisories and Vulnerabilities",
}
すべての dork を all_google_dorks.txt、all_google_dorks.json に書き出し、各 dork に関するより詳細な文脈情報が必要な場合は個別のカテゴリにも書き出します。
python ghdb_scraper.py -s -j -i
ghdb_scraper.retrieve_google_dorks() 関数は、以下のデータ構造を持つ辞書を返します:
ghdb_dict = {
"total_dorks": total_dorks,
"extracted_dorks": extracted_dorks,
"category_dict": category_dict,
}
Python シェル(python や ipython など)を使ってデータを探索する:
import ghdb_scraper
dorks = ghdb_scraper.retrieve_google_dorks(save_all_dorks_to_file=True)
dorks.keys()
dorks["total_dorks"]
dorks["extracted_dorks"]
dorks["category_dict"].keys()
dorks["category_dict"][1]["category_name"]
python pagodo.py -d example.com -g dorks.txt
pagodo.Pagodo.go() 関数は、以下のデータ構造を持つ辞書を返します(使用されている dork は架空の例です):
{
"dorks": {
"inurl:admin": {
"urls_size": 3,
"urls": [
"https://github.com/marmelab/ng-admin",
"https://github.com/settings/admin",
"https://github.com/akveo/ngx-admin",
],
},
"inurl:gist": {
"urls_size": 3,
"urls": [
"https://gist.github.com/",
"https://gist.github.com/index",
"https://github.com/defunkt/gist",
],
},
},
"initiation_timestamp": "2021-08-27T11:35:30.638705",
"completion_timestamp": "2021-08-27T11:36:42.349035",
}
Python シェル(python や ipython など)を使ってデータを探索する:
import pagodo
pg = pagodo.Pagodo(
google_dorks_file="dorks.txt",
domain="github.com",
max_search_result_urls_to_return_per_dork=3,
save_pagodo_results_to_json_file=None, # None = Auto-generate file name, otherwise pass a string for path and filename.
save_urls_to_file=None, # None = Auto-generate file name, otherwise pass a string for path and filename.
verbosity=5,
)
pagodo_results_dict = pg.go()
pagodo_results_dict.keys()
pagodo_results_dict["initiation_timestamp"]
pagodo_results_dict["completion_timestamp"]
for key,value in pagodo_results_dict["dorks"].items():
print(f"dork: {key}")
for url in value["urls"]:
print(url)
-d スイッチは、結果を特定のドメインにスコープするために使用でき、Google 検索演算子として機能します:
site:github.com
-i - dork検索間の最小遅延を秒単位で指定します。小さすぎる値にすると、IPがすぐにHTTP 429を返されるようになります。-x - dork検索間の最大遅延を秒単位で指定します。大きすぎる値にすると、検索に長い時間がかかります。-i と -x で指定した値は、20個のランダムな待機時間のリストを生成するために使用され、それぞれ異なるGoogle dork検索の間にランダムに選択されます。
-m - Google dorkごとに返される検索結果の最大合計数。各Google検索リクエストは一度に最大100件の結果しか取得できないため、-m 500 を指定すると、Google dork検索ごとに5回の個別の検索クエリを実行する必要があり、完了までの時間が増加します。
-o [optional/path/to/results.json] - 出力をJSONファイルに保存します。ファイル名を指定しない場合は、日時スタンプ付きのファイル名が生成されます。
-s [optional/path/to/results.txt] - URLをテキストファイルに保存します。ファイル名を指定しない場合は、日時スタンプ付きのファイル名が生成されます。
--log [optional/path/to/file.log] - ログを指定したファイルに保存します。ファイル名を指定しない場合は、pagodoディレクトリのルートにあるデフォルトファイル pagodo.py.log が使用されます。
Googleに対して7300件以上の検索リクエストを可能な限り高速で実行しても、単純にうまくいきません。Googleはそれをボットとして正当に検出し、一定期間IPをブロックします。解決策の一つは、HTTP(S)/SOCKSプロキシのプールを使用し、それらを pagodo に渡すことです。
-p スイッチを使用して、カンマ区切りのプロキシ文字列を pagodo に渡します。
python pagodo.py -g dorks.txt -p http://myproxy:8080,socks5h://127.0.0.1:9050,socks5h://127.0.0.1:9051
-i と -x の値をさらに小さくすることもできます。異なるプロキシ IP を活用することになるからです。pagodo に渡されるプロキシはラウンドロビン方式で選択されます。
もう一つの解決策は、proxychains4 を使ってルックアップをラウンドロビンすることです。
proxychains4 をインストールします
apt install proxychains4 -y
/etc/proxychains4.conf 設定ファイルを編集し、異なるプロキシサーバーを介してルックアップをラウンドロビン方式で行うようにします。以下の例では、異なるローカルリスニングポート(9050 と 9051)を持つ 2 つの異なる動的 SOCKS プロキシが設定されています。
vim /etc/proxychains4.conf
round_robin
chain_len = 1
proxy_dns
remote_dns_subnet 224
tcp_read_time_out 15000
tcp_connect_time_out 8000
[ProxyList]
socks4 127.0.0.1 9050
socks4 127.0.0.1 9051
pagodo.py スクリプトの前に proxychains4 を付けると、各 request の検索は異なるプロキシを経由します(したがって、異なる IP から送信されます)。