Skip to content

README.md

Latest commit

 

History

History
374 lines (348 loc) · 21.3 KB

README.md

File metadata and controls

374 lines (348 loc) · 21.3 KB
Raw

SmartToolBot 💥🌟

SmartToolBot is a powerful Telegram bot built with Python and Pyrofork & Telethon , designed to provide a wide range of utilities including credit card scraping, media downloading, AI-powered tools, and more. This bot leverages multiple APIs and services to deliver robust functionality for both casual and advanced users. ✨

Features 🌟

  • Start Smart Tool: ꜱᴛᴀʀᴛ_ꜱᴍᴀʀᴛ_✘_ᴛᴏᴏʟ↯
  • Talk to SmartAI: ᴛᴀʟᴋ_ᴛᴏ_✘_ꜱᴍᴀʀᴛᴀɪ↯
  • C^C Generator:* ᴄ*^ᴄ_✘_ɢᴇɴᴇʀᴀᴛᴏʀ↯
  • Check B^IN:* ᴄʜᴇᴄᴋ_✘_ʙ*^ɪɴ↯
  • Check Multiple B^INs:* ᴄʜᴇᴄᴋ_ᴍᴜʟᴛɪᴘʟᴇ_✘_ʙ*^ɪɴꜱ↯
  • Extrapolate Credit Card Data from B^IN:* ᴇxᴛʀᴀᴘᴏʟᴀᴛᴇ_ᴄʀᴇᴅɪᴛ_✘_ᴄᴀʀᴅ_ᴅᴀᴛᴀ_ꜰʀᴏᴍ_ʙ*^ɪɴ↯
  • Find Top B^IN from Combo:* ꜰɪɴᴅ_ᴛᴏᴘ_✘_ʙ*^ɪɴ_ꜰʀᴏᴍ_ᴄᴏᴍʙᴏ↯
  • C^C Scrape:* ᴄ*^ᴄ_✘_ꜱᴄʀᴀᴘᴇ↯
  • Filter C^Cs:* ꜰɪʟᴛᴇʀ_✘_ᴄ*^ᴄꜱ↯
  • Multi C^C Generator:* ᴍᴜʟᴛɪ_ᴄ*^ᴄ_✘_ɢᴇɴᴇʀᴀᴛᴏʀ↯
  • Multi C^C Scrape:* ᴍᴜʟᴛɪ_ᴄ*^ᴄ_✘_ꜱᴄʀᴀᴘᴇ↯
  • Find B^IN Database:* ꜰɪɴᴅ_ʙ*^ɪɴ_✘_ᴅᴀᴛᴀʙᴀꜱᴇ↯
  • Filter Specific B^IN Cards:* ꜰɪʟᴛᴇʀ_ꜱᴘᴇᴄɪꜰɪᴄ_✘_ʙ*^ɪɴ_ᴄᴀʀᴅꜱ↯
  • Remove Specific B^IN Cards:* ʀᴇᴍᴏᴠᴇ_ꜱᴘᴇᴄɪꜰɪᴄ_✘_ʙ*^ɪɴ_ᴄᴀʀᴅꜱ↯
  • Ask Question to ChatGPT-3.5: ᴀꜱᴋ_ǫᴜᴇꜱᴛɪᴏɴ_✘_ᴛᴏ_ᴄʜᴀᴛɢᴘᴛ_3.5↯
  • Ask Question to ChatGPT-4: ᴀꜱᴋ_ǫᴜᴇꜱᴛɪᴏɴ_✘_ᴛᴏ_ᴄʜᴀᴛɢᴘᴛ_4↯
  • Ask Question to Gemini AI: ᴀꜱᴋ_ǫᴜᴇꜱᴛɪᴏɴ_✘_ᴛᴏ_ɢᴇᴍɪɴɪ_ᴀɪ↯
  • Image Analysis: ɪᴍᴀɢᴇ_ᴀɴᴀʟʏꜱɪꜱ_✘_ʀᴇᴀᴅ_ɪᴍᴀɢᴇ↯
  • Base64 Encode: ʙᴀꜱᴇ64_✘_ᴇɴᴄᴏᴅᴇ↯
  • Base64 Decode: ʙᴀꜱᴇ64_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Base32 Encode: ʙᴀꜱᴇ32_✘_ᴇɴᴄᴏᴅᴇ↯
  • Base32 Decode: ʙᴀꜱᴇ32_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Binary Encode: ʙɪɴᴀʀʏ_✘_ᴇɴᴄᴏᴅᴇ↯
  • Binary Decode: ʙɪɴᴀʀʏ_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Hex Encode: ʜᴇx_✘_ᴇɴᴄᴏᴅᴇ↯
  • Hex Decode: ʜᴇx_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Octal Encode: ᴏᴄᴛᴀʟ_✘_ᴇɴᴄᴏᴅᴇ↯
  • Octal Decode: ᴏᴄᴛᴀʟ_✘_ᴅᴇᴄᴏᴅᴇ↯
  • Reverse Text: ʀᴇᴠᴇʀꜱᴇ_✘_ᴛᴇxᴛ↯
  • Transform to Capital Letters: ᴛʀᴀɴꜱꜰᴏʀᴍ_ᴛᴏ_✘_ᴄᴀᴘɪᴛᴀʟ_ʟᴇᴛᴛᴇʀꜱ↯
  • Transform to Small Letters: ᴛʀᴀɴꜱꜰᴏʀᴍ_ᴛᴏ_✘_ꜱᴍᴀʟʟ_ʟᴇᴛᴛᴇʀꜱ↯
  • Count Words: ᴄᴏᴜɴᴛ_✘_ᴡᴏʀᴅꜱ↯
  • Download Facebook Video: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ꜰᴀᴄᴇʙᴏᴏᴋ_ᴠɪᴅᴇᴏ↯
  • Download Pinterest Video: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ᴘɪɴᴛᴇʀᴇꜱᴛ_ᴠɪᴅᴇᴏ↯
  • Download YouTube Video: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ʏᴏᴜᴛᴜʙᴇ_ᴠɪᴅᴇᴏ↯
  • Download Instagram Reels: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ɪɴꜱᴛᴀɢʀᴀᴍ_ʀᴇᴇʟꜱ↯
  • Download Spotify Track: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ꜱᴘᴏᴛɪꜰʏ_ᴛʀᴀᴄᴋ↯
  • Download YouTube Audio: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ʏᴏᴜᴛᴜʙᴇ_ᴀᴜᴅɪᴏ↯
  • Convert Video to Audio: ᴄᴏɴᴠᴇʀᴛ_ᴠɪᴅᴇᴏ_✘_ᴛᴏ_ᴀᴜᴅɪᴏ↯
  • Extract YouTube Video Tags: ᴇxᴛʀᴀᴄᴛ_✘_ʏᴏᴜᴛᴜʙᴇ_ᴠɪᴅᴇᴏ_ᴛᴀɢꜱ↯
  • Download YouTube Thumbnail: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ʏᴏᴜᴛᴜʙᴇ_ᴛʜᴜᴍʙɴᴀɪʟ↯
  • Fix Word Spelling: ꜰɪx_✘_ᴡᴏʀᴅ_ꜱᴘᴇʟʟɪɴɢ↯
  • Fix Grammatical Issues: ꜰɪx_✘_ɢʀᴀᴍᴍᴀᴛɪᴄᴀʟ_ɪꜱꜱᴜᴇꜱ↯
  • Check Synonyms and Antonyms: ᴄʜᴇᴄᴋ_✘_ꜱʏɴᴏɴʏᴍꜱ_ᴀɴᴅ_ᴀɴᴛᴏɴʏᴍꜱ↯
  • Check Pronunciation: ᴄʜᴇᴄᴋ_✘_ᴘʀᴏɴᴜɴᴄɪᴀᴛɪᴏɴ↯
  • Filter/Extract Mails: ꜰɪʟᴛᴇʀ_✘_ᴇxᴛʀᴀᴄᴛ_ᴍᴀɪʟꜱ↯
  • Filter/Extract Mail Passwords: ꜰɪʟᴛᴇʀ_✘_ᴇxᴛʀᴀᴄᴛ_ᴍᴀɪʟ_ᴘᴀꜱꜱᴡᴏʀᴅꜱ↯
  • Mail-Pass Scrape for GC Targets: ᴍᴀɪʟ-ᴘᴀꜱꜱ_✘_ꜱᴄʀᴀᴘᴇ_ꜰᴏʀ_ɢᴄ_ᴛᴀʀɢᴇᴛꜱ↯
  • Mail Scrape: ᴍᴀɪʟ_✘_ꜱᴄʀᴀᴘᴇ↯
  • Generate Random Mail with Password: ɢᴇɴᴇʀᴀᴛᴇ_✘_ʀᴀɴᴅᴏᴍ_ᴍᴀɪʟ_ᴡɪᴛʜ_ᴘᴀꜱꜱᴡᴏʀᴅ↯
  • Check Recent 10 Mails: ᴄʜᴇᴄᴋ_✘_ʀᴇᴄᴇɴᴛ_10_ᴍᴀɪʟꜱ↯
  • pyrofork Telegram String Session: ᴘʏʀᴏɢʀᴀᴍ_✘_ᴛᴇʟᴇɢʀᴀᴍ_ꜱᴛʀɪɴɢ_ꜱᴇꜱꜱɪᴏɴ↯
  • Telethon Telegram String Session: ᴛᴇʟᴇᴛʜᴏɴ_✘_ᴛᴇʟᴇɢʀᴀᴍ_ꜱᴛʀɪɴɢ_ꜱᴇꜱꜱɪᴏɴ↯
  • Real-Time Token Prices: ʀᴇᴀʟ-ᴛɪᴍᴇ_✘_ᴛᴏᴋᴇɴ_ᴘʀɪᴄᴇꜱ↯
  • Latest P2P Trades in BDT: ʟᴀᴛᴇꜱᴛ_✘_ᴘ2ᴘ_ᴛʀᴀᴅᴇꜱ_ɪɴ_ʙᴅᴛ↯
  • Top Gainers List: ᴛᴏᴘ_✘_ɢᴀɪɴᴇʀꜱ_ʟɪꜱᴛ↯
  • Top Losers List: ᴛᴏᴘ_✘_ʟᴏꜱᴇʀꜱ_ʟɪꜱᴛ↯
  • Get Info About Stripe Key: ɢᴇᴛ_✘_ɪɴꜰᴏ_ᴀʙᴏᴜᴛ_ꜱᴛʀɪᴘᴇ_ᴋᴇʏ↯
  • Check Stripe Key Live or Dead: ᴄʜᴇᴄᴋ_✘_ꜱᴛʀɪᴘᴇ_ᴋᴇʏ_ʟɪᴠᴇ_ᴏʀ_ᴅᴇᴀᴅ↯
  • Get IP Information: ɢᴇᴛ_✘_ɪᴘ_ɪɴꜰᴏʀᴍᴀᴛɪᴏɴ↯
  • Proxy Checker: ᴘʀᴏxʏ_✘_ᴄʜᴇᴄᴋᴇʀ↯
  • Take Website Screenshot: ᴛᴀᴋᴇ_✘_ᴡᴇʙꜱɪᴛᴇ_ꜱᴄʀᴇᴇɴꜱʜᴏᴛ↯
  • Download Website Source Code: ᴅᴏᴡɴʟᴏᴀᴅ_✘_ᴡᴇʙꜱɪᴛᴇ_ꜱᴏᴜʀᴄᴇ_ᴄᴏᴅᴇ↯
  • Extract Text from Image: ᴇxᴛʀᴀᴄᴛ_✘_ᴛᴇxᴛ_ꜰʀᴏᴍ_ɪᴍᴀɢᴇ↯
  • Generate Random Address: ɢᴇɴᴇʀᴀᴛᴇ_✘_ʀᴀɴᴅᴏᴍ_ᴀᴅᴅʀᴇꜱꜱ↯
  • Check Weather: ᴄʜᴇᴄᴋ_✘_ᴡᴇᴀᴛʜᴇʀ↯
  • Get User/Group/Channel Info: ɢᴇᴛ_✘_ᴜꜱᴇʀ_ɢʀᴏᴜᴘ_ᴄʜᴀɴɴᴇʟ_ɪɴꜰᴏ↯
  • Get Full Help: ɢᴇᴛ_✘_ꜰᴜʟʟ_ʜᴇʟᴘ↯
  • Broadcast Admin: ʙʀᴏᴀᴅᴄᴀꜱᴛ_✘_ᴀᴅᴍɪɴ↯
  • Restart Me: ʀᴇꜱᴛᴀʀᴛ_✘_ᴍᴇ↯
  • Change Entire Database Settings: ᴄʜᴀɴɢᴇ_✘_ᴇɴᴛɪʀᴇ_ᴅᴀᴛᴀʙᴀꜱᴇ↯
  • And More Features Just Host & See↯

