Script

Funpay Hub - the new best opensource bot for Funpay

Funpay Hub


GitHub Telegram

​

FunPayHub — это не просто бот, а полноценный инструмент для автоматизации продаж и рутинных действий на Funpay.

Проект создан для тех, кому нужен бесплатный, open-source и расширяемый бот с продуманной архитектурой и возможностью глубокой кастомизации под свои задачи.​

Возможности
• Автоподнятие лотов
• Автоответы:
  — на личные сообщения
  — на отзывы (в сам отзыв и в чат)
  — приветственные сообщения с кастомизацией под конкретный лот
• Автоматическая выдача товаров
• Гибкая система форматтеров с параметрами
Пример:

Привет, $message<username>! Вот твой заказ: $goods

Code

Привет, $message<username>! Вот твой заказ: $goods

• Плагинная архитектура
  — удобная разработка собственных плагинов
  — высокая гибкость и расширяемость
• Репозитории плагинов
  — разработчики могут хранить всё в одном месте
  — пользователи устанавливают и обновляют плагины прямо из Telegram
• Кастомизация Telegram UI
• И многое другое


Для разработчиков
• Продуманная система плагинов
Плагины можно писать модульно.
Вся информация хранится в

⁡manifest.json

⁡ с указанием точки входа.
Используемые фреймворки (

⁡aiogram

⁡ ,

⁡funpaybotengine

⁡ и др.) позволяют писать чистый, структурированный код без костылей.

• Система параметров
Создайте собственное дерево параметров и передайте его FunPayHub.
Сериализация, валидация и отображение в Telegram UI выполняются автоматически.

• Гибкая система меню
Каждое меню — зарегистрированный объект-построитель.
Можно добавлять модификаторы и расширять уже существующие меню без переписывания кода.

• Поддержка пагинации в Telegram UI; Структура UI;
В Funpay Hub каждое меню состоит из клавиатуры и текста (в будущем: и из изображения). И клавиатура, и текст, разбиты на 3 секции:
— загловок
— основная секция
— подвал

Это позволяет легко создавать структурированные меню с вомзожностью пагинации.
А пагинацию в FunPayHub можно добавить всего в 1 строку кода! Не нужно писать никакую логику, все за вас сделает FPH.


Скриншоты

Telegram UI

Плагины

Уведомления

Прочее

Используемые технологии
• FunpayBotEngine — фреймворк для разработки Funpay-ботов.
• aiogram — фреймворк для Telegram-ботов.
• Eventry — событийная система с роутерами и фильтрами.

Эта комбинация позволяет строить мощные и расширяемые приложения.


Планируемый функционал

• Команды-утилиты:
— массовое управление лотами
— сбор статистики с графиками
— и многое другое

• REST API (в виде плагина)
• Web UI (в виде плагина)
• GUI-установщик
— установка на ПК
— установка на VPS / dedicated сервер

• Естественно, куча плагинов в официальном репозитории


Установка
Установка Funpay Hub происходит буквально в 1 команду. Все сопуствующие зависимости, такие как Python и Git установятся автоматически.
Запуск Funpay Hub не требует указания golden_key, так что если вы просто хотите потыкать кнопки в Telegram и посмотреть что да как - это возможно.

Windows (PowerShell от имени администратора)

Set-ExecutionPolicy Bypass -Scope Process -Force; (iwr https://raw.githubusercontent.com/funpayhub/fph_install_scripts/refs/heads/main/install_fph.ps1).Content | iex

Code

Set-ExecutionPolicy Bypass -Scope Process -Force; (iwr https://raw.githubusercontent.com/funpayhub/fph_install_scripts/refs/heads/main/install_fph.ps1).Content | iex

Linux (Ubuntu / Debian / Arch)
curl:

curl -fsSL https://raw.githubusercontent.com/funpayhub/fph_install_scripts/refs/heads/main/install_fph.sh > install_fph.sh && chmod +x install_fph.sh && ./install_fph.sh

Code

curl -fsSL https://raw.githubusercontent.com/funpayhub/fph_install_scripts/refs/heads/main/install_fph.sh > install_fph.sh && chmod +x install_fph.sh && ./install_fph.sh

wget:

wget -qO install_fph.sh https://raw.githubusercontent.com/funpayhub/fph_install_scripts/refs/heads/main/install_fph.sh && chmod +x install_fph.sh && ./install_fph.sh

Code

wget -qO install_fph.sh https://raw.githubusercontent.com/funpayhub/fph_install_scripts/refs/heads/main/install_fph.sh && chmod +x install_fph.sh && ./install_fph.sh

P.S.
Ближайшие несколько месяцев буду дорабатывать и полировать Funpay Hub, после чего выведу общие модули, такие как Telegram UI, i18n и т.д. в отдельный SDK и сделаю приложения для других площадок. В теории будет имется бот для каждой торговой площадки с унифицированным UI и API, со схожим функционалом и возможностями. После чего, если все еще будет интересно, намучу какое-нибудь приложение с возможностью управлять всеми площадками из одного места, но это уже где-то в будущем.
Пока что в приоритете - написать десяток-другой плагинов, напилить разных команд-утилит, REST API и WEB UI - точно будут, потому что мне надо во frontend одной ногой (не хочу :(). Ну и всякие мелкие баги и недочеты, ближайшие несколько месяцев все это буду оперативно фиксить.

По всем вопросам, предложениям и т.д. - Telegram
И если вам понравилось, поставьте звездочку на гите

GitHub Telegram​