From 454140adf863894cb2b83ad88d9ea4094a162b22 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Mon, 19 Oct 2026 20:03:59 +0300 Subject: [PATCH] =?UTF-8?q?Telegram=20user=20bot:=20=D0=BF=D0=BE=D0=B4?= =?UTF-8?q?=D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=BB=D0=B5=D0=BD=20=D1=86=D0=B5?= =?UTF-8?q?=D0=BB=D0=B8=D0=BA=D0=BE=D0=BC,=20=D0=B6=D0=B4=D1=91=D1=82=20ap?= =?UTF-8?q?i=5Fid/api=5Fhash?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Telethon 1.45 установлен, скрипт читает каналы и отправляет сообщения в шину ядра (telegram.post), состояние хранится между запусками — дублей нет. Готово: конфиг-шаблон (600), юнит (не включён), cron каждые 15 минут с проверкой TG_API_ID, фильтр по ключевым словам. Проверено без ключей: завершается понятным сообщением, ничего не ломает. Чтобы включить — заполнить /etc/hub-core/telegram.env и один раз войти (код придёт в Telegram). --- ops/telegram/README.md | 37 +++++++++++ ops/telegram/hub-telegram.service | 12 ++++ ops/telegram/telegram.env.example | 11 ++++ ops/telegram/telegram_userbot.py | 106 ++++++++++++++++++++++++++++++ 4 files changed, 166 insertions(+) create mode 100644 ops/telegram/README.md create mode 100644 ops/telegram/hub-telegram.service create mode 100644 ops/telegram/telegram.env.example create mode 100644 ops/telegram/telegram_userbot.py diff --git a/ops/telegram/README.md b/ops/telegram/README.md new file mode 100644 index 0000000..7251936 --- /dev/null +++ b/ops/telegram/README.md @@ -0,0 +1,37 @@ +# Telegram user bot (Telethon) + +Читает публичные каналы и складывает сообщения в шину ядра как события +`telegram.post`. + +## Что готово + +* `telethon 1.45.0` установлен на узле; +* скрипт `telegram_userbot.py`: подключение, чтение каналов, фильтр по + словам, состояние в `/var/lib/hub-core/telegram_state.json` + (повторно одни и те же сообщения не отправляет); +* конфиг-шаблон `/etc/hub-core/telegram.env` (600); +* юнит `hub-telegram.service` (oneshot) — не включён; +* cron `/etc/cron.d/hub-telegram` каждые 15 минут, запускается только + если `TG_API_ID` заполнен. + +## Что нужно, чтобы включить + +1. `api_id` и `api_hash` — https://my.telegram.org → API development tools. +2. Номер телефона и одноимённый код при первом входе (сессия сохранится + в `/var/lib/hub-core/telegram`). +3. Список каналов (`@name`) — в `TG_CHANNELS`. +4. Опционально `TG_KEYWORDS` — фильтр по словам. + +Заполнить `/etc/hub-core/telegram.env`, затем: + +``` +set -a; . /etc/hub-core/telegram.env; set +a +python3 /opt/hub-core/telegram_userbot.py # первый вход спросит код +``` + +После первого успешного входа cron подхватит сам. + +## Проверено без ключей + +Скрипт завершается строкой «не настроено: нужны TG_API_ID...» и не падает — +служба и cron остаются в безопасном состоянии. diff --git a/ops/telegram/hub-telegram.service b/ops/telegram/hub-telegram.service new file mode 100644 index 0000000..403681a --- /dev/null +++ b/ops/telegram/hub-telegram.service @@ -0,0 +1,12 @@ +[Unit] +Description=Buryan Hub — Telegram user bot +After=network-online.target hub-core.service +Wants=network-online.target hub-core.service + +[Service] +Type=oneshot +EnvironmentFile=/etc/hub-core/telegram.env +WorkingDirectory=/opt/hub-core +ExecStart=/usr/bin/python3 /opt/hub-core/telegram_userbot.py +StandardOutput=append:/var/log/hub-telegram.log +StandardError=append:/var/log/hub-telegram.log diff --git a/ops/telegram/telegram.env.example b/ops/telegram/telegram.env.example new file mode 100644 index 0000000..3e8e2da --- /dev/null +++ b/ops/telegram/telegram.env.example @@ -0,0 +1,11 @@ +# Telegram user bot. Заполнить и запустить службу. +# api_id/api_hash: https://my.telegram.org → API development tools +TG_API_ID= +TG_API_HASH= +TG_PHONE= +# каналы через запятую, например: @film_channel,@series_channel +TG_CHANNELS= +# необязательный фильтр по словам +TG_KEYWORDS= +TG_SESSION=/var/lib/hub-core/telegram +CORE_URL=http://127.0.0.1:9120 diff --git a/ops/telegram/telegram_userbot.py b/ops/telegram/telegram_userbot.py new file mode 100644 index 0000000..3bd111d --- /dev/null +++ b/ops/telegram/telegram_userbot.py @@ -0,0 +1,106 @@ +"""Telegram user bot: читает каналы и отдаёт их в шину ядра. + +Нужны api_id/api_hash (my.telegram.org), номер и код при первом входе. +Без них скрипт завершается с понятным сообщением — служба не падает. + +Настройки: /etc/hub-core/telegram.env + TG_API_ID=123456 + TG_API_HASH=abcdef... + TG_PHONE=+7921... + TG_CHANNELS=@channel1,@channel2 + TG_KEYWORDS=фильм,сериал,книга (необязательно: фильтр) + TG_SESSION=/var/lib/hub-core/telegram +""" +import asyncio +import json +import os +import sys +import urllib.request + +CORE = os.environ.get("CORE_URL", "http://127.0.0.1:9120") +STATE = "/var/lib/hub-core/telegram_state.json" + +API_ID = os.environ.get("TG_API_ID", "") +API_HASH = os.environ.get("TG_API_HASH", "") +PHONE = os.environ.get("TG_PHONE", "") +CHANNELS = [c.strip() for c in os.environ.get("TG_CHANNELS", "").split(",") if c.strip()] +KEYWORDS = [k.strip().lower() for k in os.environ.get("TG_KEYWORDS", "").split(",") if k.strip()] +SESSION = os.environ.get("TG_SESSION", "/var/lib/hub-core/telegram") + + +def load_state(): + try: + return json.load(open(STATE, encoding="utf-8")) + except OSError: + return {} + + +def save_state(state): + os.makedirs(os.path.dirname(STATE), exist_ok=True) + json.dump(state, open(STATE, "w", encoding="utf-8"), ensure_ascii=False) + + +def post_event(channel, message_id, text, when): + payload = { + "source": "telegram", + "type": "telegram.post", + "entity": {"kind": "канал", "key": f"tg:{channel}", + "title": f"{channel}: {(text or '')[:60]}"}, + "payload": {"detail": (text or "")[:1500], "message_id": message_id, "when": str(when)}, + } + req = urllib.request.Request(f"{CORE}/event", data=json.dumps(payload).encode(), + method="POST", headers={"Content-Type": "application/json"}) + try: + with urllib.request.urlopen(req, timeout=15) as r: + return r.status in (200, 201) + except Exception: + return False + + +def wanted(text): + if not KEYWORDS: + return True + low = (text or "").lower() + return any(k in low for k in KEYWORDS) + + +async def run(): + try: + from telethon import TelegramClient + except ImportError: + print("нет библиотеки telethon — установите: pip install telethon", flush=True) + return 1 + + if not (API_ID and API_HASH and PHONE and CHANNELS): + print("не настроено: нужны TG_API_ID, TG_API_HASH, TG_PHONE, TG_CHANNELS " + "в /etc/hub-core/telegram.env", flush=True) + return 1 + + state = load_state() + client = TelegramClient(SESSION, int(API_ID), API_HASH) + await client.start(phone=PHONE) + print(f"подключён как {PHONE}, каналов: {len(CHANNELS)}", flush=True) + + total = 0 + for channel in CHANNELS: + last_id = int(state.get(channel, 0)) + try: + msgs = await client.get_messages(channel, limit=20, min_id=last_id) + except Exception as e: + print(f"{channel}: ошибка {str(e)[:100]}", flush=True) + continue + for m in reversed(msgs): + text = m.message or "" + if not wanted(text): + continue + if post_event(channel, m.id, text, m.date): + total += 1 + state[channel] = max(state.get(channel, 0), m.id) + save_state(state) + await client.disconnect() + print(f"новых сообщений в шине: {total}", flush=True) + return 0 + + +if __name__ == "__main__": + sys.exit(asyncio.run(run()))