https://github.com/techunrestricted/kufar-telegram-notifier

https://github.com/techunrestricted/kufar-telegram-notifier

Last synced: 12 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/techunrestricted/kufar-telegram-notifier
• Owner: TechUnRestricted
• License: apache-2.0
• Created: 2021-10-11T19:00:58.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-08-26T22:28:57.000Z (over 3 years ago)
• Last Synced: 2023-08-23T00:07:02.910Z (over 2 years ago)
• Language: C++
• Size: 277 KB
• Stars: 10
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Kufar Telegram Notifier

Kufar Telegram Notifier - бот, который раз в заданное время ведет опрос официального Kufar API для поиска новых объявлений по заданным ключевым словам для последующей отправки результатов в Telegram чат.


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



Если Вы являетесь администрацией Kufar и у Вас имеются претензии к данному проекту - обращайтесь в раздел «Issues» для обратной связи.



   



Инструкция по сборке


   

      


         Linux

      

   

   


      
Установите g++: sudo apt-get install g++



      


         Установите curl: sudo apt-get install curl libcurl4-gnutls-dev

      

      


         Установите make и cmake: sudo apt-get install make cmake

      

      


         Загрузите исходный код последней версии программы:


      

      


         Распакуйте архив с исходным кодом программы

      

      
С помощью cd перейдите в директорию c проектом

      
Соберите исполняемый файл с помощью:


            cmake .


            make

      

   


   

      
macOS

   

   

      Через Xcode (через графический интерфейс)

      


         


            Загрузите исходный код последней версии программы:


         

         


            Распакуйте архив с исходным кодом программы

         

         


            Откройте Kufar Telegram Notifier.xcodeproj в Xcode

         

         


            В верхнем меню-баре выберите "Product" -> "Archive"

         

         


            В новом открывшемся окне нажмите "Distribute Content" -> "Built Products" -> "Next" -> "Export"

         

      

   

   

      Через Xcode Command Line Tools (через консольный интерфейс)

      


         


            Установите Xcode Command Line Tools: xcode-select —install

         

         


            Загрузите исходный код последней версии программы


         

         


            Распакуйте архив с исходным кодом программы

         

         
С помощью cd перейдите в директорию c проектом

        
Соберите исполняемый файл с помощью:


            cmake .


            make

        

      

   


Конфигурация программы


   

      Настройка kufar-configuration.json

   

   

      

         Telegram

      

      bot-token - токен вашего бота, который будет отправлять сообщения.


      chat-id - идентификатор чата, в который будут отправляться сообщения.

   

   

      

         Queries

      

      tag - поисковой запрос. (Опционально)


      only-title-search - осуществление поиска только в заголовках. (Опционально)

      

         

            Price (Опционально)

         

         min - минимальная цена (целочисленное значение в BYN). (Опционально)


         max - максимальная цена (целочисленное значение в BYN). (Опционально)

      

      language - язык. (Опционально)


      limit - ограничение на количество получаемых объявлений за один запрос. (Опционально)


      currency - валюта (Опционально)


      condition - состояние (новое / б/y). (Опционально)


      seller-type - тип продавца (частное лицо / компания). (Опционально)


      kufar-delivery-required - только с Kufar Доставкой. (Опционально)


      kufar-payment-required - только с Kufar Оплатой. (Опционально)


      kufar-halva-required - только с Kufar Рассрочкой (Халва). (Опционально)


      only-with-photos - только с фото. (Опционально)


      only-with-videos - только с видео. (Опционально)


      only-with-exchange-available - только с возможностью обмена. (Опционально)


      sort-type - тип сортировки. (Опционально)


      category - категория. (Опционально)


      sub-category - подкатегория. (Опционально)


      region - номер региона для поиска объявлений. (Опционально)


      areas - номера областей для поиска объявлений. (Опционально)

   

   

      

         Delays

      

      query - задержка (в секундах) перед переходом к следующему поисковому запросу.


      loop - задержка (в секундах) перед повторением поиска по очереди с начала.


   

     

         Настройка cached-data.json

     

Настраивать данный файл не нужно.


Достаточно убедиться в том, что он представляет из себя валидный JSON файл со структурой [] (массив).


Предназначение: хранит в себе идентификаторы отправленных объявлений для предотвращения повторной отправки при перезапуске программы.

Запуск:

   

      

         Вариант с указанием путей к файлам конфигурации и кеша.

      

      bin/Kufar-Telegram-Notifier --config="/путь/к/kufar-configuration.json" --cache="/путь/к/cached-data.json"

   

   

      

         Вариант с автоматическим поиском файлов конфигурации (kufar-configuration.json) и кеша (cached-data.json) в папке с программой.
(Необходимо поместить kufar-configuration.json и cached-data.json в папку с программой)

      

      bin/Kufar-Telegram-Notifier