Standalone-гайд · ~15 минут чтения · ~вечер на настройку

Свой Telegram-клиент для комментов и лички — легальный API за вечер

Дисклеймер. Гайд технический и ознакомительный, это личный опыт автора. Описан официальный путь Telegram (получение api_id на my.telegram.org), который используется для своего аккаунта и органического вовлечения по-человечески: несколько осмысленных комментариев в день, паузы, никаких массовых рассылок и накруток. Блокировки в Telegram прилетают за поведение (спам, сотни действий в час), а не за сам ключ. Соблюдай пользовательское соглашение Telegram и законодательство РФ, выбор и риски остаются на стороне пользователя. Автор не призывает к спаму и нарушениям.
Цель: твой Telegram-аккаунт умеет из скрипта читать каналы, ставить лайки, оставлять осмысленные комментарии и отвечать в личке, причём легально, через официальный API (способ, которым одна программа дёргает Telegram напрямую, без кнопок интерфейса).
Нужно: прогретый аккаунт Telegram, Firefox, IDE с ИИ-агентом (IDE, то есть программа-редактор для кода: берём Antigravity или VS Code + Claude Code), вечер свободного времени.

Комментирование, лайки, чтение и личка «из кода» работают через Telethon. Это библиотека-клиент Telegram на Python: маленькая программа, которая управляет аккаунтом вместо тебя. Чтобы Telethon подключился к аккаунту, нужны два ключа: api_id (число) и api_hash (строка из 32 символов). Их выдаёт сам Telegram на официальном сайте my.telegram.org. Это штатный путь для разработчиков, прописанный в документации Telegram, а не серая схема: ключ официальный, аккаунт твой.

И главное: код руками ты не пишешь. Всю настройку (сессию, скрипты, авто-вступление в обсуждения) собирает ИИ-агент в Antigravity или Claude Code — нейросеть, которой ты словами ставишь задачу, а она сама правит файлы и запускает команды. Ты вставляешь готовый промпт (текст задачи для нейросети), агент делает остальное через терминал. В этом и суть подхода MWB: предприниматель строит инструменты через ИИ, а разработчика не нанимает. Один шаг придётся сделать руками, это получение api_id на сайте Telegram, его не автоматизируешь. Всё прочее берёт на себя агент.

Зачем свой API и почему это легально

4 факта, чтобы не бояться

  1. Это официальный путь. api_id / api_hash с my.telegram.org это штатный механизм Telegram для разработки клиентов (core.telegram.org/api/obtaining_api_id). Так делает любой, кто пишет на Telethon.
  2. Ключ привязан к твоему аккаунту. Клиент действует от твоего имени: читает, лайкает, комментит, пишет. Ровно то же, что ты можешь руками, только из скрипта.
  3. Бан прилетает за поведение, а не за ключ. Блокировки даёт массовый спам и сотни действий в час, а не сам факт получения api_id. По-человечески (5–8 комментов в день, паузы) аккаунту ничего не грозит.
  4. Код пишет агент. Antigravity и Claude Code собирают клиента под диктовку промпта. Ты тут заказчик, не программист.

Часть 0: прогреть аккаунт (за день до)

Telegram не выдаёт API на «пустой свежак». Аккаунт, с которого берём ключ, должен выглядеть живым. На это уйдёт минут 10.

Минимум перед получением ключа

  1. Возраст хотя бы несколько дней (лучше неделя и больше).
  2. 5+ подписок на любые публичные каналы.
  3. 5–10 реакций / лайков на посты.
  4. 1–2 реальные переписки (хоть один обмен сообщениями).
  5. Аватарка установлена, имя и фамилия заполнены.
  6. Проверь, что не в бане: напиши @SpamBot/start. Нужно «Your account is free». Если «limited», ключ сегодня не дадут, ждём разлока.

Часть 1: получить api_id через Firefox (единственный ручной шаг)

В России my.telegram.org часто не открывается из-за блокировок, поэтому порядок именно такой: через Firefox с чистым отпечатком. Отпечаток, по которому сайт узнаёт твой браузер, в приватном окне выглядит «незнакомым».

Окружение

  1. Закрой Chrome, где залогинены другие Telegram-аккаунты. Открой Firefox в приватном окне, чтобы отпечаток браузера был чистый.
  2. VPN и Cloudflare WARP полностью выключить. WARP в РФ режется на DPI (умная блокировка по содержимому трафика), с ним к Telegram не достучаться.
  3. Если сайт не открывается, открой как админ файл C:\Windows\System32\drivers\etc\hosts (системный файл-справочник «какому адресу какой IP») и допиши строку:
    149.154.167.220 my.telegram.org
    Так браузер пойдёт к Telegram напрямую, в обход блокировки. Сохрани. Если сайт и так открылся, шаг пропусти.

Логин: в Firefox-приватном открой https://my.telegram.org/auth, введи номер телефона аккаунта. Код придёт пушем в само приложение Telegram (не SMS). Введи код, затем пароль 2FA (двухфакторная защита, тот самый второй пароль на вход в Telegram, если ты его включал).

