Telegram user bot: подготовлен целиком, ждёт api_id/api_hash

Telethon 1.45 установлен, скрипт читает каналы и отправляет сообщения в
шину ядра (telegram.post), состояние хранится между запусками — дублей нет.

Готово: конфиг-шаблон (600), юнит (не включён), cron каждые 15 минут с
проверкой TG_API_ID, фильтр по ключевым словам.

Проверено без ключей: завершается понятным сообщением, ничего не ломает.
Чтобы включить — заполнить /etc/hub-core/telegram.env и один раз войти
(код придёт в Telegram).
This commit is contained in:
buryan-agent committed 2026-10-19 20:03:59 +03:00
1 parent 253dd5ce2b
commit 454140adf8
4 files changed
+166

No files matched your search

+37
View File
@@ -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 остаются в безопасном состоянии.
+12
View File
@@ -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
+11
View File
@@ -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
+106
View File
@@ -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()))