Repository navigation
DorkEye v5.2 — Release Notes
Passive OSINT graph (
--osint) · One tabbed HTML report for every phase · SQLite export · Runs on Python 3.7 → 3.13 · XSS fixes in the HTML reports · Real secret confidence · Cleaner terminal output · README in 7 languages · No breaking CLI changes
DorkEye v5.2 is a feature and security release built on top of v5.1. It adds a keyless OSINT
graph that maps the infrastructure behind the hosts your dorks find, collects every phase into a
single tabbed HTML report, and installs cleanly on every Python from 3.7 up. It also fixes several
XSS issues in the HTML reports and gives secret findings a real confidence level.
Every v5.1 command keeps working unchanged.
✨ New Features
🕸️ OSINT Graph — --osint
Passive recon on the hosts DorkEye finds, using public sources only and no API keys:
Certificate Transparency (crt.sh), RDAP, DNS-over-HTTPS, Shodan InternetDB, reverse DNS,
ASN / geo and the Wayback Machine.
| Level | Collects | Touches the target |
|---|---|---|
--osint=1 |
Registrar data, subdomains, DNS records | No |
--osint / --osint=2 |
Level 1 + open ports, known CVEs, reverse DNS, ASN / country for every IP | No |
--osint=3 |
Level 2 + archived URLs, page title / server / security.txt of each host |
Yes — one HTTP request per host |
- Findings: IPs with known CVEs, hosts with telling names (
admin,dev,staging,vpn,
jenkins…), most common open ports, shared-IP pivots, ASN clusters. - Contacts: emails and phone numbers from registrar records, pages and
security.txt. - Interactive graph in the report, downloadable as JSON, CSV (nodes / edges), TXT, GraphML
and SQLite. - A fresh graph every run, saved in
Dump/as SQLite. - Custom chains in JSON, and a standalone mode:
python Tools/osint.py --seed example.com. - Available from the CLI, the wizard and the Web Console.
| New flag | Description |
|---|---|
--osint [1|2|3|chain] |
Run OSINT (level 2 when given without a value) |
--osint-seed VALUE |
Extra seed (domain / host / IP / URL), added to the dork hosts. On its own: OSINT only |
--osint-db PATH |
SQLite path for the graph |
--osint-threads N |
Worker threads (default 2, light on phones) |
--osint-max-nodes N |
Node cap per run (default 2000) |
--osint-export LIST |
Extra files: csv, json, graphml, txt |
python3 dorkeye.py -d "site:example.com" --osint -o recon.html
python3 dorkeye.py --osint-seed example.com --osint=1 --osint-export csv,txt📑 Unified Tabbed Report
- One HTML file, one tab per phase: Dorks · Analyze · DBScan · Crawl · OSINT. Each tab is the
complete report of that phase, isolated in its own frame, so filters, exports and the OSINT
graph work exactly as on their own. - SQLite export: new SQLITE button in the export panel — all results with every field
(URL, title, snippet, dork, category, status, SQLi / XSS / WAF results). - With
-o results.json/.csv/.txtyour results file is kept, and the tabbed report is
saved next to it asresults.html.
🐍 Python 3.7 → 3.13
- One
requirements.txtfor every Python from 3.7 up. Per-version markers let pip pick
compatible packages automatically — no conflicts,pip checkclean. - On Python 3.9+ DorkEye searches through
ddgs. On 3.7 / 3.8, whereddgsdoesn't exist,
the dork search and the crawler automatically use DorkEye's built-in lxml-free DuckDuckGo
client — nothing else to install. - Tested with real installs and end-to-end runs on Python 3.7, 3.8, 3.9, 3.10 and 3.13.
🌍 README in 7 Languages
English · 简体中文 ·
Español ·
Português ·
Русский ·
日本語 ·
Italiano
🐛 Bug Fixes
| Area | Problem | Fix |
|---|---|---|
| Install | pip install -r requirements.txt failed outright on Python 3.7 / 3.8. |
Per-version requirements and automatic fallback client (see above). |
| Secrets | Every secret finding (analyzer and SecretsAgent) was reported as HIGH confidence, MD5 hashes and private IPs included. |
Per-rule confidence: vendor-prefixed keys HIGH, key=value patterns MEDIUM, generic hashes / IPs LOW. |
| Docs | Broken links in the device guides, INSTALL and the USAGE navigation bar. | All local links and anchors fixed. |
🔒 Security & Hardening
- XSS in the dork HTML report. The ⓘ Details popup rendered result titles, snippets and dorks
as HTML; a crafted URL could break out of thedata-extattribute;javascript:links from
result files were clickable. Every value is now escaped, and links are allowed only for
http/https/ftp. - XSS in the analysis and agents reports (
--analyze). URLs, titles, secrets, PII, emails,
subdomains and LLM-generated text are now escaped in both HTML and Markdown. Links are limited
tohttp/httpsand open withrel="noopener noreferrer"; these HTML reports carry a strict
Content-Security-Policy that blocks scripts and outbound connections. - Shared escaping helpers in
Tools/dorkeye_patterns.py, used by every report builder. - No target data in git.
.gitignorenow excludesDump/and OSINT outputs (*.sqlite,
*.graphml,*_summary.txt). - Verified in a headless browser: the same malicious result file runs script in the v5.1 report
and nothing in v5.2.
🎨 Output & UX
- One statistics block. Results by Category is merged into Search Statistics as a single
block with square tables. - Less noise. Removed the
Scanning results (files/SQLi/XSS)line and theSEARCH COMPLETE
banner; one clear save line per output file. - OSINT progress shown live for each step, with how many seeds came from the results and from
--osint-seed.
🤖 Agents
- The agents report header, footer and JSON
enginefield now readDorkEye v5.2 + Agents v3.1
(they mixed v4.8 and v5.0).
🧹 Internal
- New
Tools/report.py: the report engine moved out ofdorkeye.py, which is ~560 lines lighter. - New
Tools/osint.py: the OSINT graph engine. - MetaByte email / phone / IP / URL extractors are built into
dorkeye.py; OSINT uses them for
contacts. Devices/iOS/ddg_lite.pyis now the general lite search backend, not only for iSH.- Claude workflow (
claude-dorkeye.yml): its prompts told the bot to keepddgsbelow 5.0 — now
aligned withrequirements.txt; the weekly audit also checksreport.py,osint.pyand
Python 3.7 syntax.
📖 Documentation
- New OSINT guide and an
OSINT Graph section in the README. - USAGE: OSINT section, new
recommended combinations, complete flag reference (now also--dbscan*,--ui,--port). - Updated: CLI reference (44 flags),
output formats
(tabbed report, OSINT files),
HTML report (SQLite export),
install guide (Python 3.7+),
wizard and Web Console pages.
🔁 Compatibility
- No breaking CLI changes. All v5.1 flags, YAML templates and configuration files work
unchanged. 6 flags were added (--osint*), none removed. - Secret findings in JSON exports now carry
HIGH/MEDIUM/LOWconfidence instead of always
HIGH— update any script that filtered on it. - Search behaviour on Python 3.9+ is unchanged from v5.1.
- Upgrade:
git pull pip install -r requirements.txt
- Source code archives (
zip/tar.gz) are attached automatically by GitHub.
🧭 Roadmap (v5.3+)
dorkeye.py — URL normalisation pre-dedup · parallel analysis
(ThreadPoolExecutor) · domain clustering · config validation
sqli.py — structural boolean blind · second-order SQLi · OOB via DNS
xss.py — OOB XSS via interactsh · headless-browser DOM analysis (Playwright)
dorkeye_web.py — optional HTTP Basic Auth · WebSocket streaming · config editor
Full Changelog: v5.1...v5.2
DorkEye v5.2 | xPloits3c I.C.W.T
github.com/xPloits3c/DorkEye · t.me/DorkEye
Legal disclaimer: Attacking targets without prior mutual consent is illegal. It is the end user's responsibility to obey all applicable local, state and federal laws. The developers assume no liability and are not responsible for any misuse or damage caused by this program.