Requirements 💥🌟

  • Python 3.9 Or Above 🐍 Note: Python Version 3.9-3.12 Full Supported 3.13 Maybe But Not Tested
  • 3 MongoDB URLs 🌐 Need 3 MONGO_URL Must For 3 DB Client So That's A Mandatory VARS
  • Supported OS ❄️
    • Ubuntu 22.04+ 💫
    • Debian 10+ 🌟
  • Environment Variables 👀 Make sure to provide the following Telegram-specific variables:
    • API_ID
    • API_HASH
    • BOT_TOKEN
    • SESSION_STRING
  • Additional Info ✘ Check the Vars List for more configuration details and setup instructions!

Installation

Follow these steps to set up and deploy SmartToolBot:

  1. Clone the Repository: 
    git clone https://github.com/TheSmartDevs/SmartToolBot.git
cd SmartToolBot
  2. Install FFmpeg: FFmpeg is required for media processing and must be installed using your system's package manager. For Ubuntu/Debian, run: 
    sudo apt update
sudo apt install ffmpeg
    Note: FFmpeg cannot be installed via pip.
  3. Install Python Dependencies: 
    pip3 install -r requirements.txt
  4. Set Up Environment Variables:
    • Create a .env file in the project root or edit config.py directly.
    • Populate the required variables (see Environment Variables).
    • Refer to the .env example and the Mandatory/Optional Vars sections for guidance.
  5. Deploy the Bot:
    • Direct Deployment: 
      python3 main.py
    • Run with Screen (Recommended for Persistent Sessions): 
      screen -S SmartToolBot
