FunPay Hub

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

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

---

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

🚧 FunPayHub находится в активной стадии разработки.

Функционал активно расширяется. Могут иметься ошибки в работе, а так же изменения в поведении API. Если у вас есть пожелания по функционалу или информация об ошибках - напишите в Telegram - оперативно все сделаю.

---

Возможности

• 📈 Автоподнятие лотов
• 💬 Автоответы:
  • 💬 на личные сообщения;
  • 🌟 на отзывы: как в сам отзыв, так и в чат;
  • 🖐 на приветственные сообщения c возможностью кастомизировать сообщения в зависимости от просматриваемого лота;
• 📦 Автоматическая выдача товаров
• 🏷🏷️ Большое кол-во форматтеров с воможностью передавать параметры. Например: Привет, $message<username>! Вот твой заказ: $goods
• 🧩 Плагиная архитектура, позволяющая:
  • легко писать и поддерживать собственные плагины
  • делать их максимально функциональными
• 🧩 Репозитории плаигнов, позволяющие:
  • разработчикам держать все свои плаигны в одном месте
  • пользователям легко скачивать и обновлять плагины прямо из Telegram интерфейса без надобности ручной загрузки.
• 🎆 Кастомизация Telegram UI
• Многое другое

---

Для разработчиков

• 🧩 Проработанная система плагинов

В отличии от других проектов, в FunPay Hub плагины можно писать в модульном виде. Вся информация о плагине хранится в манифесте (manifest.json) с указанием точки входа. Используемые в FunPay Hub фреймворки (aiogram, funpaybotengine и др.), а так же сама архитектура FPH позволяет писать в плагинах качественный код, а не сплошные костыли.

• 🔘 Система параметров

Разработчикам плагинов больше не нужно думать о том, как и где хранить параметры. Просто создайте свое древо параметров с помощью готовых классов и передайте его FunPay Hub'у. FunPay Hub сам позаботится о сериализации, валидации и отображении параметров в Telegram UI!

• 🏷🏷️ Создание и модификация существующих меню

Каждое меню в FunPay Hub - это зарегистрированный в реестре объект построителя. Для любого построителя меню можно добавить модификатор, так же зарегистрировав его через реестр. Таким образом можно модифицировать уже существующие меню, легко добавляя свои кастомные элементы.

• 🔘 Поддержка пагинации в Telegram UI; Структура UI;

В FunPay Hub каждое меню состоит из клавиатуры и текста (в будущем: и из изображения). И клавиатура, и текст, разбиты на 3 секции:

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

---

Скриншоты

Telegram UI

Плагины

Уведомления

Прочее

---

Используемые технологии

FunPayHub построен на основе нескольких ключевых библиотек:

• FunpayBotEngine — фреймворк для разработки FunPay ботов;
• aiogram — фреймворк для разработки Telegram ботов;
• Eventry — фреймворк для создания событийной системы с роутерами, фильтрами, хэндлерами и т.п.;

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

---

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

В планах / рарзработке:

• 🧰 Многочисленные команды-утилиты, позволяющие управлять свои FunPay аккаунтом. Например:

  • управление лотами: массовое включение / отключение / копирование своих и чужих лотов.
  • сбор статистики аккаунта с графиками
  • и т.д.

• 🧩 Разработка плагинов в официальном репозитории.

• ♻️ Автообновление плагинов

• 🌐 REST API (в виде плагина)
  Для интеграции с внешними сервисами и панелями управления.

• 🖥 Web UI (в виде плагина)
  Веб-интерфейс для управления FunPay Hub.

• 🧰 GUI-установщик
  Установщик, позволяющий развернуть FunPayHub:

  • на текущем компьютере;
  • на удалённом сервере (VPS / dedicated).

---

Установка

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

Linux (Ubuntu / Debian / Arch linux)

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

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