# 🔍 Telegram Bot Token Scanner
![Extension Preview](https://i.imgur.com/1TIJDo5.png) **A professional Chromium extension that automatically scans web pages for Telegram bot tokens and validates them using the Telegram API.** [![Chromium Extension](https://img.shields.io/badge/Chrome-Extension-blue?logo=google-chrome&logoColor=white)](https://chrome.google.com/webstore) [![Version](https://img.shields.io/badge/Version-1.0-green)](https://github.com/DoomsdayxProductions/Telegram-Token-Scanner.crx) [![License](https://img.shields.io/badge/License-Educational-orange)](https://github.com/DoomsdayxProductions/Telegram-Token-Scanner.crx)
--- ## ✨ Features ![Features Overview](https://i.imgur.com/HbDVctW.png) ### 🔍 **Advanced Scanning** - **Automatic Detection**: Scans web pages and network responses for Telegram bot tokens - **Multi-Source Scanning**: Monitors page content, network requests, and navigation events - **Smart Patterns**: Uses multiple regex patterns to detect tokens in various formats - **Real-time Validation**: Validates tokens by calling the Telegram API (`api.telegram.org/bot{token}/getMe`) ![Dashboard Interface](https://i.imgur.com/h2Im6E0.png) ### 📊 **Comprehensive Dashboard** - **Valid Tokens Tab**: View all successfully validated bot tokens with detailed statistics - **History Tab**: Complete history of all found tokens (valid, invalid, and unvalidated) - **Settings Tab**: Configure scanning behavior and preferences - **About Tab**: Access official resources and community links ![Bot Information Display](https://i.imgur.com/vJ3movW.png) ### 🤖 **Bot Information Display** - **Detailed Bot Data**: Shows bot name, username, ID, and capabilities - **Group Permissions**: Displays if bot can join groups or read all group messages - **Source Tracking**: Records where each token was found and when - **Occurrence Count**: Tracks how many times each token appears ### ⚙ī¸ **Advanced Configuration** - **Background Scanning**: Enable/disable automatic scanning - **Scan Intervals**: Configure how often to scan pages (1000-60000ms) - **Content Scanning**: Toggle page content scanning on/off - **Network Monitoring**: Enable/disable network request scanning - **Navigation Scanning**: Scan on page navigation events - **URL Scanning**: Scan current URL for tokens --- ## 🚀 Installation 1. **Download or clone this repository** 2. **Open Chrome** and go to `chrome://extensions/` 3. **Enable "Developer mode"** in the top right 4. **Click "Load unpacked"** and select the extension folder 5. **The extension icon** will appear in your browser toolbar --- ## 📖 Usage ### 🚀 **Getting Started** 1. Click the extension icon in your browser toolbar 2. The popup opens with four main tabs: **Valid Tokens**, **History**, **Settings**, and **About** 3. The extension automatically starts scanning when you visit web pages ### 📈 **Valid Tokens Tab** - **Statistics Overview**: Shows counts of valid bots, usernames, group permissions, and unique sites - **Token List**: Displays all successfully validated bot tokens - **Bot Details**: For each token, shows: - Bot name and username (e.g., "KingDavid (@PsalmsDavid_bot)") - Bot ID and capabilities - Source page with clickable links - Last seen timestamp and occurrence count ### 📋 **History Tab** - **Complete Overview**: Shows all found tokens (valid, invalid, and unvalidated) - **Statistics Cards**: Displays total tokens, valid bots, invalid tokens, and unvalidated count - **Detailed Information**: Each entry shows validation status, error messages, and full metadata - **Source Tracking**: Clickable links to where tokens were discovered ### ⚙ī¸ **Settings Tab** Configure your scanning preferences: #### **General Settings** - **Auto-validate tokens**: Automatically validate tokens when found - **Show notifications**: Display notifications for valid tokens - **Max history size**: Maximum number of tokens to keep (10-1000) #### **Background Scanning** - **Enable background scanning**: Toggle automatic scanning on/off - **Scan interval**: Set how often to scan pages (1000-60000ms) - **Scan page content**: Enable/disable HTML content scanning - **Scan network requests**: Monitor API calls and responses - **Scan on navigation**: Scan when pages load - **Scan current URL**: Check the URL itself for tokens #### **Filescan.io Integration** - **Enable Filescan.io search**: Search their database for tokens - **API Key**: Configure your Filescan.io API key - **Search interval**: How often to search (1-60 minutes) ### đŸŽ¯ **Action Buttons** - **Validate All**: Manually validate all unvalidated tokens - **Search Filescan.io**: Trigger a manual search of the Filescan.io database - **Export Tokens**: Export tokens to clipboard or download as file - **Clear History**: Remove all stored token history ### ℹī¸ **About Tab** - **Official Resources**: Links to Reaper Market (.com and .cc) - **Community**: Telegram channels for updates and discussions - **Version Information**: Current extension version and credits --- ## 🔍 Token Detection Patterns The extension detects tokens using these patterns: - **Standard bot token format**: `numbers:letters` (e.g., `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`) - **JavaScript variables**: `bot_token`, `telegram_bot_token`, `api_key` - **URL patterns**: `bot{token}` in URLs - **Various naming conventions** and formats --- ## 🔒 Privacy & Security - ✅ **All data is stored locally** in your browser - ✅ **No data is sent to external servers** except for token validation - ✅ **Token validation only sends the token** to `api.telegram.org` - ✅ **You can clear all history** at any time --- ## 🎨 Interface Design ### 🎨 **Professional UI** - **Compact Design**: Optimized for 227x368 pixel popup window - **Clean Typography**: Professional font hierarchy and spacing - **Color-Coded Status**: Green for valid tokens, red for invalid, yellow for unvalidated - **Responsive Layout**: Adapts to different content sizes with smooth scrolling - **Hover Effects**: Subtle interactions for better user experience ### 📱 **Tab Navigation** - **Valid Tokens**: Focus on successfully validated bots with statistics - **History**: Complete audit trail of all scanning activity - **Settings**: Comprehensive configuration options - **About**: Professional information and community links ### 🔧 **Action Controls** - **Flexible Button Layout**: Buttons adapt to available space - **Export Options**: Copy to clipboard or download as file - **Bulk Operations**: Validate all tokens or clear history with one click - **Real-time Updates**: Interface updates as new tokens are found --- ## 🛠ī¸ Technical Details ### 📁 **File Structure** ``` ├── manifest.json # Extension configuration and permissions ├── content.js # Content script that scans web pages and network requests ├── background.js # Service worker for token validation, storage, and API calls ├── popup.html # Extension popup interface with responsive design ├── popup.js # Popup functionality and tab management ├── icons/ # Extension icons for different sizes │ ├── icon16.png │ ├── icon48.png │ └── icon128.png └── README.md # This file ``` ### 🔐 **Permissions** - `activeTab`: Access to current tab content for scanning - `storage`: Local storage for token history and settings - `webRequest`: Monitor network requests and responses - `webNavigation`: Track page navigation events - `notifications`: Show alerts for found tokens - `host_permissions`: Access to all URLs and Telegram API endpoints ### 🌐 **API Integration** - **Telegram Bot API**: Validates tokens via `api.telegram.org/bot{token}/getMe` - **Filescan.io**: Optional integration for database searches - **Error Handling**: Graceful handling of API failures and network issues --- ## 🚀 Development To modify the extension: 1. **Edit the relevant files** 2. **Go to** `chrome://extensions/` 3. **Click the refresh button** on the extension card 4. **Test your changes** --- ## 🌐 Community & Resources ### 🌐 **Official Websites** - **[Reaper Market (.com)](https://reaper-market.com)**: Primary marketplace and resources - **[Reaper Market (.cc)](https://reaper-market.cc)**: Alternative domain and services ### đŸ’Ŧ **Community Channels** - **[Updates & Notifications](https://t.me/+NqSqu1v10bwxNTcx)**: Get notified about new releases and updates - **[Public Discussion](https://t.me/+FtjFQJNPSWxiZmYx)**: Join the community for support and discussions ---