{"id":17017363,"url":"https://github.com/kourva/tscraper","last_synced_at":"2025-03-22T16:31:15.040Z","repository":{"id":223767198,"uuid":"761493819","full_name":"Kourva/Tscraper","owner":"Kourva","description":"Automated Telegram Scraper that scrapes data when you join the groups...","archived":false,"fork":false,"pushed_at":"2024-08-28T16:09:32.000Z","size":28,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T13:44:57.865Z","etag":null,"topics":["python3","scraper-python","scraper-tools","telegram-api","telegram-scraper","telegram-selfbot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kourva.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-21T23:47:39.000Z","updated_at":"2025-03-05T06:36:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"34ce9bff-9530-41e8-ab45-4b96c874c615","html_url":"https://github.com/Kourva/Tscraper","commit_stats":null,"previous_names":["kourva/tscraper","kozyol/tscraper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kourva%2FTscraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kourva%2FTscraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kourva%2FTscraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kourva%2FTscraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kourva","download_url":"https://codeload.github.com/Kourva/Tscraper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244986545,"owners_count":20543030,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python3","scraper-python","scraper-tools","telegram-api","telegram-scraper","telegram-selfbot"],"created_at":"2024-10-14T06:36:26.776Z","updated_at":"2025-03-22T16:31:14.630Z","avatar_url":"https://github.com/Kourva.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"left\"\u003e\n    \u003cimg align=\"left\" width=400 src=\"https://www.v-user.com/images/web-blog/pages/how-to-join-telegram-group-via-link.webp\" /\u003e\n    \u003ch1 align=\"center\"\u003e\n        Tscraper\n    \u003c/h1\u003e\n    \u003ch4\u003e\n        Automated Telegram Scraper that scrapes data when you join the groups\n    \u003c/h4\u003e\n    \u003cdiv align=\"center\"\u003e\n      \u003ckbd\u003e\n        \u003cimg align=\"center\" src=\"https://img.shields.io/github/license/Kourva/Tscraper?style=flat-square\u0026logo=github\u0026logoColor=%23ff5500\u0026labelColor=black\u0026color=%23ff5500\" /\u003e\n        \u003cimg align=\"center\" src=\"https://img.shields.io/github/languages/code-size/Kourva/Tscraper?style=flat-square\u0026logo=python\u0026logoColor=%23ff5500\u0026labelColor=%23000000\u0026color=%23ff5500\" /\u003e\n        \u003cimg align=\"center\" src=\"https://img.shields.io/github/stars/Kourva/Tscraper?style=flat-square\u0026logo=polestar\u0026logoColor=%23ff5500\u0026labelColor=%23000000\u0026color=%23ff5500\" /\u003e\n       \u003c/kbd\u003e\n      \u003c/div\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n# ¶ About\n[**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...\n*Note*: This tool will not scrape `Hidden Members` in groups!\n\n\u003cbr\u003e\n\n# ⌗ Installation\n\u003e First of all, make sure you have [python3](https://www.python.org/downloads/) \u0026 `git` installed on your machine...\n1. **Clone the repository**:\n    ```bash\n    git clone https://github.com/Kourva/Tscraper\n    ```\n\n2. **Navigate to Tcraper and make** [Virtual Environment](https://docs.python.org/3/library/venv.html):\n    ```bash\n    cd Tscraper \u0026\u0026 virtualenv venv \u0026\u0026 source venv/bin/activate\n    ```\n\n3. **Install requirements**:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\nLet's pause the installation and configure some data...\n\n\u003cbr\u003e\n\n# ✎ Configuration\nFor this scraper you need: **`api-ID` || `api-Hash` || `Phone-number` || `2FA password`**\n+ Get **api-ID** \u0026\u0026 **api-Hash**: \n    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)\n\nNow open the `credential.json` and replace those data...\n```json\n{\n    \"api_id\": 11111111,                              // API ID here (Integer)\n    \"api_hash\": \"0000000000000000000000000000000\",   // API Hash here (Str)\n    \"phone_number\": \"+1234567890\",                   // Phone Number here (Includes +)\n    \"password\": \"test_password\"                      // 2FA password (or leave blank)\n}\n```\n\n**Let's look at our SQLite3 database** (You don't have to do somthing here):\n```sql\nCREATE TABLE \"users\" (\n    \"chat_id\"     INTEGER UNIQUE,\n    \"username\"    TEXT,\n    \"access_hash\" TEXT\n);\n```\n**Sample:** Database is located in `Users/tuser.db`\u003cbr\u003e\n\nchat_id | username | access_hash \n--- | --- | --- \n102948275 | telegram_user | -12c4qw32wkf12b8339b377 | \n195467618 | None | 91qw382w419500139b1n26 |\n\n\u003cbr\u003e\n\n# ★ Start \u0026 Run\nNow let's start the bot. You can use proxy with proxychains or start it normally...\n```bash\npython main.py                    # Without proxy\n```\n```bash\nproxychains -q python main.py     # With proxy (Edit proxy in /etc/proxychains4.conf)\n```\nYou 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**\n\n\u003cbr\u003e\n\n# ヅ Common Issues\nIf you get an error like this, `Server sent a very new message with ID xxxxxxxxxxxxxxxxxxx, ignoring`, just fix your device clock using ntpdate:\n```bash\nsudo ntpdate 0.pool.ntp.org \u0026\u0026 sudo hwclock -w\n```\nDon'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!\n\n\u003cbr\u003e\n\n\u003ch3 align=\"center\"\u003e❦ Thanks for your support ❦\u003c/h3\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkourva%2Ftscraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkourva%2Ftscraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkourva%2Ftscraper/lists"}