apqlzm / medihunter

Find Medicover appointments

medihunter

Narzędzia służy do automatycznego wyszukiwania wizyt u lekarzy. Szczególnie przydaje się gdy wizyty są trudno dostępne ;)

Działa z pythonem w wersji 3.6+

Wstęp

Dostępne są dwie wersje skryptu

• medihunter_pushover.py - ma funkcje powiadomień pushover, możliwość wyszukiwania kilku klinik i kilku specjalistów jednocześnie. Kod wymaga refaktoru i w związku z tym nie będzie rozwijany. Z czasem planuje go usunąć.
• medihunter.py - tu dodawane są nowe funkcjonalności. Na chwilę obecną (2021-07-11) można ustawić powiadomienia pushover, w telegramie i przez xmpp.

Instalacja

Aktywujemy virtualenva (opcjonalnie choć zalecane)

source /path/to/my/virtualenv/bin/activate

lub w Windows cmd ze środowiskiem wirtualnym utworzonym biblioteką venv

SourceToVirtEnv\Scripts\activate.bat

Przechodzimy do katalogu ze źródłem i odpalamy

pip install --editable .

Od teraz mamy dostępną w virtualenvie komendę: medihunter

Jeśli nie chcemy być za każdym razem pytani o login i hasło i/lub nie chcemy podawać ich jawnie w terminalu poprzez --user login --password hasło to możemy zapisać je w pliku .env:

MEDICOVER_USER=login
MEDICOVER_PASS=hasło

Najprościej skopiować przykładowy plik .env.example z głównego katalogu jako .env i uzupełnić w nim dane.

Dostępne subkomendy

show-params

Gdy wyszukujemy wizyty musimy podać miasto, placówkę medyczną, specjalizację (jaki to ma być lekarz), identyfikator lekarza (możliwość wybrania konkretnego lekarza), datę wizyty (wizyta zacznie się nie wcześniej niż ta data). Każdy z tych parametrów (z wyjątkiem daty) ma przypisany nr id. Żeby go poznać używamy do tego komendy show-params.

id miast

medihunter show-params -f region

id specjalizacji

medihunter show-params -f specialization -r 204

find-appointment

Poszukajmy endokrynologa

medihunter find-appointment -s 27962

Oczywiście znalezienie wizyty do endokrynologa nie jest takie proste, więc ustawmy żeby wyszukiwarka sprawdzała czy jest coś dostępne co 5 minut

medihunter find-appointment -s 27962 -i 5

a może chcemy poszukać konkretnych endokrynolgów o ID: 12345 i 0987? tylko w medicover_pushover.py

medihunter find-appointment -s 27962 -o 12345 -o 0987

a może po prostu szukamy dowolnego internisty w przychodniach blisko nas w Atrium i na Prostej? tylko w medicover_pushover.py

medihunter find-appointment -s 9 -c 174 -c 49088

a co jeśli chcemy znaleźć wizytę u dowolnego ortopedy w Trójmieście w przeciągu następnych dwóch tygodni a nie za miesiąc? bez daty rozpoczęcia nie działa

medihunter find-appointment -s 163 -d 2021-12-19 -f 2022-12-31 -r 200

Lub można dodać bezpośrednio do Crontaba jak poniżej wpis w cronie działa tylko z medicover_pushover.py

• będzie uruchamiany między 6tą a 23cią co 5 minut
• -s - szuka Ortopedy dla dorosłych
• -c 174 -c 6896 tylko w centrum Warszawa Atrium i Warszawa Inflancka Będzie korzystał z podanych parametrów użytkownika Medicoveru i Pushover do wysyłania powiadomień
• crontab zapisze logi w /var/log/medihunter.log

*/5 6-23 * * * /usr/bin/python3.7 /home/user/medihunter.py find-appointment -s 163 -c 174 -c 6896 --user MEDICOVER_USER --password MEDICOVER_PASS --pushover_msgtitle 'Ortopeda Centrum' --pushover_token PUSHOVER_TOKEN --pushover_user PUSHOVER_USER >> /var/log/medihunter.log 2>&1

my-plan

Ściąga i zapisuje dostępne usługi wraz z informacjami na temat tego czy są dostępne w ramach wykupionego pakietu, a jeśli nie to czy mamy na nie jakieś zniżki. Niektóre usługi mają limity, to też powinno być tu widoczne. Plik wynikowy ma format tsv (Tab-separated_values). Przykład użycia:

