Files
buryan-infra/ops/userbot/USERBOT.md
T
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

73 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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, когда нашлась нужная книга.