Telegram Mass Moderator — smart cleaning without surprises.

The bot helps moderators not to "shoot at the squares," but to work precisely. First, it calculates where the user actually belongs, shows a dry summary, then allows selecting channels for action, and only after that performs ban/kick. No unnecessary blocks.
How it works:
• I upload a list of users (TXT/CSV/XLSX) or enter them manually.
• Dry-run — the bot calculates and shows who is in the target channels.
• I select a user → check the necessary channels.
• Action: Ban or "soft" Kick (with auto-unban).
• I receive a CSV report and a clean log. Temporary files are auto-deleted.

Features that are loved:
• It works with my contacts (via MTProto): finds those who are in the channels.
• Customizable sets of channels in channels.yml (whether 20 or 200 — no problem).
• Clear statuses and progress, without a "black box."
• Security by default: first audit, then action.

Technologies: Python 3.11, Aiogram 3, Telethon (MTProto), Pydantic 2, Loguru, YAML.