https://github.com/funpayhub/funpayhub
Мощный расширяемый бот для автоматизации FunPay.
https://github.com/funpayhub/funpayhub
api bot funpay funpay-bot funpayapi funpaybot funpaybotengine funpayparsers hub parsers telegram
Last synced: 2 months ago
JSON representation
Мощный расширяемый бот для автоматизации FunPay.
- Host: GitHub
- URL: https://github.com/funpayhub/funpayhub
- Owner: funpayhub
- Created: 2025-08-19T10:06:37.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2026-04-20T12:14:06.000Z (2 months ago)
- Last Synced: 2026-04-20T12:33:33.378Z (2 months ago)
- Topics: api, bot, funpay, funpay-bot, funpayapi, funpaybot, funpaybotengine, funpayparsers, hub, parsers, telegram
- Language: Python
- Homepage: https://t.me/funpay_hub
- Size: 2.11 MB
- Stars: 17
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
FunPay Hub
**FunPayHub** — это не просто бот, а полноценный инструмент для автоматизации продаж и рутинных действий на FunPay.
Проект создан для тех, кому нужен **бесплатный, опенсорсный и расширяемый** бот с продуманной архитектурой и возможностью глубокой кастомизации под свои задачи.
---
Статус проекта
--------------
🚧 **FunPayHub находится в активной стадии разработки.**
Функционал активно расширяется. Могут иметься ошибки в работе, а так же изменения в поведении API.
Если у вас есть пожелания по функционалу или информация об ошибках - [напишите в Telegram](https://t.me/funpay_hub) - оперативно все сделаю.
---
Возможности
-----------
- 📈 **Автоподнятие лотов**
- 💬 **Автоответы**:
- 💬 на личные сообщения;
- 🌟 на отзывы: как в сам отзыв, так и в чат;
- 🖐 на приветственные сообщения c возможностью кастомизировать сообщения в зависимости от просматриваемого лота;
- 📦 **Автоматическая выдача товаров**
- 🏷🏷️ **Большое кол-во форматтеров с воможностью передавать параметры.** Например:
```Привет, $message! Вот твой заказ: $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](https://github.com/funpayhub/funpaybotengine) — фреймворк для разработки FunPay ботов;
- [aiogram](https://github.com/aiogram/aiogram) — фреймворк для разработки Telegram ботов;
- [Eventry](https://github.com/qvvonk/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 -UseBasicParsing).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
```