Hysen Labshkid-quota-monitor
香港入境处智能身份证预约配额监控看板：5分钟级检测+邮件/飞书放号通知（第三方工具，非官方）
HK ID quota monitor watches appointment slots and sends alerts
The HK ID quota monitor checks the Hong Kong immigration department's smart ID appointment slots every two minutes and notifies subscribers by email or Feishu when slots open. It is a third party tool published by chen1111-a under no declared license.
How the monitoring works
A cron job triggers GitHub Actions about every two minutes, which runs a Python module that reads the immigration department's public quota interface. The script is read only and sends one request per cycle. It compares the new snapshot with the previous one to detect a slot release event, then commits the updated data and refreshes the jsDelivr cache.
Notifications and dashboard
When a release is detected, the system sends email and Feishu group messages with a debounce cooldown so users are not flooded. A phone first dashboard refreshes every 90 seconds and uses both color and text to mark slot status, which helps color blind users. The notification links stay on domestic Chinese networks so subscribers do not need any circumvention tool.
Self hosting and personalization
The README explains a six step fork and deploy path that needs no server and no cost. Users can open a subscription panel to pick offices and dates, or just write their needs in an email. A config file sets two date lines so urgent near term slots trigger a red alert while later ones get a smaller notice. The author states the tool only monitors and alerts and does not book slots on anyone's behalf.
Editorial conclusion
The monitor is written in Python, runs on GitHub Actions with a two minute check, and the author describes it as a free public interest tool that does not automate bookings.
Community notes