Дальше: раздел API development toolsCreate new application. Заполни ровно так, потому что формат полей решает, дадут ключ или вернут ERROR:

Поля формы (критично)

  • App title: DailyNotesReader, в стиле UpperCamelCase, без пробелов и цифр.
  • Short name: dailynotesreader, можно то же слово, что в title.
  • URL: оставить пустым.
  • Platform: Desktop.
  • Description: Personal reader to follow public channels and save notes for myself, длина от 40 до 110 символов.
Что валит форму: слово telegram, bot, marketing, auto в названии; эмодзи, цифры, подчёркивания и дефисы в Short name. Используй нейтральные имена.

Нажми Create application, и только один раз.

Часть 2: превратить ключи в сессию (это уже делает агент)

Сами по себе api_id / api_hash ничего не комментируют. Нужен session-файл: «вошедший» Telethon-клиент, который помнит, что аккаунт авторизован. Делается один раз, и тут уже работает агент.

Прокси: где купить (нужен для России)

Telegram и t.me в РФ режутся на DPI, поэтому клиенту нужен прокси, промежуточный сервер за границей, через который идёт трафик (строка TELEGRAM_PROXY в файле .env ниже). Подойдёт любой индивидуальный IPv4 с авторизацией. Тот, на котором сижу сам:

🌐
px6.me, индивидуальные IPv4-прокси
120 ₽/мес за один IP «в одни руки», без шумных соседей. Получаешь четыре строки (host, port, login, password), из них и собирается строка прокси. Открой по ссылке, проверь актуальные тарифы.
Партнёрская ссылка автора
Промокод на скидку: p4eXRoOU5W, вводится при оформлении заказа. Реферальный: тебе скидка, мне копейка за приглашение.

Что брать: IPv4, HTTP/HTTPS с Basic Auth (вход по логину и паролю, тип SOCKS5 не подойдёт), страна США или Европа, «в одни руки», аренда от 1 месяца. Из четырёх строк собирается значение для .env:
TELEGRAM_PROXY=http://login:password@host:port

Сначала складываешь данные в файл .env (текстовый файл, где программа хранит свои настройки и пароли):

.env, твои значения
TELEGRAM_API_ID=12345678
TELEGRAM_API_HASH=abcdef1234567890abcdef1234567890
ACCOUNT_PHONE=+7XXXXXXXXXX
SESSION_PATH=my_account.session
TELEGRAM_PROXY=http://user:pass@host:port      # для РФ — иначе Telegram режется

Дальше открываешь агента в Antigravity или VS Code + Claude Code и вставляешь промпт. Агент сам поставит Telethon в venv (отдельная песочница для Python, чтобы установка не мусорила в системе), напишет скрипт авторизации и создаст сессию:

Промпт #1 · создать сессию (вставить в Antigravity / Claude Code)
Я на Windows, у меня есть .env с TELEGRAM_API_ID, TELEGRAM_API_HASH, ACCOUNT_PHONE,
SESSION_PATH и TELEGRAM_PROXY. Нужно один раз авторизовать Telethon-клиента (мой аккаунт)
и создать session-файл. Действуй автономно через PowerShell:

1. Поставь telethon в venv (если venv нет — создай).
2. Напиши скрипт auth.py из двух шагов, чтобы я мог ввести код не вслепую:
   - режим --send-code: подключается через прокси из TELEGRAM_PROXY, шлёт код на ACCOUNT_PHONE
     (код придёт пушем в приложение Telegram), сохраняет phone_code_hash во временный файл.
   - режим --verify --code XXXXX [--password 2FA]: логинится с кодом и при необходимости 2FA,
     создаёт session-файл по SESSION_PATH.
3. Запусти --send-code, скажи мне посмотреть код в Telegram.
4. После того как я дам код — запусти --verify, подтверди что вошли (выведи мой @username и id).

Пароль 2FA и код в чат не дублируй. Прокси бери из TELEGRAM_PROXY.
Результат: появится файл my_account.session. Это и есть «ключ к комментированию»: с ним Telethon-клиент работает от имени твоего аккаунта.

Часть 3: читать и комментить

С сессией клиент уже умеет читать каналы, ставить лайки, отвечать в личке и комментировать посты. Один нюанс: чтобы коммент ушёл в канал, аккаунт должен состоять в чате-обсуждении этого канала. Это делается автоматически. Агент закладывает логику «поймал ошибку „join the discussion group“ → вступил → повторил отправку».

Снова промпт, и агент соберёт простой проверочный скрипт:

Промпт #2 · тестовый коммент (вставить агенту)
Используя готовую Telethon-сессию (SESSION_PATH) и прокси из .env, собери скрипт comment.py:

1. Подключается к Telegram через прокси.
2. Читает последние ~15 постов публичного канала, ссылку на который я передам аргументом.
3. Печатает их, чтобы я выбрал пост для коммента.
4. По выбранному посту отправляет комментарий в чат-обсуждение (comment_to=msg_id).
   Если Telegram вернёт ошибку «join the discussion group» — сам вступи в привязанный
   чат-обсуждение и повтори отправку. Если обсуждение «по заявке» — пропусти и скажи мне.
5. Тон коммента — человеческий, по делу, без ссылок и саморекламы. Один коммент за запуск.

Действуй автономно, отчитайся ссылкой на опубликованный коммент.
Два правила, чтобы аккаунт жил долго. (1) Прокси в РФ обязателен, Telegram и t.me режутся DPI, без него скрипт ловит таймауты. (2) Действуй по-человечески, то есть несколько осмысленных комментов в день, паузы, без массовых рассылок. Часть каналов держит обсуждение «по заявке»: туда коммент без одобрения админа не уйдёт, это нормально.
Заметь: ты не написал ни строчки кода, всё собрал агент в Antigravity / Claude Code по двум промптам. Это и есть vibe coding для бизнеса (когда нужный инструмент ты описываешь словами, а код собирает нейросеть): своя приблуда под задачу за вечер, без программиста.

Путь 2: когда my.telegram.org не даёт ключ

Если форма раз за разом возвращает ERROR или сайт вообще не открывается, есть обходной маршрут. У официального Telegram Desktop есть публичные ключи, которые Telegram открыл ещё на этапе бета-тестирования: api_id = 2040, api_hash = b18441a1ff607e10a989891a5462e627. Их используют тысячи разработчиков Telethon. Для личного использования они тоже подходят.

Смысл простой: вместо регистрации своего приложения берёшь уже зарегистрированные ключи Telegram Desktop. Вход при этом остаётся по твоему номеру и коду из приложения. Telegram не считает это нарушением, это штатная история для разработчиков.

В .env вместо своих ключей ставишь публичные:

Значения в .env для этого пути

TELEGRAM_API_ID=2040
TELEGRAM_API_HASH=b18441a1ff607e10a989891a5462e627
ACCOUNT_PHONE=+7XXXXXXXXXX
SESSION_PATH=my_account.session
TELEGRAM_PROXY=http://user:pass@host:port

Дальше всё как в Части 2: вставляешь Промпт #1 агенту, он проводит авторизацию через код из приложения и сохраняет session-файл. Никакой разницы с точки зрения работы скрипта.

Если запускаешь на сервере (VPS), агент попросит тебя продиктовать код в терминал. Это тот же самый вход по номеру и коду, что и в обычном Telegram, только управляет им скрипт, а не приложение. Telegram выдаёт session-строку, и больше код запрашивать не нужно.

Session-файл = полный доступ к аккаунту. Держи его только у себя: права 600 на Linux, не коммить в git. Отозвать в любой момент: Telegram → Настройки → Устройства → найти сессию и завершить.

Косяки и FAQ

Что может пойти не так

На форме ERROR или «Sorry, too many tries»

Не нажимай Create повторно, каждый клик удлиняет блок. Закрой вкладку, подожди 24 часа, повтори с другим именем приложения и в другом браузере (Firefox → Edge). Формат полей строго UpperCamelCase, без слова telegram/bot/marketing.

my.telegram.org не открывается

Выключи VPN и Cloudflare WARP полностью. Добавь в hosts строку 149.154.167.220 my.telegram.org. Открывай в Firefox-приватном. Повтори 2–3 раза, иногда заходит не с первого.

Скрипт ловит таймауты / Telegram недоступен

В РФ нужен рабочий прокси (строка TELEGRAM_PROXY в .env). Без него и сам Telegram, и t.me режутся. Как поднять дешёвый личный прокси, расписано в гайде про Claude без VPN, механика та же.

Коммент не отправляется

Либо у канала обсуждение «по заявке» (нужно одобрение админа, туда не уйдёт), либо у поста нет привязанного чата-обсуждения. Это нормально, берёшь следующий канал. Авто-вступление в открытые обсуждения агент уже заложил.

Аккаунт молодой, дадут ли API

3–6 дней при живой активности (подписки, лайки, переписка) обычно хватает. Важнее другое: страна IP совпадает со страной номера, браузер чистый, поля формы заполнены в нужном формате.

Не получается или хочешь, чтобы помогли настроить? Напиши мне в личку, @kulievvb, дам подробную пошаговую инструкцию и помогу пройти весь путь. Спокойно обращайся, это нормально.

Что почитать дальше

Если зашло, на сайте много бесплатного по теме «делаю инструменты через ИИ, без программиста»:

Подписывайся на канал @MWBclub, там много полезного: разборы, рабочие промпты и часть материалов клуба в открытом доступе. А MWB Club это уже закрытое сообщество с разборами и поддержкой.

Связаться по делу

Заявка прилетит мне и в Telegram, и на почту. Отвечу в течение рабочего дня.

Куда удобнее ответить?
или сразу написать в Telegram →

Нажимая кнопку, даёте согласие на обработку персональных данных (оператор № 23-25-044738).