medihunter my-plan --user mylogin --password mypassword

Wyświetlanie pomocy

Ogólna pomoc

medihunter --help

Poszczególne subkomendy

medihunter find-appointment --help
medihunter show-params --help

Powiadomienia Pushover

dotyczy medicover_pushover.py

Poprzez podanie parametrów do powiadomień Poshover https://pushover.net/ możliwe jest przekazywanie powiadomień na wizytę bezpośrednio do aplikacji. Należy podać minimalnie parametry --pushover_token oraz --pushover_user

Domyślne ustawienia

show-params

domyślnie -f jest ustawiony na specialization

find-appointment

TODO: Poniższe opcje aktualne tylko dla medihunter_pushover.py

opcja	domyślna wartość
-r, --region	Warszawa
-b, --bookingtype	2, Typ wizyty 2 = Konsultacja (domyślnie), 1 = Badanie diagnostyczne
-s, --specialization	brak Specjalizacja, podać w przypadku gdy Typ wizyty to Konsultacja (bookingtype = 2 domyślnie)
-e, --service	brak, Typ/identyfikator usługi, podać w przypadku gdy Typ wizyty to usługa (bookingtype = 1), działa analogicznie do specjalizacji
-c, --clinic	wszystkie jakie są w regionie/mieście, można użyć parametru wielokrotnie w celu szukania wizyt w konkretnych klinikach
-o, --doctor	wszyscy lekarze, można użyć parametru wielokrotnie w celu sprawdzenie kilku lekarzy
-d, --start-date	data bieżąca (format: YYYY-mm-dd)
-f, --end-date	brak (format: YYYY-mm-dd), dostępna tylko w medihunter.py
-a, --start-time	"0:00" (format: hh:mm), dostępna tylko w medihunter.py
-g, --end-time	"23:59" (format: hh:mm), dostępna tylko w medihunter.py
-j, --days-ahead	1 = pokazuje wizyty dla pierwszego znalezionego dnia, dostępna tylko w medihunter.py
-i, --interval	brak
--disable-phone-search	brak, Pozwala pominąć wizyty telefoniczne w wyszukiwaniu, dostępna tylko w medihunter.py
--pushover_token	brak, Pushover Application Token
--pushover_user	brak, Pushover user Token
--pushover_device	brak, None nazwa device w Pushover domyślnie pusta=wszystkie
--pushover_msgtitle	brak - prefix dodawany przed tytułem powiadomienia
-t, --notification-title	brak, dostępna tylko w medihunter.py, wspierana tylko przez Pushover, Telegram i Gotify

Pushbullet w medihunter.py

Żeby działały powiadomienia pushbullet trzeba zrobić eksport (wartości ustawiamy swoje):

# bash
export NOTIFIERS_PUSHBULLET_TOKEN=avykwnqc8ohyk73mo1bsuggsm3r4qf

lub

# fish
set -x NOTIFIERS_PUSHBULLET_TOKEN avykwnqc8ohyk73mo1bsuggsm3r4qf

Teraz możemy wyszukać wizyty np. tak:

medihunter find-appointment -n pushbullet -r 204 -s 4798 --user 00000 --password psw1234 -i 1 -d 2019-05-15

Pushover w medihunter.py

Żeby działały powiadomienia pushover trzeba zrobić eksport (wartości ustawiamy swoje):

# bash
export NOTIFIERS_PUSHOVER_TOKEN=avykwnqc8ohyk73mo1bsuggsm3r4qf
export NOTIFIERS_PUSHOVER_USER=s4g1zoewbzseogp4knrapx23k9yi95

lub

# fish
set -x NOTIFIERS_PUSHOVER_TOKEN avykwnqc8ohyk73mo1bsuggsm3r4qf
set -x NOTIFIERS_PUSHOVER_USER s4g1zoewbzseogp4knrapx23k9yi95

Teraz możemy wyszukać wizyty np. tak:

medihunter find-appointment -n pushover -r 204 -s 4798 --user 00000 --password psw1234 -i 1 -d 2019-05-15

Telegram w medihunter.py

Musimy utworzyć bota do powiadomień i kanał na który będą przesyłane powiadomienia. Szczegóły jak to zrobić można znaleźć pod adresem https://core.telegram.org/bots

Jak już mamy to gotowe to wystarczy zrobić eksport dwóch zmiennych (wartości ustawiamy swoje):