python3 main.py
      To detach from the screen session, press Ctrl+A followed by D. To reattach: 
      screen -r SmartToolBot
    • Deploy with Docker Compose: Ensure Docker and Docker Compose are installed. The bot will run in a containerized environment with dependencies managed automatically. 
      docker compose up --build --remove-orphans
      To stop the bot: 
      docker compose down

Special Note: 💫: Configure the bot by setting values in either the .env file or directly in config.py—your choice! The default YouTube cookies path is SmartToolBot/cookies/ISmartToolBot.txt. Admins can dynamically adjust variables using the /settings command within the bot for quick and easy management. 👨‍💻

Deploy to Heroku

Deploy

Heroku Deployment Tutorial

Deploying SmartToolBot to Heroku is a straightforward process. Follow these steps to get your bot running on Heroku:

  1. Create a Heroku Account:
    • Sign up for a free account at Heroku if you don’t already have one.
  2. Install Heroku CLI:
    • Download and install the Heroku Command Line Interface (CLI) from Heroku Dev Center.
    • Verify installation by running: 
      heroku --version
  3. Log in to Heroku:
    • Run the following command and follow the prompts to log in: 
      heroku login
  4. Clone the Repository:
    • If you haven’t already, clone the SmartToolBot repository: 
      git clone https://github.com/TheSmartDevs/SmartToolBot.git
