VaxAlert is a tool for notifying of new COVID-19 vaccine appointments within a given date range and distance. It uses the API provided by the wonderful COVID-19 Vaccine Spotter website. The notifications happen over SMS via Twilio, so a Twilio account is required. You can get a free trial with them for two weeks!
go get github.com/fantashley/vaxalert/cmd/vaxalert
$ vaxalert -h
Usage of vaxalert:
-alert-numbers string
comma-separated numbers to send SMS alerts to when appointments are found
-api-url string
API URL of vaccine spotter (default "https://www.vaccinespotter.org/")
-appt-end-date string
end of date range for searching appointments
-appt-start-date string
start of date range for searching appointments
-config string
config file (optional)
-latitude float
latitude of coordinate to search around
-longitude float
longitude of coordinate to search around
-max-distance int
maximum distance in miles from coordinates to search for appointments
-poll-interval duration
new appointment polling frequency (default 5m0s)
-second-dose
only search for appointments for second dose
-state-codes string
comma-separated list of state codes to search in
-twilio-account-sid string
Twilio account sid for SMS alerting
-twilio-auth-token string
Twilio auth token for SMS alerting
-twilio-msg-sid string
Twilio messaging sid
-vaccine-type string
(not required) type of vaccine to search for in appointments
{
"poll-interval": "30s",
"state-codes": "MN",
"twilio-account-sid": "<your sid here>",
"twilio-auth-token": "<your token here>",
"twilio-msg-sid": "<your msg sid here>",
"alert-numbers": "+16516463003",
"appt-start-date": "03/30/2021",
"appt-end-date": "04/06/2021",
"latitude": "44.9658649",
"longitude": "-93.2354132",
"max-distance": 50,
"second-dose": false,
"vaccine-type": "pfizer"
}
vaxalert -config config.json