Patrick2562 / PYHABOT

hardverapro.hu hirdetésfigyelő
GNU General Public License v3.0
16 stars 7 forks source link

PYHABOT

A PYHABOT egy web scraping alkalmazás Pythonban, amely a Hardverapróra feltöltött hirdetéseket nézi át és küld értesítéseket egy új megjelenésekor, azokról amelyek megfelelnek az általunk megadott feltételeknek. Rendelkezik több integrációval is, amelyek segítségével parancsokon keresztül hozzáadhatóak és törölhetőek a keresni kívánt termékek.

Hogyan használd

Miután meghívtad a botot az általad használt platformon lévő szerverre/szobába, a lent listázott parancsokkal kezelheted. Egy új hirdetésfigyelő hozzáadásához elsőnek fel kell menni a Hardverapróra és rákeresni a termékre amit figyelni szeretnél. Érdemes a részletes keresést használni, beállítani a kategóriát, minimum és maximum árat. Ha ez megvan akkor a kattints a KERESÉS gombra és a találatok oldalon másold ki az URL-t, ezután a botnak kell elküldeni a következő parancsot: !add <Kimásolt URL> Ilyenkor felkerül a listára és láthatjuk a hirdetésfigyelő ID-jét (erre szükség lesz a többi parancs használatánál). Alapértelmezetten az értesítéseket abba a szobába fogja küldeni, ahol a parancs be lett írva, de meg lehet változtatni, ehhez használd a !notifyon <Hirdetésfigyelő ID> <Notification típus> [<args>] parancsot. Ha mindent megfelelően csináltál, akkor a bot innentől kezdve egy új hirdetés megjelenésekor értesítést küld. Ha szeretnéd átvizsgáltatni vele az eddigi hirdetéseket (amelyek a figyelő hozzáadása előtt is léteztek), akkor használd a !rescrape <Hirdetésfigyelő ID> parancsot.

Használat (Windows)

  1. Python telepítése. (letöltés)
  2. Repository letöltése és kicsomagolása. (letöltés)
  3. Parancssor megnyitása és navigálás a letöltött repositoryba: cd PYHABOT
  4. Szükséges modulok telepítése: pip install -r requirements.txt
  5. .env fájl létrehozása (.env.example másolata): copy .env.example .env
  6. .env config fájl megnyitása és kitöltése
  7. Indítás a python run.py paranccsal
  8. Bot meghívása a szerverre/szobába, és jogot adni neki az üzenetek olvasásához/küldéséhez. (Discord esetében az indításkor megjelenő linken keresztül)
  9. Hirdetésfigyelő hozzáadása: Hogyan használd szekcióban részletezve

Használat (Docker)

  1. Feltételezzük, hogy a Docker telepítve van és minimális ismeretekkel rendelkezel.
  2. .env fájl létrehozása (.env.example másolata): copy .env.example .env
  3. .env config fájl megnyitása és kitöltése
  4. Indítás a docker compose up -d paranccsal
  5. Bot meghívása a szerverre/szobába, és jogot adni neki az üzenetek olvasásához/küldéséhez. (Discord esetében az indításkor megjelenő linken keresztül)
  6. Hirdetésfigyelő hozzáadása: Hogyan használd szekcióban részletezve

Integrációk

Azonosító Leírás
discord Discord bot
telegram Telegram bot

Parancsok

Minden parancs elé ki kell tenni a prefixet, ez alapértelmezetten: ! (Például: !add) Parancs Leírás
help Listázza az elérhető parancsokat.
settings Megmutatja a bot beállításait.
add Felvenni lehet vele egy új hirdetésfigyelőt.
del Törölni lehet vele egy létező hirdetésfigyelőt.
list Listázza a felvett hirdetésfigyelőket.
info Meglehet vele nézni egy hirdetésfigyelő adatait.
notifyon Módosítani lehet vele, hogy hová küldje az értesítéseket egy adott hirdetésfigyelő.
rescrape Elfelejti az eddig átvizsgált hirdetéseket, ismételten átnézi az összeset és elküldi az értesítéseket. (Ha van megadva Hirdetésfigyelő ID akkor csak azt, egyébként mindegyiket átnézi.)
seturl Módosítani lehet egy hirdetésfigyelő URL-jét.
setprefix Módosítani lehet vele a parancs prefixet.
setinterval Belehet vele állítani hány másodpercenként ellenőrizzen.

Notification típusok

Típus Leírás
here Ide..., abba a szobába ahol a parancs be lett írva.
webhook POST requestet küld a megadott URL-re. DISCORD WEBHOOK-ot támogatja! (Paraméterek: username, avatar_url, content)