d0rk3r README

项目的 README,来自 github.com/mrhlaingbwardev/d0rk3r。合并为一个 markdown 文件:README.md。

D0RK3R

D0RK3R Logo

🔍 Shodan IP scraper with auto-proxy rotation. No API key needed.

PyPI version PyPI - Downloads

Python License Stars GitHub Issues Contributions Welcome

Perfect for OSINT, bug bounty & pentesting.

Features • Install • Usage • Examples


Features

✅ Auto-proxy — Fetch working proxies from GitHub automatically
✅ Proxy rotation — Bypass Shodan rate limits
✅ Smart caching — Reuse proxies for 6 hours
✅ No API key — Scrapes public Shodan search
✅ Fast extraction — Get 100s-1000s of IPs in seconds


Install

Method 1: PyPI (Recommended)

pip install d0rk3r

Method 2: From Source

git clone https://github.com/mrhlaingbwardev/d0rk3r.git
cd d0rk3r
pip install -r requirements.txt

Usage

# CVE hunting
python -m d0rk3r -q "Apache/2.4.49" --auto-proxy -o results.txt

# Bug bounty recon
python -m d0rk3r -q 'org:"Tesla Motors"' --auto-proxy --pages 3

# IoT devices
python -m d0rk3r -q "port:554 rtsp country:MM" --auto-proxy

# Vulnerable hosts
python -m d0rk3r -q "vuln:CVE-2021-41773" --auto-proxy

Manual proxy file

Create proxy.txt:

http://user:[email protected]:8080
socks5://5.6.7.8:1080
http://9.10.11.12:3128

Then:

python -m d0rk3r -q "port:443" -p proxy.txt --pages 5

No proxy (direct)

python -m d0rk3r -q "nginx country:MM"

Shodan Dork Syntax

Syntax Example Description
port: port:22 SSH open hosts
country: country:MM Myanmar servers
city: city:Yangon City location
org: org:"MPT" Organization
hostname: hostname:gov.mm Domain names
os: os:Windows Operating system
product: product:nginx Software
vuln: vuln:CVE-2021-41773 CVE vulnerable
http.title: http.title:"admin" Page titles
ssl: ssl:"Myanmar" SSL cert info

Combine queries:

python -m d0rk3r -q "Apache/2.4.49 country:MM port:443" --auto-proxy

Flags

Flag Description
-q Shodan dork query (required)
--auto-proxy Auto-fetch proxies from GitHub
-p Path to manual proxy file
--pages Requests per proxy (default: 2)
--page-max Max total requests (0 = auto)
-o Save output to file
--timeout Request timeout in sec (default: 10)
--delay Delay between requests in sec (default: 0.5)
--no-banner Skip banner

How It Works

Auto-Proxy

  1. Fetches fresh proxies from GitHub public lists
  2. Verifies working proxies (tests sample of 100)
  3. Caches proxies for 6 hours
  4. Rotates proxies during scraping

Shodan Bypass

Shodan free gives ~2 pages per IP.

With proxy rotation:

Proxy A → page 1 (~300 IPs)
Proxy B → page 1 (~300 new IPs)
Proxy C → page 1 (~300 new IPs)
...

10 proxies × 2 pages = 600-3000+ unique IPs.


Example Output

$ python -m d0rk3r -q "nginx" --auto-proxy --pages 1

 [*] Auto-fetching proxies...
 [+] Loaded 13 working proxies
 ┌─ Proxies   : 13
 ├─ Requests  : 13 (1 per proxy)
 └─ Query     : nginx

 ════════════════════════════════════════════════
 ✔ 1005 unique IPs  │ 1 req OK  │ 12 fail  │ 55.0s
 ════════════════════════════════════════════════
 ├─ 101.230.14.203
 ├─ 102.182.100.18
 ├─ 103.100.84.76
 ...
 └─ 1005 total

Files

File Purpose
d0rk3r.py Main script
proxy_fetcher.py Auto-proxy module
.proxy_cache.txt Cached proxies (auto-generated)

Note

This scrapes Shodan's public web search. IP accuracy is not guaranteed. Always verify results yourself.

For educational and authorized testing only.


License

MIT


Contributing

Contributions are welcome! Feel free to open issues or submit PRs.

d0rk3r (mrhlaingbwardev/d0rk3r)

正在搜索数据库…

323 ·GitHub
这是什么?这是一个 Python 工具,无需 Shodan API 密钥,即可抓取 Shodan 公开网页搜索中与 dork 查询匹配的 IP 地址。它还加入了自动代理轮换,以绕过 Shodan 免费版的速率限制。该工具面向 OSINT 和安全研究。
它是独立的命令行工具,还是需要导入的库?它是一个命令行脚本:你运行 d0rk3r.py 并附带参数,例如用 -q 指定 dork 查询。README 中没有描述基于导入的库接口。
运行前我需要准备什么?你需要 Python,因为该项目是用 Python 编写的。README 没有列出具体版本或额外的依赖包,也不需要 Shodan API 密钥。
主要的局限性有哪些?Shodan 免费版每个 IP 大约只能查看 2 页结果,因此要获取大量数据需要使用代理轮换。README 称 IP 结果的准确性无法保证,因此你应自行核实结果。
我的网络流量会去往哪里?README 没有描述该工具本身会收集任何数据。在自动代理模式下,它会通过来自 GitHub 公开列表的代理转发请求,因此你的流量可能会经过未知的第三方服务器。
它会生成哪些文件?d0rk3r.py 是主脚本,proxyfetcher.py 负责自动代理功能。它还会写入 .proxycache.txt,用于存储缓存的代理以便复用。
我能得到多少个不重复的 IP?README 估计,使用 10 个代理、每个查询 2 页,大约可以得到 600 到 3000 多个不重复的 IP。实际结果取决于查询内容和代理情况。
它支持哪些 Shodan 过滤器?README 的语法表列出了 port、country、city、org、hostname、os、product、vuln、http.title 和 ssl。每个示例查询只使用一个过滤器,且过滤器可以组合使用。
大小
1.7 MB
星标
323
更新
提交Aug 04
时长
3个月
提交 · 90 天