Skip to content

Search for users with non-upgraded limited gifts in chats.

Notifications You must be signed in to change notification settings

bohd4nx/gifts-parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎁 Telegram Gifts Parser

Python aiogram License Platform

Search for users with non-upgraded limited gifts in chats.

English | Русский

📱 Screenshots

Click to expand

Main

image

Result

image

✨ Features

  • 🔍 Automatic Telegram chat scanning
  • ✨ Detection of limited, non-upgraded gifts (NFT)
  • 📊 Collection of user profiles and gift IDs
  • 💾 Saving scan results

🛠 Installation

  1. Clone the repository: (or just download it)

    git clone https://github.com/bohd4nx/gifts-parser.git
    cd gifts-parser
  2. Install dependencies:

    pip install -r requirements.txt
  3. Edit config.ini in the project root directory to match your needs.

🚀 Usage

  1. Start the bot:
    python main.py
  2. Send the bot a /start command and follow the instructions:
    • Provide a Telegram chat link (e.g., https://t.me/somechat)
    • Wait for the bot to parse the chat
    • Use the bot’s commands to fetch results

🔧 Example Usage & Output

  1. Send the '/start' command to the bot.
  2. The bot will ask for a Telegram chat link (e.g., https://t.me/samplechat).
  3. Bot starts parsing and shows progress updates:
    🔍 Parsing chat: @samplechat
    📊 Total members: 150
    ⏳ Parsed: 10/150
    ✨ Found users: 2
    
  4. After finishing, the bot offers a download of the results:
    ✅ Parse completed for @samplechat!
    📊 Total members: 150
    ⏳ Parsed: 150/150
    ✨ Found users: 15
    
    [ Download Results ]
    
  5. Clicking “Download Results” gives you a file with usernames and their limited gift info.

📝 License

This project is MIT licensed. See LICENSE for more information.

🌟 Support

If you find this project useful:

  • Give it a star ⭐
  • Share with others 🔄
  • Consider contributing 🛠️

Built with ❤️ by Bohdan