# bearhud/inibear-tools architecture

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

- Interactive diagram: https://gitdiagram.com/bearhud/inibear-tools
- Repository: https://github.com/bearhud/inibear-tools

## Overview

BEAR MULTI TOOL is an interactive terminal toolkit for reconnaissance, network inspection, web analysis, and authorized security testing. The principal workflow starts in the menu, gathers a target or query, dispatches to a focused script, and prints lookup or probe results. Its documented branches include OSINT, DNS/IP intelligence, scanning, service inspection, vulnerability lookup, and web analysis. Source excerpts show several dispatches and implementations; some documented tools were not sampled, so their menu links are based on the README and menu labels.

Main entry points: [`main.py`](https://github.com/bearhud/inibear-tools/blob/main/main.py) (Tool menu), [`scripts/ip_lookup.py`](https://github.com/bearhud/inibear-tools/blob/main/scripts/ip_lookup.py) (IP intelligence), [`scripts/osint.py`](https://github.com/bearhud/inibear-tools/blob/main/scripts/osint.py) (OSINT), [`scripts/subdomain_finder.py`](https://github.com/bearhud/inibear-tools/blob/main/scripts/subdomain_finder.py) (Subdomain finder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Terminal entry"]
  node_menu["Tool menu<br/>[main.py]"]
end

subgraph group_recon["Reconnaissance"]
  node_osint["OSINT<br/>[osint.py]"]
  node_dns["DNS lookup<br/>[dns_lookup.py]"]
  node_ipintel["IP intelligence<br/>[ip_lookup.py]"]
  node_reverse["Reverse DNS<br/>[reverse_dns.py]"]
  node_subdomains["Subdomain finder"]
  node_cve["CVE lookup<br/>[cve_lookup.py]"]
end

subgraph group_network["Network inspection"]
  node_scanner["Network scanner<br/>[netscan.py]"]
  node_banner["Banner grabber<br/>[banner_grabber.py]"]
  node_paping["TCP ping<br/>[paping.py]"]
  node_telnet["Telnet audit<br/>[telnet_bruter.py]"]
  node_bruter["Go audit core<br/>[bruter.go]"]
end

subgraph group_web["Web analysis"]
  node_http["HTTP analyzer<br/>[http_analyzer.py]"]
  node_params["Parameter discovery<br/>[param_discovery.py]"]
end

node_user(("Operator"))
node_rdap["RDAP service"]
node_geoip["IP geolocation"]
node_crtsh["Certificate logs"]
node_nvd["NVD service"]
node_webtarget(("Web target"))

node_user -->|"selects tools"| node_menu
node_menu -->|"loads and calls"| node_osint
node_osint -->|"queries domain"| node_rdap
node_menu -->|"loads and calls"| node_dns
node_menu -.->|"dispatches to"| node_ipintel
node_ipintel -->|"fetches lookup"| node_geoip
node_ipintel -->|"fetches registration"| node_rdap
node_menu -->|"loads and calls"| node_reverse
node_menu -->|"loads and calls"| node_subdomains
node_subdomains -->|"queries candidates"| node_crtsh
node_menu -->|"loads and calls"| node_cve
node_cve -->|"queries vulnerabilities"| node_nvd
node_menu -->|"loads and calls"| node_scanner
node_menu -->|"loads and calls"| node_banner
node_menu -->|"loads and calls"| node_paping
node_menu -->|"loads and calls"| node_telnet
node_telnet -.->|"delegates to"| node_bruter
node_menu -.->|"dispatches to"| node_http
node_menu -->|"loads and calls"| node_params
node_webtarget -.->|"provides URL"| node_http
node_webtarget -.->|"provides URL"| node_params

click node_menu "https://github.com/bearhud/inibear-tools/blob/main/main.py"
click node_osint "https://github.com/bearhud/inibear-tools/blob/main/scripts/osint.py"
click node_dns "https://github.com/bearhud/inibear-tools/blob/main/scripts/dns_lookup.py"
click node_ipintel "https://github.com/bearhud/inibear-tools/blob/main/scripts/ip_lookup.py"
click node_reverse "https://github.com/bearhud/inibear-tools/blob/main/scripts/reverse_dns.py"
click node_subdomains "https://github.com/bearhud/inibear-tools/blob/main/scripts/subdomain_finder.py"
click node_cve "https://github.com/bearhud/inibear-tools/blob/main/scripts/cve_lookup.py"
click node_scanner "https://github.com/bearhud/inibear-tools/blob/main/scripts/netscan.py"
click node_banner "https://github.com/bearhud/inibear-tools/blob/main/scripts/banner_grabber.py"
click node_paping "https://github.com/bearhud/inibear-tools/blob/main/scripts/paping.py"
click node_telnet "https://github.com/bearhud/inibear-tools/blob/main/scripts/telnet_bruter.py"
click node_bruter "https://github.com/bearhud/inibear-tools/blob/main/scripts/bruter.go"
click node_http "https://github.com/bearhud/inibear-tools/blob/main/scripts/http_analyzer.py"
click node_params "https://github.com/bearhud/inibear-tools/blob/main/scripts/param_discovery.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_menu toneBlue
class node_osint,node_dns,node_ipintel,node_reverse,node_subdomains,node_cve toneAmber
class node_scanner,node_banner,node_paping,node_telnet,node_bruter toneMint
class node_http,node_params toneRose
class node_user,node_rdap,node_geoip,node_crtsh,node_nvd,node_webtarget toneIndigo
```

## Components

### Terminal entry

- [Tool menu](https://github.com/bearhud/inibear-tools/blob/main/main.py): `main.py`

### Reconnaissance

- [OSINT](https://github.com/bearhud/inibear-tools/blob/main/scripts/osint.py): `scripts/osint.py`
- [DNS lookup](https://github.com/bearhud/inibear-tools/blob/main/scripts/dns_lookup.py): `scripts/dns_lookup.py`
- [IP intelligence](https://github.com/bearhud/inibear-tools/blob/main/scripts/ip_lookup.py): `scripts/ip_lookup.py`
- [Reverse DNS](https://github.com/bearhud/inibear-tools/blob/main/scripts/reverse_dns.py): `scripts/reverse_dns.py`
- [Subdomain finder](https://github.com/bearhud/inibear-tools/blob/main/scripts/subdomain_finder.py): `scripts/subdomain_finder.py`
- [CVE lookup](https://github.com/bearhud/inibear-tools/blob/main/scripts/cve_lookup.py): `scripts/cve_lookup.py`

### Network inspection

- [Network scanner](https://github.com/bearhud/inibear-tools/blob/main/scripts/netscan.py): `scripts/netscan.py`
- [Banner grabber](https://github.com/bearhud/inibear-tools/blob/main/scripts/banner_grabber.py): `scripts/banner_grabber.py`
- [TCP ping](https://github.com/bearhud/inibear-tools/blob/main/scripts/paping.py): `scripts/paping.py`
- [Telnet audit](https://github.com/bearhud/inibear-tools/blob/main/scripts/telnet_bruter.py): `scripts/telnet_bruter.py`
- [Go audit core](https://github.com/bearhud/inibear-tools/blob/main/scripts/bruter.go): `scripts/bruter.go`

### Web analysis

- [HTTP analyzer](https://github.com/bearhud/inibear-tools/blob/main/scripts/http_analyzer.py): `scripts/http_analyzer.py`
- [Parameter discovery](https://github.com/bearhud/inibear-tools/blob/main/scripts/param_discovery.py): `scripts/param_discovery.py`

### Other components

- **Operator**
- **RDAP service**
- **IP geolocation**
- **Certificate logs**
- **NVD service**
- **Web target**

## Connections

- Operator → Tool menu: selects tools (evidence: `main.py`)
- Tool menu → OSINT: loads and calls (evidence: `main.py`)
- OSINT → RDAP service: queries domain (evidence: `scripts/osint.py`)
- Tool menu → DNS lookup: loads and calls (evidence: `main.py`)
- Tool menu → IP intelligence: dispatches to (evidence: `readme.md`)
- IP intelligence → IP geolocation: fetches lookup (evidence: `scripts/ip_lookup.py`)
- IP intelligence → RDAP service: fetches registration (evidence: `scripts/ip_lookup.py`)
- Tool menu → Reverse DNS: loads and calls (evidence: `main.py`)
- Tool menu → Subdomain finder: loads and calls (evidence: `main.py`)
- Subdomain finder → Certificate logs: queries candidates (evidence: `scripts/subdomain_finder.py`)
- Tool menu → CVE lookup: loads and calls (evidence: `main.py`)
- CVE lookup → NVD service: queries vulnerabilities (evidence: `scripts/cve_lookup.py`)
- Tool menu → Network scanner: loads and calls (evidence: `main.py`)
- Tool menu → Banner grabber: loads and calls (evidence: `main.py`)
- Tool menu → TCP ping: loads and calls (evidence: `main.py`)
- Tool menu → Telnet audit: loads and calls (evidence: `main.py`)
- Telnet audit → Go audit core: delegates to
- Tool menu → HTTP analyzer: dispatches to (evidence: `readme.md`)
- Tool menu → Parameter discovery: loads and calls (evidence: `main.py`)
- Web target → HTTP analyzer: provides URL
- Web target → Parameter discovery: provides URL
