https://twitter.com/VaccinetimeRI
This bot checks Rhode Island vaccine appointment sites every minute and posts on Twitter when new appointments show up. The bot is written in Ruby.
The following websites are currently checked:
- https://www.vaccinate-ri.org - every site
- https://www.cvs.com - CVS pharmacies in RI
A Dockerfile is provided for easy portability. Use docker-compose to run:
docker-compose up
This will run the bot without tweeting, instead sending any activity to a
"FakeTwitter" class that outputs to the terminal. Logs are also stored in files
in the log/
directory. To set up real tweets, see the configuration section
below.
The bot uses Redis for storage, but has no other
dependencies. If you wish to run the bot locally, install Redis and run it
locally with redis-server
, then run:
bundle install
bundle exec ruby run.rb
You can optionally run a subset of scrapers by providing an option -s
or
--scrapers
to the run.rb
script like this:
bundle exec ruby run.rb -s ma_immunizations,cvs
Running locally works fine on MacOS, but hasn't been tested elsewhere.
Configuration is done via environment variables that are passed into docker at runtime. To enable tweeting, provide the following:
- TWITTER_ACCESS_TOKEN
- TWITTER_ACCESS_TOKEN_SECRET
- TWITTER_CONSUMER_KEY
- TWITTER_CONSUMER_SECRET
This bot can also be configured to send slack notifications to a channel by setting the following environment variables:
- SLACK_API_TOKEN
- SLACK_CHANNEL
- SLACK_USERNAME
- SLACK_ICON
Additional configuration can be done with the following:
- SENTRY_DSN - sets up error handling with Sentry
- ENVIRONMENT - configures Sentry environment
- UPDATE_FREQUENCY - number of seconds to wait between updates (default 60)
- SEED_REDIS - set to true to seed redis with the first batch of found appointments (useful for deploying to fresh redis instances)
See CONTRIBUTING.md for details on how to contribute. We expect external contributors to adhere to the code of conduct.
Copyright 2021 Ginkgo Bioworks
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.