The 116117 Impfterminservice provides COVID-19 vaccination appointments for a wide range of German states. Unfortunately, it does not alert registered users when appointments become available, so users are required to manually monitor it. This is a proof of concept for a simple Puppeteer-powered bot that monitors the site and alerts via STDOUT and optionally push notification once appointments are available.
🦠 Please use this responsibly to keep it available and functional.
…my project Impfterminmonitor.de, which provides an easy way to track appointment availability using a clean web interface.
116117bot requires one or multiple URLs to be monitored as its input. Right now, two types of URLs are supported:
https://123-iz.impfterminservice.de/impftermine/service?plz=12345. You are redirected to these in the browser after you have selected a location for vaccination on impfterminservice.de. You can copy them from the browser address bar.https://123-iz.impfterminservice.de/terminservice/suche/XXXX-XXXX-XXXX/12345/. These are provided via e-mail after elegibility for a vaccination has been confirmed.116117bot reads all configuration from environment variables. Only one is actually required:
| Variable | Required | Default | Description |
|---|---|---|---|
URLS | ✅ | The URLs to be monitored (see above). If you provide more than one separated by commas, they will be checked round-robin style. | |
VACCINATION | Specific vaccination name to check for, one of: BioNTech, Moderna, AstraZeneca | ||
PUSHOVER_TOKEN | If you want to receive alerts via Pushover, the app token generated there. | ||
PUSHOVER_USER | If you want to receive alerts via Pushover, the recipient ID (user or group) generated there. | ||
TIMEOUT_REGULAR | 300 | The number of seconds 116117bot will wait between polls. | |
TIMEOUT_ERROR | 300 | The number of seconds 116117bot will pause in case an error has been encountered during a poll. | |
NO_PUPPETEER_SANDBOX | false | Set this to true to run Puppeteer without a sandbox. This is required for some hosting services. | |
LOG_HTML | false | Set this to true to log raw HTML from polls (if it has changed). | |
HEADLESS | false | Set this to true to run Puppeteer in headless mode. | |
PORT | 3000 | The port 116117bot will run on. It is not actively used at this point, but should still be available. |
$ npm install
$ npm start
Build the docker container inside the repository folder:
$ docker build -t 116117bot .
Run the docker container:
$ docker run --name 116117bot -e URLS="YourUrlHere" 116117bot
While PRs to this repo are very welcome, please treat it more as a template for your own expriments than as a single point of truth. My time with this project is limited, so it may take a few days until I can review and merge changes. Before you open a PR, kindly run npm run prettify once to format your code.
Content type
Image
Digest
Size
543.9 MB
Last updated
over 5 years ago
docker pull pederpansen/116117bot