TgFeed · MTProto API для Husky Social Feed

# TgFeed · MTProto API для Husky Social Feed

Плагин платформы [HuskyServer](https://huskynet.ru/4528/): API последних постов каналов/чатов Telegram (Telethon) для плагина WordPress Husky Social Feed.

Возможности

• Запрос ленты по t.me/… (по умолчанию 5 постов, до 100).
• Формат ответа совместим с WP-плагином (id, content_html, fingerprint, …).
• Медиа через PUBLIC_API_URL (картинки/видео вместо заглушек).
• Веб-панель /tgfeed/, health JSON.

Требования

• Ядро HuskyServer.
• API_ID / API_HASH с my.telegram.org/apps.
• API_KEY — общий секрет с WordPress (придумываете сами).
• Однократный логин: login_once.py или login_qr.py.

Установка и запуск

sudo bash /home/projects/plugins/tgfeed/setup.sh
cp .env.example .env   # заполнить API_KEY, API_ID, API_HASH, PUBLIC_API_URL
cd /home/projects/plugins/tgfeed && . .venv/bin/activate && python login_once.py
sudo systemctl restart tgfeed

В WP: включить «Telegram через MTProto API», указать URL сервиса и тот же API_KEY. Подробные таблицы переменных и формы my.telegram.org — ниже в разделе «Ключи и WordPress».

Использование

Команда в чате WP вида feed t.me/durov → плагин дергает этот API. Панель: http://<IP>/tgfeed/.

Ключи и WordPress

| Переменная | Где | Куда |
|————|——|——|
| API_KEY | Придумать (openssl rand -hex 32) | .env на VPS и поле ключа в WP |
| API_ID / API_HASH | my.telegram.org/apps | только .env на VPS |
| PUBLIC_API_URL | Публичный URL API, напр. https://IP/tgfeed | .env (для медиа) |

На my.telegram.org: Platform = Other; App title/short name — произвольные.

Структура проекта

tgfeed/
├── plugin.json · setup.sh · tgfeed.service
├── app.py · tg_fetcher.py · tgfeed_web_panel.py · login_*.py
└── doc/

Технологии

Python, Flask, Telethon, systemd.

Платформа и соседние плагины

• Платформа: HuskyServer
• App Auth · Email Bot · Svetlana · TgFeed · VPN HAPP

История изменений

# Changelog

[Unreleased]

Changed

• Документация приведена к шаблону HuskyServer; README с перелинковкой на платформу и соседние плагины.

2026-06-08

• Исходники скопированы в /home/projects/plugins/tgfeed/ как новый целевой дом плагина.
• Runtime-пути в service/install/docs переключены на /home/projects/plugins/tgfeed/.
• Registry-манифест в /home/projects/plugins/tgfeed/.
• Общее меню через nav-api.