cd SmartToolBot
  5. Create a Heroku App:
    • Create a new Heroku app by running: 
      heroku create your-app-name
      Replace your-app-name with a unique name for your app.
  6. Install FFmpeg Buildpack:
    • Heroku requires a buildpack to install FFmpeg. Add the FFmpeg buildpack to your app: 
      heroku buildpacks:add https://github.com/jonathanong/heroku-buildpack-ffmpeg-latest.git -a your-app-name
    • Add the Python buildpack as well: 
      heroku buildpacks:add heroku/python -a your-app-name
  7. Set Environment Variables:
    • Configure the mandatory and optional environment variables (see Environment Variables) in Heroku: 
      heroku config:set API_ID=your_api_id -a your-app-name
heroku config:set API_HASH=your_api_hash -a your-app-name
heroku config:set BOT_TOKEN=your_bot_token -a your-app-name
heroku config:set SESSION_STRING=your_session_string -a your-app-name
heroku config:set OPENAI_API_KEY=your_openai_key -a your-app-name
heroku config:set MONGO_URL=your_mongo_url -a your-app-name
heroku config:set DATABASE_URL=your_database_url -a your-app-name
heroku config:set DB_URL=your_db_url -a your-app-name
    • Add optional variables as needed, such as GOOGLE_API_KEY, GROQ_API_KEY, etc.
  8. Deploy the Bot:
    • Push the code to Heroku: 
      git push heroku main
    • Scale the dyno to run the bot: 
      heroku ps:scale worker=1 -a your-app-name
  9. Verify Deployment:
    • Check the logs to ensure the bot is running: 
      heroku logs --tail -a your-app-name
    • Interact with your bot on Telegram to confirm it’s operational.
  10. Managing FFmpeg on Heroku:
    • The FFmpeg buildpack automatically installs FFmpeg during deployment. No manual installation is required, unlike local setups.
    • If you encounter issues with FFmpeg, ensure the buildpack was added correctly and redeploy: 
      git commit --allow-empty -m "Redeploy for FFmpeg"