# bash
export NOTIFIERS_TELEGRAM_CHAT_ID=avykwnqc8ohyk73mo1bsuggsm3r4qf
export NOTIFIERS_TELEGRAM_TOKEN=740885363:AdFRNFTIFTc4hC1flAuXE-dyik_Udm6Ma3o

lub

# fish
set -x NOTIFIERS_TELEGRAM_CHAT_ID avykwnqc8ohyk73mo1bsuggsm3r4qf
set -x NOTIFIERS_TELEGRAM_TOKEN 740885363:AdFRNFTIFTc4hC1flAuXE-dyik_Udm6Ma3o

lub w Windows z venv

set NOTIFIERS_TELEGRAM_CHAT_ID=avykwnqc8ohyk73mo1bsuggsm3r4qf
set NOTIFIERS_TELEGRAM_TOKEN=740885363:AdFRNFTIFTc4hC1flAuXE-dyik_Udm6Ma3o

Teraz możemy wyszukać wizyty i otrzymać notyfikacje w Telegramie:

medihunter find-appointment -r 204 -s 4798 --user 00000 --password psw1234 -i 1 -d 2019-05-22 -n telegram

XMPP w medihunter.py

Musimy posiadać 2 zarejestrowane konta XMPP:

• pierwsze do wysyłania wiadomości, w przypadku odnalezienia wizyt zgodnych z zadanymi kryteriami wyszukiwania,
• drugie do odbierania wiadomości z powiadomieniami, na którym będziemy zalogowani w dowolnym kliencie obsługującym XMPP (np. na komputerze/urządzeniu mobilnym).

Eksportujemy nazwy obu kont XMPP i hasło logowania do pierwszego z kont (wartości ustawiamy swoje):

# bash
export NOTIFIERS_XMPP_JID='[e-mail]'
export NOTIFIERS_XMPP_PASSWORD='haslo_nadawcy_powiadomien'
export NOTIFIERS_XMPP_RECEIVER='[e-mail]'

lub

# fish
set -x NOTIFIERS_XMPP_JID '[e-mail]'
set -x NOTIFIERS_XMPP_PASSWORD 'haslo_nadawcy_powiadomien'
set -x NOTIFIERS_XMPP_RECEIVER '[e-mail]'

Teraz możemy wyszukać wizyty i otrzymać notyfikacje poprzez XMPP:

medihunter find-appointment -r 204 -s 4798 --user 00000 --password psw1234 -i 1 -d 2019-05-22 -n xmpp

Gotify w medihunter.py

Gotify jest prostym serwisem do wysyłania powiadomień typu push głównie na urządzenia z systemem Android. Różni się od innych tego typu aplikacji, że jest w pełni open source oraz do przeznaczony do hostowania na własnym serwerze.

W celu skorzystania z tej metody powiadomień musimy ustawić kilka zmiennych środowiskowych:

# bash
export GOTIFY_TOKEN=AbCDeFg2yvapfPA
export GOTIFY_HOST=https://gotify.my-server.com

lub

# fish
set -x GOTIFY_TOKEN 'AbCDeFg2yvapfPA'
set -x GOTIFY_HOST 'https://gotify.my-server.com'

lub w Windows z venv

set GOTIFY_TOKEN=AbCDeFg2yvapfPA
set GOTIFY_HOST=https://gotify.my-server.com

Istnieje również opcjonalna zmienna GOTIFY_PRIORITY która pozwala na ustawienie priorytetu powiadomienia (domyślnie 5).

Teraz możemy wyszukać wizyty i otrzymać notyfikacje poprzez Gotify:

medihunter find-appointment -r 204 -s 4798 --user 00000 --password psw1234 -i 1 -d 2019-05-22 -n gotify

Docker

Aby uruchomić aplikację w kontenerze należy w pierwszej kolejności zbudować obraz

docker build -t medihunter .

Następnie uruchamiamy kontener używając komendę run

docker run -it medihunter find-appointment --user 00000 --password psw1234 -r 204 -s 4798

Możliwe jest także użycie zmiennych środowiskowych lub pliku .env

docker run -it  -e MEDICOVER_USER=00000 -e MEDICOVER_PASS=psw1234 medihunter find-appointment -r 204 -s 4798d

docker run -it --env-file=.env medihunter find-appointment -r 204 -s 4798