An automated booking availability monitor that tracks accommodation availability and event tickets (Japanese traditional guesthouses, Sumo tournaments) and sends email notifications when availability is found.
- Plugin Architecture: Easily add support for different booking websites and event systems
- Multi-Type Monitoring: Supports both accommodation booking and event ticket tracking
- Direct Booking Integration: Targets specific booking URLs using Playwright automation
- Email Notifications: Mailgun integration for email alerts
- Web Dashboard: Real-time status monitoring and manual checks
- Configurable Scheduling: Set custom check intervals per plugin
- Docker Support: Fully containerized service with Playwright browser support
- 489pro.com: Japanese accommodation booking system (Shirakawa-go traditional houses)
- Direct Booking Plugin: Generic plugin for direct booking page monitoring
- Sumo Plugin: Japanese Sumo tournament ticket availability monitoring
-
Clone and Setup
git clone <this-repo> cd accommodation-tracker
-
Create Configuration
cp config.example.json config.json # Edit config.json with your settings -
Run with Docker (Recommended)
docker-compose up --build
-
Access Dashboard
- Open http://localhost:8080 in your browser
Edit config.json to configure the service:
{
"email": {
"enabled": true,
"provider": "mailgun",
"config": {
"domain": "mg.yourdomain.com",
"api_key": "your-mailgun-api-key",
"from_email": "noreply@mg.yourdomain.com",
"to_email": "your-email@example.com"
}
},
"plugins": [
{
"type": "direct_booking",
"name": "shirakawa_accommodations",
"enabled": true,
"check_interval_minutes": 60,
"config": {
"booking_urls": [
"https://www6.489pro.com/asp/489/menu.asp?id=21560019&lan=ENG&kid=00156",
"https://www6.489pro.com/asp/489/menu.asp?id=21560023&lan=ENG&kid=00156"
],
"target_dates": ["2025-11-04"]
}
},
{
"type": "sumo",
"name": "sumo_november_2025",
"enabled": true,
"check_interval_minutes": 60,
"config": {
"url": "https://sumo.pia.jp/en/",
"tournament_month": "11",
"year": "2025"
}
}
],
"web_port": 8080,
"log_level": "INFO"
}Email configuration is simplified - only domain and from_email are required:
- domain: Your email domain (e.g., "mail.example.com")
- from_email: Sender email address (e.g., "bot@mail.example.com")
The direct_booking plugin monitors specific booking URLs for room availability:
- booking_urls: Array of direct booking page URLs to monitor
- target_dates: Array of dates to check (YYYY-MM-DD format)
The sumo plugin monitors Japanese Sumo tournament ticket availability:
- url: Base URL for the sumo ticket site (e.g., "https://sumo.pia.jp/en/")
- tournament_month: Month of the tournament ("01", "03", "05", "07", "09", "11")
- year: Tournament year (e.g., "2025")
-
Install dependencies
pip install -r requirements.txt playwright install chromium
-
Run single check (testing)
CONFIG_PATH=config.json SINGLE_RUN=true python -m src.main
-
Run service
CONFIG_PATH=config.json python -m src.main
- Create a new plugin in
src/plugins/ - Extend the
BookingPluginbase class - Implement
check_availability()andget_item_info()methods - Register in
src/plugins/__init__.py
Example plugin structure:
from .base import BookingPlugin, CheckResult, BookingAvailability
class MyPlugin(BookingPlugin):
def __init__(self, config: Dict[str, Any]):
super().__init__("my_plugin", config)
async def check_availability(self) -> CheckResult:
# Implement availability checking logic
availabilities = []
# ... your logic here
return CheckResult(
plugin_name=self.name,
item_name="My Item",
check_time=datetime.now(),
availabilities=availabilities,
success=True
)
def get_item_info(self) -> Dict:
return {
"name": "My Item",
"dates": ["2025-11-04"],
"venues": ["Location 1"]
}GET /- Web dashboardGET /api/status- Service statusGET /api/results- Recent check resultsPOST /api/check/{plugin_name}- Manual check for specific pluginPOST /api/check-all- Manual check for all pluginsGET /health- Health check
docker build -t slop-bot .docker run -d \
-p 8080:8080 \
-v $(pwd)/config.json:/app/config.json:ro \
-v $(pwd)/data:/app/data \
slop-bot# Start service
docker-compose up -d
# View logs
docker-compose logs -f
# Stop service
docker-compose downCONFIG_PATH: Path to configuration file (default:config.json)SINGLE_RUN: Set totruefor one-time check modeLOG_LEVEL: Logging level (DEBUG, INFO, WARNING, ERROR)
-
Playwright browser not found
playwright install chromium
-
Permission denied on data directory
chmod 755 data/
-
Mailgun authentication failed
- Verify API key and domain in config
- Check Mailgun account status
-
Browser crashes in Docker
- Ensure sufficient memory allocation (at least 2GB recommended)
- Add
--no-sandbox --disable-dev-shm-usageflags if needed
Configuration is managed through config.json. A sample configuration is available in deploy/config.json.
View application logs:
# Docker Compose
docker-compose logs -f slop-bot
# Docker
docker logs -f <container-id>
# Local development
tail -f accommodation_log_*.json- Direct URL Targeting: Reads booking URLs directly instead of crawling
- JavaScript Handling: Uses Playwright to interact with dynamic booking calendars
- Smart Navigation: Automatically navigates through calendar weeks to find target dates
- Room Detection: Extracts room types and availability from booking table structures
- Clean Output: Formats results in user-friendly format with pricing information
🏠 Accommodation Tracker - Multi-purpose Availability Monitor 🤖
Plugin: direct_booking
Check time: 2025-08-17 11:14:43
Success: True
Booking Availability Found:
✅ 8 Japanese Tatami mats (Oct-Nov 2025 Package): available
Price: JPY17,050
Booking URL: https://www6.489pro.com/asp/489/menu.asp?id=21560019&lan=ENG&kid=00156
✅ 12 Japanese Tatami mats (Oct-Nov 2025 Package): available
Price: JPY19,250
Booking URL: https://www6.489pro.com/asp/489/menu.asp?id=21560019&lan=ENG&kid=00156
Plugin: sumo
Check time: 2025-08-17 11:15:02
Success: True
Ticket Availability Found:
✅ 2025 November Grand Tournament: available
Venue: Fukuoka
Tickets available for purchase
Booking URL: https://sumo.pia.jp/en/
MIT License