If you've ever done contract field service work, you know the drill: a work order email hits your inbox, you open the vendor portal, and it's already gone. Someone accepted it 30 seconds ago.
I got tired of losing jobs to refresh speed, so I built a pipeline that automates the entire detection-to-alert cycle. It's open source, MIT licensed, and running in production on a $12/month VPS.
What it does
The pipeline monitors an IMAP inbox for work order notification emails, extracts the job details, authenticates into the vendor portal via CDP (Chrome DevTools Protocol), scrapes the full scope of work, scores it against historical work orders using Jaccard similarity, calculates driving distance via OSRM, checks the deadline viability, and pushes an enriched alert to your phone — all before you'd normally finish reading the email.
Stack
- Email monitoring: Himalaya CLI + ProtonMail Bridge (IMAP)
- Portal scraping: Headless Chrome via CDP
- Similarity scoring: Jaccard index, 4+ char word filter, 30% threshold
- Routing: OSRM driving distance from home base
- Alerts: Pushover (priority 2 — bypasses DND/sleep) + Telegram bot fallback
- Database: SQLite
- Deployment: Ubuntu 24.04, systemd services, cron
Key features
- Authenticated portal scraping with automatic cookie refresh
- Scope-of-work similarity scoring against historical jobs
- Driving distance calculation from configurable home base
- Deadline viability filtering
- No-return site detection
- DND-bypassing mobile alerts with one-tap accept/decline
- Full audit logging
What's next
Building out the accept flow — one-tap YES from the mobile alert triggers CDP to fill the acceptance form on the portal. Currently in testing.
Repo: github.com/plugdev505/vendor-portal-automator
Fee
Top comments (0)