Как установить FunPay Cardinal: пошаговая инструкция

Что понадобится до начала

• Аккаунт продавца на FunPay с активными лотами
• Python версии 3.9 или новее — бот написан на Python
• Компьютер на Windows или Linux, либо хостинг, если бот должен работать круглосуточно
• Telegram-аккаунт — через него вы управляете ботом

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

Шаг 1. Скачать Cardinal

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

Путь с кириллицей — самая частая причина, по которой бот не запускается у новичков. Папка вида C:\Cardinal подойдёт, а «Рабочий стол\Мои файлы\бот» может привести к ошибке.

Шаг 2. Получить golden_key

golden_key — это ключ авторизации вашего аккаунта FunPay. Бот использует его, чтобы работать от вашего имени: видеть заказы, отвечать в чатах и поднимать лоты.

Ключ хранится в cookie браузера. Откройте FunPay, войдите в аккаунт, вызовите инструменты разработчика клавишей F12, перейдите в раздел хранилища cookie для домена funpay.com и скопируйте значение параметра golden_key.

golden_key даёт полный доступ к вашему аккаунту FunPay. Никому его не передавайте и не публикуйте на форумах. Если ключ утёк — смените пароль на FunPay, старый ключ сразу перестанет действовать.

Шаг 3. Первый запуск и настройка

После этого настройки сохраняются в конфигурационный файл, и при следующих запусках вводить их заново не нужно.

1. Установите зависимости — в папке с ботом выполните команду установки из файла requirements.txt
2. Запустите Cardinal основным файлом проекта
3. При первом запуске бот попросит golden_key — вставьте скопированное значение
4. Укажите токен Telegram-бота: создайте своего бота через @BotFather и вставьте выданный токен
5. Откройте своего Telegram-бота и отправьте команду запуска — Cardinal ответит и покажет меню управления

Шаг 4. Проверить, что всё работает

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

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

Частые ошибки при установке

• Русские буквы или пробелы в пути к папке бота — переместите Cardinal в простой путь без кириллицы
• Устаревшая версия Python — обновите до 3.9 или новее
• Неверно скопированный golden_key — берите значение целиком, без пробелов по краям
• Бот запущен, но не отвечает в Telegram — проверьте токен от @BotFather и что вы пишете именно своему боту
• Cardinal стартует и сразу закрывается — запускайте из командной строки, чтобы увидеть текст ошибки