sidor0912/FunPayCardinal

sidor0912/FunPayCardinal has 515 GitHub stars and 116 forks. GitHot measured 0 stars in 24 hours and +7 in 7 days. Last checked 2026-11-09 16:38 UTC. Last push 2026-09-24.

How these counts are measured

🐦 Бот для упрощения взаимодействия продавцов с биржей FunPay

515 stars 116 forks

Measured star growth

in 24h: 0
in 7 days: +7
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

FunPay Cardinal

Простой и эффективный бот для автоматизации FunPay

Перед началом настоятельно рекомендую залететь в наш Telegram чат (клик). Тут и поможем чем сможем и посидеть можно.

:clipboard: Содержание

:robot: Возможности

:shopping_cart: FunPay

Автовыдача товаров.
Автоподнятие лотов.
Автоответ на заготовленные команды.
Автовосстановление лотов после продажи.
Автодеактивация лотов, если товары закончились.
Вечный онлайн.
Уведомления в телеграм.
Полноценная ПУ в Telegram.

:left_speech_bubble: Уведомления и ПУ в Telegram

Возможность установки нескольких чатов для уведомлений.
Уведомления о поднятии лотов.
Уведомления о новых заказах.
Уведомления о выдаче товара.
Уведомления о новых сообщениях
Возможность отвечать на сообщения прямо из Telegram.
Возможность полностью настраивать автовыдачу / автоответчик и все остальные модули FPC.
Возможность добавлять автовыдачу для лотов, получая лоты прямо с FunPay.

:gear: Дополнительные возможности

Использование переменных в тексте для автоответа / автовыдачи.
Создание плагинов для кастомизации функционала без редактирования исходного кода самого Кардинала.

:1st_place_medal: Преимущества

:grinning: Для пользователей

Больше, чем наличие самого нужного функционала.
Оптимизация. 20 МБ свободного места на диске, до 50 МБ ОЗУ, доступ в интернет - все что нужно для работы.
Возможность установить на любую платформу, которую поддерживает Python: Windows, Linux, IOS, Android и т.д.
Возможность установки плагинов дает огромную вариативность модификации стандартного функционала под самые разные нужды.
Гибкие и при этом простые конфиги, написанные в INI-формате.
Постоянные обновления, быстрое реагирования на баги / предложения о новом функционале.
Полное управление через Telegram.

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

Выбран самый простой и при этом один из самых мощных языков для такого рода приложений - Python.
Полная документация кода. Все классы / методы / функции имеют док-строки, type-хинты.
Широкое использование ООП. Почти каждый эвент / сообщение / заказ и т.д. представляют собой экземпляр соответствующего класса, а не просто набор данных в JSON.
Возможность легкого создания плагинов.
Сконфигурированный логгер. Никаких принтов!
Собственный Python-пакет FunPayAPI, который никак не привязан к FunPay Cardinal.
Поддержка лично от меня :)

:electric_plug: Плагины

Канал с плагинами

:arrow_down: Установка

Арендовать виртуальный сервер можно на FirstByte. Выбирайте Ubuntu 22-24 версии, остальные параметры не важны.

:large_blue_diamond: Windows

Скачайте и установите Python 3.11.0.
1. При установке поставьте галочку у Add python.exe to PATH на первом экране установки.
Скачайте FunPay Cardinal
Перенесите архив FunPayCardinal-main.zip в нужное Вам место и распакуйте его.
Перейдите в папку FunPayCardinal-main.
Запустите файл Setup.bat. Дождитесь окончания загрузки пакетов.
Закройте командную строку и запустите файл Start.bat.

:hotsprings: Linux (Ubuntu)

Выполните команду: wget https://raw.githubusercontent.com/sidor0912/FunPayCardinal/main/install-fpc.sh -O install-fpc.sh && bash install-fpc.sh
Следуйте инструкциям установщика. Данный скрипт автоматически установит всё необходимое и запустит бота как фоновый процесс.

:whale: Docker

Установите Docker Desktop (Windows/Mac) или Docker Engine + Docker Compose (Linux) и запустите его.
Скачайте FunPay Cardinal и распакуйте архив, либо склонируйте репозиторий.
Перейдите в папку проекта и соберите образ:
```
docker compose build
```
При первом запуске Кардинал запросит настройки (логин, токены и т.д.) через консольный ввод, поэтому для первичной настройки запустите разовый интерактивный контейнер:
```
docker compose run --rm funpaycardinal
```
Отвечайте на вопросы мастера настройки прямо в этом окне.
Теперь можно запускать бота в фоне:
```
docker compose up -d
```
Полезные команды:
- Логи: docker compose logs -f
- Подключиться к консоли запущенного контейнера: docker attach funpaycardinal (отключиться без остановки контейнера — Ctrl+P, затем Ctrl+Q).
- Остановить: docker compose down.
Папки configs, logs, storage и plugins монтируются с хоста внутрь контейнера, поэтому все данные сохраняются между перезапусками и пересборками образа.

:electric_plug: Установка плагинов

Не устанавливайте плагины из непроверенных источников. Через систему плагинов злоумышленники могут получить полный доступ к Вашему устройству или аккаунту FunPay. Установка плагинов крайне проста.

Введите команду /menu в диалоге с ботом Telegram.
Нажмите кнопку 🧩 Плагины.
Нажмите кнопку ➕ Добавить плагин.
Отправьте или перешлите боту файл плагина.

:question: Мне нужна помощь

Если у вас остались какие-либо вопросы, мы с радостью ответим на них в нашем Telegram чате.

:star: Star it

Если вам удобно пользоваться FunPay Cardinal, не забудьте поставить :star: звезду :star: данному проекту в правом верхнем углу GitHub-страницы (нужно быть авторизованным в свой аккаунт) :)