# bullseye0/ghost_eye architecture

> Architecture diagram of the GitHub repository bullseye0/ghost_eye, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bullseye0/ghost_eye
- Repository: https://github.com/bullseye0/ghost_eye

## Overview

Ghost Eye is a Python command-line information-gathering and reconnaissance tool. The user starts it, chooses from an interactive menu, and receives results from a selected lookup, scan, or web-inspection capability. The menu and several implementations are visible in ghost_eye.py; the README documents the full feature set, but excerpts do not show every dispatch or implementation. Menu-to-feature edges therefore reflect documented options, not inspected calls. External targets and tools are shown only where the README or excerpts support them.

Main entry points: [`ghost_eye.py`](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py) (Interactive Menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_cli["Interactive Menu<br/>[ghost_eye.py]"]
end

subgraph group_lookups["Network Lookups"]
  node_etherape["EtherApe Monitor<br/>[ghost_eye.py]"]
  node_dns["DNS Lookup<br/>[ghost_eye.py]"]
  node_whois["Whois Lookup<br/>[ghost_eye.py]"]
  node_nmap["Nmap Port Scan<br/>[ghost_eye.py]"]
  node_traceroute["Traceroute<br/>[ghost_eye.py]"]
end

subgraph group_web["Web Recon"]
  node_headers["HTTP Headers<br/>[ghost_eye.py]"]
  node_clickjacking["Clickjacking Test<br/>[ghost_eye.py]"]
  node_robots["Robots Scanner<br/>[ghost_eye.py]"]
  node_cloudflare["Cookie Scraper<br/>[ghost_eye.py]"]
  node_links["Link Grabber<br/>[ghost_eye.py]"]
  node_crawler["URL Crawler<br/>[ghost_eye.py]"]
end

subgraph group_discovery["Target Discovery"]
  node_iplocation["IP Location<br/>[ghost_eye.py]"]
  node_cms["Technology Detection<br/>[ghost_eye.py]"]
  node_ct["Certificate Discovery<br/>[ghost_eye.py]"]
end

node_user(("User"))
node_target(("Target Network"))
node_crtsh(("crt.sh"))

node_user -->|"runs"| node_cli
node_cli -->|"offers option"| node_etherape
node_cli -->|"offers option"| node_dns
node_cli -->|"offers option"| node_whois
node_cli -->|"offers option"| node_nmap
node_cli -->|"offers option"| node_traceroute
node_cli -->|"offers option"| node_headers
node_cli -->|"offers option"| node_clickjacking
node_cli -->|"offers option"| node_robots
node_cli -->|"offers option"| node_cloudflare
node_cli -->|"offers option"| node_links
node_cli -->|"offers option"| node_crawler
node_cli -->|"offers option"| node_iplocation
node_cli -->|"offers option"| node_cms
node_cli -->|"offers option"| node_ct
node_etherape -.->|"monitors"| node_target
node_dns -.->|"looks up"| node_target
node_whois -.->|"queries"| node_target
node_nmap -->|"scans"| node_target
node_traceroute -.->|"traces route"| node_target
node_headers -.->|"requests headers"| node_target
node_clickjacking -->|"checks headers"| node_target
node_robots -.->|"fetches robots"| node_target
node_cloudflare -->|"scrapes cookies"| node_target
node_links -->|"crawls links"| node_target
node_crawler -->|"fetches pages"| node_target
node_iplocation -.->|"locates IP"| node_target
node_cms -.->|"detects technology"| node_target
node_ct -->|"queries logs"| node_crtsh

click node_cli "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_etherape "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_dns "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_whois "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_nmap "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_traceroute "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_headers "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_clickjacking "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_robots "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_cloudflare "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_links "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_crawler "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_iplocation "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_cms "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"
click node_ct "https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_user toneBlue
class node_etherape,node_dns,node_whois,node_nmap,node_traceroute toneAmber
class node_headers,node_clickjacking,node_robots,node_cloudflare,node_links,node_crawler toneMint
class node_iplocation,node_cms,node_ct toneRose
class node_target,node_crtsh toneIndigo
```

## Components

### User Interface

- [Interactive Menu](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`

### Network Lookups

- [EtherApe Monitor](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [DNS Lookup](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Whois Lookup](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Nmap Port Scan](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Traceroute](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`

### Web Recon

- [HTTP Headers](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Clickjacking Test](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Robots Scanner](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Cookie Scraper](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Link Grabber](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [URL Crawler](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`

### Target Discovery

- [IP Location](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Technology Detection](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`
- [Certificate Discovery](https://github.com/bullseye0/ghost_eye/blob/master/ghost_eye.py): `ghost_eye.py`

### Other components

- **User**
- **Target Network**
- **crt.sh**

## Connections

- User → Interactive Menu: runs (evidence: `README.md`)
- Interactive Menu → EtherApe Monitor: offers option (evidence: `README.md`)
- Interactive Menu → DNS Lookup: offers option (evidence: `README.md`)
- Interactive Menu → Whois Lookup: offers option (evidence: `README.md`)
- Interactive Menu → Nmap Port Scan: offers option (evidence: `README.md`)
- Interactive Menu → Traceroute: offers option (evidence: `README.md`)
- Interactive Menu → HTTP Headers: offers option (evidence: `README.md`)
- Interactive Menu → Clickjacking Test: offers option (evidence: `README.md`)
- Interactive Menu → Robots Scanner: offers option (evidence: `README.md`)
- Interactive Menu → Cookie Scraper: offers option (evidence: `README.md`)
- Interactive Menu → Link Grabber: offers option (evidence: `README.md`)
- Interactive Menu → URL Crawler: offers option (evidence: `README.md`)
- Interactive Menu → IP Location: offers option (evidence: `README.md`)
- Interactive Menu → Technology Detection: offers option (evidence: `README.md`)
- Interactive Menu → Certificate Discovery: offers option (evidence: `README.md`)
- EtherApe Monitor → Target Network: monitors (evidence: `README.md`)
- DNS Lookup → Target Network: looks up (evidence: `README.md`)
- Whois Lookup → Target Network: queries (evidence: `README.md`)
- Nmap Port Scan → Target Network: scans (evidence: `ghost_eye.py`)
- Traceroute → Target Network: traces route (evidence: `README.md`)
- HTTP Headers → Target Network: requests headers (evidence: `README.md`)
- Clickjacking Test → Target Network: checks headers (evidence: `ghost_eye.py`)
- Robots Scanner → Target Network: fetches robots (evidence: `README.md`)
- Cookie Scraper → Target Network: scrapes cookies (evidence: `ghost_eye.py`)
- Link Grabber → Target Network: crawls links (evidence: `ghost_eye.py`)
- URL Crawler → Target Network: fetches pages (evidence: `ghost_eye.py`)
- IP Location → Target Network: locates IP (evidence: `README.md`)
- Technology Detection → Target Network: detects technology (evidence: `README.md`)
- Certificate Discovery → crt.sh: queries logs (evidence: `ghost_eye.py`)
