Update README.md
This commit is contained in:
parent
563f76760d
commit
a57871dd27
187
README.md
187
README.md
|
|
@ -1,3 +1,186 @@
|
|||
# gamble-detector
|
||||
# 🎯 GambleCheck - Website Gambling Content Detection Tool
|
||||
|
||||
🔍 Advanced tool to detect gambling content injection on websites - Batch scanning, multi-threading support, comprehensive reporting for security audits
|
||||
|
||||
|
||||
|
||||
|
||||
**GambleCheck** adalah tool Python yang powerful untuk mendeteksi konten judi yang ter-inject pada website. Tool ini menggunakan teknik analisis mendalam untuk mengidentifikasi berbagai jenis konten gambling yang tersembunyi.
|
||||
|
||||
## 🚀 Features
|
||||
|
||||
- ✅ **Batch Domain Scanning** - Scan multiple domains dari file list
|
||||
- ✅ **Multi-threading Support** - Scanning paralel untuk performa optimal
|
||||
- ✅ **Comprehensive Detection** - Deteksi slot, casino, togel, betting keywords
|
||||
- ✅ **Hidden Content Analysis** - Analisis HTML comments & hidden elements
|
||||
- ✅ **SSL Certificate Verification** - Security assessment
|
||||
- ✅ **Redirect Detection** - Identifikasi redirect mencurigakan
|
||||
- ✅ **Real-time Progress** - Live monitoring dengan counter
|
||||
- ✅ **Multiple Output Formats** - Text report & JSON export
|
||||
- ✅ **Risk Categorization** - High/Medium/Low risk classification
|
||||
|
||||
## 📦 Installation
|
||||
|
||||
```bash
|
||||
# Clone repository
|
||||
git clone https://git.classy.id/gitea/gamble-detector.git
|
||||
cd gamble-detector
|
||||
|
||||
# Install dependencies
|
||||
pip install -r requirements.txt
|
||||
|
||||
# Make executable (Linux/macOS)
|
||||
chmod +x gamblecheck.py
|
||||
```
|
||||
|
||||
## 🔧 Dependencies
|
||||
|
||||
```
|
||||
requests>=2.25.0
|
||||
urllib3>=1.26.0
|
||||
```
|
||||
|
||||
## 💻 Usage
|
||||
|
||||
### Basic Usage
|
||||
|
||||
```bash
|
||||
# Scan single domain
|
||||
python3 gamblecheck.py --domain example.com
|
||||
|
||||
# Batch scan from file
|
||||
python3 gamblecheck.py --file domains.txt
|
||||
|
||||
# Advanced batch scan
|
||||
python3 gamblecheck.py --file domains.txt --workers 20 --timeout 15 --output report.txt
|
||||
```
|
||||
|
||||
### Command Line Options
|
||||
|
||||
```
|
||||
--file, -f File containing list of domains to scan
|
||||
--domain, -d Single domain to scan
|
||||
--workers Number of concurrent workers (default: 10)
|
||||
--timeout Request timeout in seconds (default: 10)
|
||||
--output, -o Output file for detailed report
|
||||
--json Output results in JSON format
|
||||
--summary Show only summary report
|
||||
```
|
||||
|
||||
### Domain List Format
|
||||
|
||||
Create a text file with domains (supports bullet points):
|
||||
|
||||
```
|
||||
• example1.com
|
||||
• example2.com
|
||||
• example3.com
|
||||
```
|
||||
|
||||
Or simple format:
|
||||
```
|
||||
example1.com
|
||||
example2.com
|
||||
example3.com
|
||||
```
|
||||
|
||||
## 📊 Output Example
|
||||
|
||||
```
|
||||
================================================================================
|
||||
FINAL SCAN STATISTICS:
|
||||
================================================================================
|
||||
Total domains processed: 156
|
||||
🚨 HIGH RISK: 3 domains
|
||||
⚠️ MEDIUM RISK: 8 domains
|
||||
⚡ LOW RISK: 12 domains
|
||||
✅ CLEAN: 128 domains
|
||||
❌ FAILED/ERROR: 5 domains
|
||||
================================================================================
|
||||
⚠️ WARNING: 3 domain(s) detected with HIGH RISK gambling content!
|
||||
```
|
||||
|
||||
## 🎯 Detection Categories
|
||||
|
||||
| Category | Description | Score Range |
|
||||
|----------|-------------|-------------|
|
||||
| 🚨 **HIGH RISK** | Strong gambling indicators, multiple keywords | ≥50 |
|
||||
| ⚠️ **MEDIUM RISK** | Some suspicious content detected | 20-49 |
|
||||
| ⚡ **LOW RISK** | Minor indicators found | 1-19 |
|
||||
| ✅ **CLEAN** | No gambling content detected | 0 |
|
||||
| ❌ **FAILED** | Connection/access errors | - |
|
||||
|
||||
## 🔍 Detection Methods
|
||||
|
||||
### Keyword Analysis
|
||||
- **Slot Games**: slot gacor, pragmatic play, gates of olympus, sweet bonanza
|
||||
- **Casino**: live casino, baccarat, blackjack, roulette, poker online
|
||||
- **Sports Betting**: sbobet, taruhan bola, mix parlay, handicap
|
||||
- **Togel**: togel online, keluaran hk, prediksi togel
|
||||
- **General**: deposit pulsa, bonus new member, cashback
|
||||
|
||||
### Technical Analysis
|
||||
- HTML comments scanning
|
||||
- Hidden elements detection
|
||||
- Suspicious file paths checking
|
||||
- robots.txt analysis
|
||||
- SSL certificate verification
|
||||
- Redirect pattern analysis
|
||||
|
||||
## 📈 Performance
|
||||
|
||||
- **Multi-threading**: Up to 20 concurrent workers
|
||||
- **Speed**: ~100-200 domains per minute (depends on network)
|
||||
- **Memory**: Low memory footprint
|
||||
- **Reliability**: Automatic retry with different protocols
|
||||
|
||||
## 🛡️ Security Features
|
||||
|
||||
- User-Agent rotation
|
||||
- SSL verification bypass option
|
||||
- DNS resolution checking
|
||||
- Timeout protection
|
||||
- Error handling & recovery
|
||||
|
||||
## 📁 Project Structure
|
||||
|
||||
```
|
||||
gamble-detector/
|
||||
├── gamblecheck.py # Main script
|
||||
├── requirements.txt # Python dependencies
|
||||
├── README.md # This file
|
||||
└── domain.txt # domain cek
|
||||
|
||||
```
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
1. Fork the repository
|
||||
2. Create feature branch (`git checkout -b feature/AmazingFeature`)
|
||||
3. Commit changes (`git commit -m 'Add AmazingFeature'`)
|
||||
4. Push to branch (`git push origin feature/AmazingFeature`)
|
||||
5. Open a Pull Request
|
||||
|
||||
## 📝 License
|
||||
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
## ⚠️ Disclaimer
|
||||
|
||||
This tool is designed for security research and legitimate website auditing purposes only. Users are responsible for ensuring compliance with applicable laws and regulations. The authors are not responsible for any misuse of this tool.
|
||||
|
||||
## 🐛 Bug Reports & Feature Requests
|
||||
|
||||
Please use the [GitHub Issues](https://git.classy.id/gitea/gamble-detector/issues) page to report bugs or request new features.
|
||||
|
||||
## 🌟 Show Your Support
|
||||
|
||||
Give a ⭐️ if this project helped you!
|
||||
|
||||
## 📞 Contact
|
||||
|
||||
- GitHub: [@yourusername](https://git.classy.id/gitea)
|
||||
- Email: your.email@example.com
|
||||
|
||||
---
|
||||
|
||||
**Made with ❤️ for website security**
|
||||
Loading…
Reference in New Issue