https://github.com/kourva/tscraper
Automated Telegram Scraper that scrapes data when you join the groups...
https://github.com/kourva/tscraper
python3 scraper-python scraper-tools telegram-api telegram-scraper telegram-selfbot
Last synced: 9 months ago
JSON representation
Automated Telegram Scraper that scrapes data when you join the groups...
- Host: GitHub
- URL: https://github.com/kourva/tscraper
- Owner: Kourva
- License: mit
- Created: 2024-02-21T23:47:39.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-28T16:09:32.000Z (over 1 year ago)
- Last Synced: 2025-03-18T13:44:57.865Z (9 months ago)
- Topics: python3, scraper-python, scraper-tools, telegram-api, telegram-scraper, telegram-selfbot
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 11
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Tscraper
Automated Telegram Scraper that scrapes data when you join the groups
# ¶ About
[**Tscraper**](https://github.com/Kourva/Tscraper) is an automated telegram group scraper tool with automated login process (You don't need to enter number or 2fa everytime you run the code). This scraper will run on your account and when you join the group, it will start scraping all members and save it into [SQLite3](https://docs.python.org/3/library/sqlite3.html) database...
*Note*: This tool will not scrape `Hidden Members` in groups!
# ⌗ Installation
> First of all, make sure you have [python3](https://www.python.org/downloads/) & `git` installed on your machine...
1. **Clone the repository**:
```bash
git clone https://github.com/Kourva/Tscraper
```
2. **Navigate to Tcraper and make** [Virtual Environment](https://docs.python.org/3/library/venv.html):
```bash
cd Tscraper && virtualenv venv && source venv/bin/activate
```
3. **Install requirements**:
```bash
pip install -r requirements.txt
```
Let's pause the installation and configure some data...
# ✎ Configuration
For this scraper you need: **`api-ID` || `api-Hash` || `Phone-number` || `2FA password`**
+ Get **api-ID** && **api-Hash**:
Get your api-ID and api-Hash from official [Telegram](https://my.telegram.org) website. See [help](https://core.telegram.org/api/obtaining_api_id)
Now open the `credential.json` and replace those data...
```json
{
"api_id": 11111111, // API ID here (Integer)
"api_hash": "0000000000000000000000000000000", // API Hash here (Str)
"phone_number": "+1234567890", // Phone Number here (Includes +)
"password": "test_password" // 2FA password (or leave blank)
}
```
**Let's look at our SQLite3 database** (You don't have to do somthing here):
```sql
CREATE TABLE "users" (
"chat_id" INTEGER UNIQUE,
"username" TEXT,
"access_hash" TEXT
);
```
**Sample:** Database is located in `Users/tuser.db`
chat_id | username | access_hash
--- | --- | ---
102948275 | telegram_user | -12c4qw32wkf12b8339b377 |
195467618 | None | 91qw382w419500139b1n26 |
# ★ Start & Run
Now let's start the bot. You can use proxy with proxychains or start it normally...
```bash
python main.py # Without proxy
```
```bash
proxychains -q python main.py # With proxy (Edit proxy in /etc/proxychains4.conf)
```
You just need to type **OTP code** sent to your phone number, after logging, new session with your phone number as its name will be created in root directory of Tscraper `.` for example: **13412428592.session**
# ヅ Common Issues
If you get an error like this, `Server sent a very new message with ID xxxxxxxxxxxxxxxxxxx, ignoring`, just fix your device clock using ntpdate:
```bash
sudo ntpdate 0.pool.ntp.org && sudo hwclock -w
```
Don't act like a bot (like joining to many groups in short time), Telegram will ban your account, make sure to join groups with at least 60 seconds delay between each!
❦ Thanks for your support ❦