https://github.com/amirali104/v2ray-scraper
A simple program to extract v2ray and mtproto proxies from multiple telegram channels
https://github.com/amirali104/v2ray-scraper
Last synced: about 1 month ago
JSON representation
A simple program to extract v2ray and mtproto proxies from multiple telegram channels
- Host: GitHub
- URL: https://github.com/amirali104/v2ray-scraper
- Owner: AmirAli104
- License: mit
- Created: 2025-06-30T12:51:36.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-09-08T08:51:33.000Z (about 1 month ago)
- Last Synced: 2025-09-08T10:36:25.776Z (about 1 month ago)
- Language: Python
- Size: 28.3 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# v2ray Scraper
This Python script connects to multiple Telegram channels and extracts proxy configurations from recent messages, including **V2Ray** and **MTProto** links.
---
## 🚀 Installation
First, install the required dependencies:
```bash
pip install telethon
# optional (for clipboard support)
pip install pyperclip
```
## ⚙️ Configuration
The configuration file is channels.json.
- It contains:
- A list of Telegram channels.
- api_id and api_hash (needed for Telegram API authentication).
- For each channel, you can specify how many recent messages to fetch.
By default, the script uses Telegram Desktop API keys, so you can run it without changes.
However, you may replace them with your own api_id and api_hash if needed.
## ▶️ Usage
Run the script:
```bash
python src/v2ray.py [options]
```
## Command Line Options
|option|description|
|------|------|
|`-v,--v2ray`|Extract v2ray proxies|
|`-m,--mtproto`|Extract mtproto proxies|
|`-s,--session`|The name of the session file (default: session_name.session)|
|`-n,--no-save-messages`|Do not save the full messages of proxy channels to a file|
|`-f,--messages-file`|The name of the file to save channels messages (default: channels_messages.txt)|
|`-c,--auto-copy`|Automatically copy extracted proxies to clipboard|
|`-e,--save-extracted`|Save the extracted proxies in a file|
|`-p,--print-proxies`|Print the extracted proxy configurations to the console|
|`-h,--help`|Show the help message and exit|
## 📋 Example
```bash
# Extract V2Ray proxies, copy them to clipboard, and print to console
python src/v2ray.py -v -c -p
```
## ⚠️ Disclaimer
I do not support any use of this tool for censorship, surveillance, or any form of human rights violation.
By using this code, you agree to take full responsibility for how it is used.