git push heroku main

Note: Heroku’s free tier has limitations, such as dyno hours and sleep periods. Consider upgrading to a paid plan for persistent bot availability. Ensure your .env or config.py settings are correctly mirrored in Heroku’s config vars.

Environment Variables ⚙️

Mandatory Vars To Connect The Bot To Telegram Server ⁉️

  1. API_ID - Obtain from my.telegram.org. 🔐
  2. API_HASH - Obtain from my.telegram.org. 🔐
  3. BOT_TOKEN - Create a bot via @BotFather. 🤖
  4. SESSION_STRING - Open @ISmartToolBot and use the /pyro command, then follow the instructions. 📲
  5. OPENAI_API_KEY - Obtain from OpenAI API Console. 🧠
  6. MONGO_URL - MongoDB database URL for storing user and group Database, obtain from MongoDB. 🗄️
  7. DATABASE_URL - Alternative MongoDB database URL For ChannelHelp, obtain from MongoDB. 🗄️
  8. DB_URL - Additional MongoDB database URL For GroupHelp, obtain from MongoDB. 🗄️

Recommended Optional Vars For The Core Utils 🌟

  1. REPLICATE_API_TOKEN - For Replicate AI features, obtain from Replicate. 🧠
  2. GOOGLE_API_KEY - For Google Gemini AI features, obtain from Google AI Studio. 🧠
  3. GROQ_API_KEY - For Groq AI models, obtain from Groq API Console. 🧠
  4. TRANS_API_KEY - For translation features, obtain from the specified translation API provider. 🌍
  5. OCR_API_KEY - For OCR text extraction, obtain from the specified OCR API provider. 📄
  6. MODEL_NAME - AI model name for specific features (default: gemini-2.0-flash). 🧠
  7. OWNER_ID - Telegram user ID for owner access, obtain via @ISmartToolBot with /info. 👑
  8. DEVELOPER_USER_ID - Telegram user ID of the bot developer, obtain via @ISmartToolBot with /info. 👨‍💻

