> ## Content Index
> Fetch the complete content index at: https://darkwebinformer.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# TorBot: Open Source Intelligence (OSINT) Tool for the Dark Web
- URL: https://darkwebinformer.com/torbot-open-source-intelligence-osint-tool-for-the-dark-web/
- Published: 2025-07-17T16:29:12.000Z
- Updated: 2025-09-04T22:21:10.000Z
- Author: Dark Web Informer
- Tags: OSINT

---

**GitHub:** <https://github.com/DedSecInside/TorBot>

---

# 🧰 TorBot - Onion Crawler & Analysis Tool

**TorBot** is a flexible crawler for `.onion` domains and clearnet sites. It allows researchers to gather intelligence from Tor-hidden services and map out link relationships with optional visualization.

---

## 🔧 Key Features

- **Onion Crawler (.onion)**  
Returns the page title or hostname (if no title is available), along with a short description.
- **Database Integration** *(Coming Soon)*  
Save crawled links to a database.
- **HTML Capture** *(Coming Soon)*  
Output site HTML or save it as a file.
- **JSON Export**  
Save the discovered link tree in JSON format.
- **Custom Domain Crawling**  
Crawl any domain, not just `.onion` addresses.
- **Live Link Checker**  
Verify if a link is active.
- **Built-in Updater**  
Easily update TorBot to the latest version.
- **Visual Link Tree**  
Build a graph of link relationships and export it for analysis.
- **Additional Features (Planned)**  
More enhancements will be added in future releases.

---

## 📦 Dependencies

- **Tor** *(Optional but recommended)*
- **Python** `>=3.9`
- **Poetry** *(Optional)*

### Python Dependencies

See `pyproject.toml` or `requirements.txt` for a complete list of libraries.

---

## 🚀 Installation

### Using `venv` (Recommended)

bashCopyEditpython -m venv torbot\_venv  
`source` torbot\_venv/bin/activate  
pip install -r requirements.txt  
pip install -e .  
`./main.py --help`  

---

### Using Docker

#### Build the Docker image:

bashCopyEditdocker build -t torbot .  

#### Run without Tor:

bashCopyEditdocker run torbot poetry run python torbot -u https://example.com --depth 2 --visualize tree --save json --disable-socks5  

#### Run with Tor:

bashCopyEdit`docker run --network="host"` torbot poetry run python torbot -u https://example.com --depth 2 --visualize tree --save json  

---

## ⚙️ Command Line Options

| Option            | Description                           |
| ----------------- | ------------------------------------- |
| \-u, --url        | **Required**: Target URL to crawl     |
| \--depth          | Set crawler depth (default: 1)        |
| \-h, --help       | Show help message                     |
| \--host           | SOCKS5 proxy IP (default: 127.0.0.1)  |
| \--port           | SOCKS5 proxy port (default: 9050)     |
| \-v               | Enable DEBUG logs                     |
| \--version        | Show TorBot version                   |
| \--update         | Update TorBot                         |
| \-q, --quiet      | Quiet mode (no banner or IP display)  |
| \--save           | Save results: tree or json            |
| \--visualize      | Visualize results: tree, json, table  |
| \-i, --info       | Display basic info of the target site |
| \--disable-socks5 | Run without SOCKS5 proxy (no Tor)     |

> **Note:** `-u` is mandatory for crawling.

---

## 🗺️ Planned Features (Roadmap)

- Visual module revamp
- Implement BFS search logic
- Improve stability & error handling
- Save recent results to a database
- Randomized Tor identity & headers
- Keyword & phrase search
- Social media data extraction
- Enhanced anonymity features
- Screenshot capture of crawled pages

---

## 🤝 Contribution Guidelines

**Found an issue?**  
Submit bugs or feature requests [here](https://github.com/your-repo/issues).

**Developer Notes:**

- Fork the repository and create a new branch.
- Run `pytest` before submitting pull requests to the `dev` branch.
- Follow **PEP8** coding style.
- Document new features thoroughly.
- Include a clear description when submitting pull requests.