https://github.com/ninja-yubaraj/lootbin
A tool to hunt, scan, and loot public pastes from Termbin for interesting keywords.
https://github.com/ninja-yubaraj/lootbin
crawler monitoring osint osint-python osint-tool pastebin python python3 scanner scraper termbin
Last synced: 10 months ago
JSON representation
A tool to hunt, scan, and loot public pastes from Termbin for interesting keywords.
- Host: GitHub
- URL: https://github.com/ninja-yubaraj/lootbin
- Owner: Ninja-Yubaraj
- Created: 2025-08-03T12:45:17.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-10T16:51:08.000Z (12 months ago)
- Last Synced: 2025-08-10T18:28:21.452Z (12 months ago)
- Topics: crawler, monitoring, osint, osint-python, osint-tool, pastebin, python, python3, scanner, scraper, termbin
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🏴☠️ LootBin
**LootBin** is a multi-threaded Python tool to hunt public pastes on [termbin.com](https://termbin.com), looking for interesting content based on keywords you provide. It automatically saves found links and matching pastes into organized folders — perfect for research, OSINT, or just exploring what's out there.
## ✨ Features
- Multi-threaded scanning
- Custom keywords to search for
- Saves matching links & full pastes
- Command-line configurable (threads, delay, loot folder, etc.)
- Clean logging to console and file
- Only logs useful events (found, loot, errors)
## ⚙️ Installation
```bash
git clone https://github.com/Ninja-Yubaraj/LootBin.git
cd LootBin
```
### 🐍 Using virtual environment (recommended):
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
```
> **Note:** If `requirements.txt` isn’t there, install manually:
```bash
pip install requests
```
## 🚀 Usage
Default files & folders:
- `keywords.txt` → keywords (one per line)
- `loot/` → folder to save loot
- `foundlinks.txt` → found 200 OK URLs
- `scanner.log` → log file
### ▶ Run with defaults
```bash
python LootBin.py
```
### ⚡ Run with custom options
```bash
python LootBin.py \
--threads 20 \
--delay 0.1 \
--keywords mywords.txt \
--loot myloot \
--found links.txt \
--log mylog.log
```
| Option | Description | Default |
| ------------ | ------------------------------------------ | ---------------- |
| `--threads` | Number of worker threads | `10` |
| `--delay` | Delay between starting new tasks (seconds) | `0.2` |
| `--keywords` | Path to keywords file | `keywords.txt` |
| `--loot` | Folder to save loot | `loot` |
| `--found` | File to save found 200 OK links | `foundlinks.txt` |
| `--log` | Log file | `scanner.log` |
## 📂 Output
- **Loot folder:** text files named by random suffix, containing matching pastes
- **foundlinks.txt:** list of termbin links returning 200 OK
- **scanner.log:** clean logs of useful events
## ☕ Contributing
Pull requests & suggestions welcome! Feel free to fork and add:
- **Two-stage scan**: first match keyword list (cheap), then run regex/entropy checks on the matched line + a small context window (±3–6 lines). This will reduce noise drastically.
- **Entropy filter**: compute Shannon entropy for candidate strings. Many real secrets are high-entropy; normal words are lower. TruffleHog-style tools combine regex + entropy.
- **False-positive whitelist**: maintain an “exclude words” list for common false positives (e.g., example, localhost, test, example.com, sample API keys used in docs). Many tools allow exclude_regex or exclude_words.
- regex support
- Colored logs
- JSON output
- Live stats
- Dockerfile
## ✨ Author
Made with ❤️ by [Ninja-Yubaraj](https://github.com/Ninja-Yubaraj)
> For educational & research purposes only. Use responsibly!