Optional Vars For The Utils ❄️

  1. TEXT_MODEL - Text processing model (default: deepseek-r1-distill-llama-70b). 🧠
  2. GROQ_API_URL - Groq API endpoint (default: https://api.groq.com/openai/v1/chat/completions). 🌐
  3. NEWS_API_KEY - For news updates, obtain from the specified news API provider. 📰
  4. BIN_KEY - For BIN lookup, obtain from HandyAPI. 💳
  5. DOMAIN_API_KEY - For domain lookup, obtain from WhoisXMLAPI. 🌐
  6. DOMAIN_API_URL - Domain lookup API endpoint (default: https://www.whoisxmlapi.com/whoisserver/WhoisService). 🌐
  7. UPDATE_CHANNEL_URL - Telegram channel URL for bot updates (default: t.me/TheSmartDev). 📢
  8. LOG_CHANNEL_ID - Telegram channel ID for logs (default: -10032424244335). 📜
  9. PROFILE_ERROR_URL - Fallback image URL for users without a profile photo. 🖼️
  10. OCR_WORKER_URL - Custom OCR API endpoint for text extraction. 📄
  11. TEXT_API_URL - Custom text processing API endpoint. 📝
  12. IMAGE_API_URL - Custom image processing API endpoint. 🖼️
  13. YT_COOKIES_PATH - Path to YouTube cookies file for media downloads (default: ./cookies/ISmartToolBot.txt). 🍪
  14. CC_SCRAPPER_LIMIT - Limit for credit card scraping (default: 5000). 💳
  15. SUDO_CCSCR_LIMIT - Sudo user credit card scraping limit (default: 10000). 💳
  16. MULTI_CCSCR_LIMIT - Multi-user credit card scraping limit (default: 2000). 💳
  17. MAIL_SCR_LIMIT - Email scraping limit (default: 10000). 📧
  18. SUDO_MAILSCR_LIMIT - Sudo user email scraping limit (default: 15000). 📧
  19. CC_GEN_LIMIT - Credit card generation limit (default: 2000). 💳
  20. MULTI_CCGEN_LIMIT - Multi-user credit card generation limit (default: 5000). 💳
  21. DOMAIN_CHK_LIMIT - Domain check limit (default: 20). 🌐
  22. PROXY_CHECK_LIMIT - Proxy check limit (default: 20). 🛡️
  23. IMGAI_SIZE_LIMIT - Max image size for AI processing (default: 5MB). 🖼️
  24. MAX_TXT_SIZE - Max text file size (default: 15MB). 📝
  25. MAX_VIDEO_SIZE - YouTube Downloader Max video file size (default: 2GB). 📹
  26. VIDEO_RESOLUTION - YouTube Downloader video resolution (default: 1280x720). 📺
  27. COMMAND_PREFIX - Command prefixes (default: !|.|#|,|/).
  28. BAN_REPLY - Custom ban message (default: **Sorry Bro You're Banned From Using Me ❌**). 🚫

Admin Commands / Sudo Commands

  • gban - Ban a user from the bot forever (for spam or policy violation)
  • gunban - Unban a user from the bot database
  • send - Send broadcast to users using Client.forward_message method
  • broadcast - Broadcast sent to users using Client.copy_message
  • stats - See bot's statistics report
  • status - See bot's statistics report
  • repport - See bot's statistics report
  • logs - View all console logs
  • restart - Restart the bot
  • reload - Restart the bot
  • Reboot - Restart the bot
  • settings - Change all bot variables
  • auth - Promote a user to the bot admin list
  • unauth - Remove a user from the bot admin list
  • getadmins - Get all admins list of the bot

Handling YouTube Download Errors with Cookies 🍪

To avoid errors related to YouTube sign-in requirements or bot protection, using a cookie file is highly recommended. Here's how to set it up:

Steps to Export and Use Cookies 👀

  1. Create a Dedicated Chrome Profile:
    • Create a new Chrome profile to manage your bot's cookies securely. 🖥️
  2. Install a Cookie Management Extension:
    • Use a browser extension like Cookie Editor to manage and export cookies. 🔧
  3. Export Cookies from YouTube:
    • Log into YouTube using your new Chrome profile. 📺
    • Use the cookie extension to export cookies in Netscape format. 📄
  4. Save the Cookies File:
    • Save the exported cookies as ISmartToolBot.txt in the SmartToolBot/cookies/ISmartToolBot.txt directory. 📂

Managing Cookies 💡

  • Cookie Expiry:
    • YouTube cookies may expire or become invalid. If you encounter download issues, export and replace the cookies file with a fresh one. 🔄
    • Don't Play Videos In Your Mobile Or PC Through The Account Which Cookie You Exported. Cause Such Activity Will Change Cookie's Values.
    • Don't Sign Out From The Gmail In Your PC Or Mobile From The Browser Of App From Which You Exported Cookies.
    • Don't Restart Or Turn On Off Your Bot Frequently To Refrain From COOKIE EXPIRY .
  • Cookie Depletion:
    • Avoid frequent bot restarts or excessive YouTube requests to prevent early cookie expiry. ⚠️
    • Monitor your bot's activity to ensure cookies remain valid. 👀 This setup ensures reliable access to YouTube content without encountering sign-in or bot protection errors. 🚀

🌟 Handling Scrapper Utils Errors with SESSION_STRING 💫

Avoid common user client errors by generating a fresh SESSION_STRING using ISmartToolBot 🌐

✨ Quick Steps to Generate SESSION_STRING

  1. 🚀 Go to 👉 @ISmartToolBot
  2. 💬 Send /pyro to start pyrofork session generation
  3. 🆔 Enter your API ID from my.telegram.org
  4. 🔐 Enter your API HASH
  5. 📞 Input your phone number in international format (e.g., +880...) 🇧🇩
  6. ✅ Send the OTP you receive (e.g., AB2 BC4 CD5 EF6 GH6) — the bot auto-extracts it as 24566
  7. 💾 Check Saved Messages for your SESSION_STRING
  8. 🛠️ Add it to your .env or config.py

❄️ Important Notice: Avoid Frequent Restarts ⚠️

Frequent restarts using user accounts can trigger Telegram's security system 👀

💥 You Might Face:

  • 🚫 Forced logout of your account
  • ❌ 406 AUTH_KEY_DUPLICATED error
  • ⚠️ Temporary bans or session invalidation

⭐️ To Stay Safe:

  • Minimize restarts
  • Always use a fresh session if errors appear
  • Prefer bot accounts for heavy or persistent tasks

✅ Pro Tips

  • Fresh sessions fix 90% of scraper issues
  • Never share your SESSION_STRING publicly
  • Use .env for secure config management

Contributing 👨‍💻

Contributions are welcome! Please follow these steps:

  1. Fork the repository. 🍴
  2. Create a new branch (git checkout -b feature-branch). 🌿
  3. Commit your changes (git commit -m 'Add new feature'). 💾
  4. Push to the branch (git push origin feature-branch). 🚀
  5. Open a Pull Request. 📬

Project Contributors

Main Author 🧑‍💻

Contributing Author 🧑‍💻

For inquiries or feedback, please feel free to reach out via Telegram.

Ethical Notice 🔔

Ethics Reminder: Simply modifying a few lines of code does not constitute original authorship. When forking a project, always fork responsibly and give proper credit to the original creators.