Files
buryan-infra/ops/userbot/USERBOT.md
buryan-agent 3af6737511 Telegram userbot на втором номере: сервис, CLI и связка с книжным ботом
Второй аккаунт (+79105469668, id 6922233999) авторизован через Telethon
по api_id от mautrix. Работает через прокси CT161 (прямого интернета нет).

Что есть: CLI (whoami/dialogs/find/join/files/save) и HTTP-сервис на 9122
(/health, /files, /save), который скачивает файлы в /opt/books/ingest —
дальше Calibre-Web импортирует сам. В книжном боте появились /tg <запрос>
и /tg скачать N.

Выяснилось: публичные книжные каналы — витрины со ссылками на ботов, файлов
там нет. Нужны каналы, где книги выкладывают файлами, или книжный бот,
которому userbot будет писать запрос.

Ловушка: PowerShell добавляет BOM в файлы — Python падает на U+FEFF.
2026-10-21 11:53:56 +03:00

3.3 KiB
Raw Permalink Blame History

Telegram userbot (второй аккаунт)

Что подключено

Параметр Значение
Аккаунт Роман, +7 910 546-96-68, id 6922233999
Библиотека Telethon 1.45
Сессия /root/.telegram-userbot/second.session (права 600)
API api_id 39725134 (от mautrix-telegram)
Прокси http://192.168.1.161:7890 (прямого интернета у CT нет)
Сервис telegram-userbot.service, порт 9122

Возможности

CLI /opt/hub-core/userbot.py:

whoami                 — кто вошёл
dialogs [фильтр]       — список чатов
find <запрос>          — поиск публичных каналов
join <@канал>          — подписаться
files <запрос>         — поиск файлов в чатах, где состоит аккаунт
save <ссылка|id> [папка] — скачать файл

HTTP-сервис (для других ботов):

GET  /health
GET  /files?q=<запрос>     → список файлов
POST /save {"chat":…,"msg":…} → скачать в /ingest (автоимпорт Calibre-Web)

В книжном боте

/tg <название>        — поиск файлов в Telegram
/tg скачать 1         — скачать первый найденный

Скачанное попадает в /opt/books/ingest → Calibre-Web импортирует сам.

Что выяснилось про каналы

Публичные «книжные» каналы (@flibustabooks, @flibustast, @knigyuy и подобные) — витрины: в них фото и ссылки на ботов, файлов нет. Поэтому /tg пока пуст: искать негде.

Чтобы заработало, нужен один из вариантов:

  1. Дать ссылки на каналы/чаты, где книги реально выкладывают файлами — бот подпишется и будет искать там.
  2. Указать книжного бота (например, которым вы качаете вручную) — userbot будет писать ему запрос и забирать файл автоматически.

Ловушки

  1. BOM в файлах. PowerShell Set-Content -Encoding UTF8 добавляет BOM, Python падает с invalid non-printable character U+FEFF. Убирать: sed -i '1s/^\xEF\xBB\xBF//' file.
  2. Прямого интернета нет — Telethon обязательно через прокси CT161.
  3. Сессия = полный доступ к аккаунту. Хранить только на сервере, права 600, не коммитить.
  4. Публичные книжные каналы — реклама. Не подписываться на всё подряд: аккаунт начнёт получать спам.

Дальше

  • Список каналов в конфиге userbot + периодический поиск новинок.
  • Автопоиск продолжений серий Полины по её каталогу.
  • Уведомление в Matrix, когда нашлась нужная книга.