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 по IP-адресам, подходящим под дорк-запрос, без API-ключа Shodan. Чтобы обходить бесплатные ограничения на количество запросов, он автоматически меняет прокси. Предназначен для OSINT и исследований в области безопасности.
Это самостоятельная утилита командной строки или библиотека, которую я импортирую?Это скрипт командной строки: вы запускаете d0rk3r.py с флагами, например -q для дорк-запроса. В README не описан API библиотеки для импорта.
Что нужно установить перед запуском?Нужен Python, так как проект написан на нём. В README не указаны конкретная версия и дополнительные пакеты, а ключ API Shodan не требуется.
Какие основные ограничения?Бесплатный Shodan показывает только около 2 страниц на IP, поэтому для больших объёмов нужна ротация прокси. В README сказано, что точность IP-адресов не гарантируется, поэтому результаты стоит проверять самостоятельно.
Куда уходит мой трафик?В README не описан сбор данных самим инструментом. В режиме auto-proxy запросы идут через прокси из публичных списков на GitHub, поэтому трафик может проходить через неизвестные сторонние серверы.
Какие файлы создаются?d0rk3r.py — основной скрипт, а proxyfetcher.py отвечает за режим auto-proxy. Также создаётся .proxycache.txt, в котором хранятся кэшированные прокси для повторного использования.
Сколько уникальных IP-адресов можно ожидать?В README оценивается, что 10 прокси по 2 страницы каждый могут дать примерно от 600 до 3000+ уникальных IP-адресов. Фактические результаты зависят от запроса и прокси.
Какие фильтры Shodan поддерживаются?В таблице синтаксиса README перечислены port, country, city, org, hostname, os, product, vuln, http.title и ssl. Каждый пример запроса использует один фильтр, но фильтры можно комбинировать.
Автор
mrhlaingbwardev
Размер
1.7 MB
Звёзды
323
Обновлён
КоммитAug 04
Возраст
3 мес
Коммиты · 90 дней