Skip to content

DorkEye v5.2

Latest

Choose a tag to compare

@xPloits3c xPloits3c released this 11 Nov 16:28
· 6 commits to master since this release
d580405

DorkEye v5.2 — Release Notes

image

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 / .txt your results file is kept, and the tabbed report is
    saved next to it as results.html.

🐍 Python 3.7 → 3.13

  • One requirements.txt for every Python from 3.7 up. Per-version markers let pip pick
    compatible packages automatically — no conflicts, pip check clean.
  • On Python 3.9+ DorkEye searches through ddgs. On 3.7 / 3.8, where ddgs doesn'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 the data-ext attribute; 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
    to http / https and open with rel="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. .gitignore now excludes Dump/ 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 the SEARCH 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 engine field now read DorkEye v5.2 + Agents v3.1
    (they mixed v4.8 and v5.0).

🧹 Internal

  • New Tools/report.py: the report engine moved out of dorkeye.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.py is now the general lite search backend, not only for iSH.
  • Claude workflow (claude-dorkeye.yml): its prompts told the bot to keep ddgs below 5.0 — now
    aligned with requirements.txt; the weekly audit also checks report.py, osint.py and
    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 / LOW confidence 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.