student-rooms

What This Skill Does

The student-rooms skill is a robust, multi-provider monitoring agent designed to simplify the search for student accommodation. By integrating with major providers Yugo and Aparto, it enables users to scan, track, and secure housing across 70+ cities globally. The tool goes beyond simple scraping by offering continuous monitoring through a 'watch' mode, which detects new room availability and alerts the user via multiple channels including Telegram, webhooks, or OpenClaw notifications. It effectively abstracts the complexity of navigating multiple booking portals, handling semester-based filtering, price thresholding, and booking-flow probing directly from your command line or OpenClaw environment.

Installation

To install this skill, use the ClawHub command within your OpenClaw environment:

clawhub install openclaw/skills/skills/gonzalopezgil/student-rooms

Once installed, navigate to the workspace directory, initialize your virtual environment, and configure your preferences in config.yaml. Ensure you have a valid Python 3 environment active before running the commands.

Use Cases

• International Students: Planning a move abroad and need to monitor availability in a specific city like Barcelona or Dublin without checking websites manually.
• Price Sensitivity: Automatically filter for rooms under a specific weekly budget to ensure you find the most cost-effective housing options.
• Continuous Monitoring: Leave the 'watch' command running to receive instant alerts the moment a specific room type becomes available in a high-demand residence.
• Booking Validation: Use the 'probe-booking' command to verify deep-link availability and confirm if a room is truly bookable before starting the payment process.

Example Prompts

• 'Find me all available student rooms in Dublin under 350 per week for the 2026/2027 academic year.'
• 'Monitor for new room openings at Dominick Place and send me a Telegram alert if anything becomes available.'
• 'Are there any ensuite rooms available in Barcelona for Semester 1 that I can book right now?'

Tips & Limitations

• Jitter & Delays: The watch mode includes a random jitter to prevent rate-limiting by provider websites. Do not set your monitoring intervals too aggressively to avoid being blocked.
• Configuration: Always verify your config.yaml settings. The scraper relies heavily on the academic_year definition to filter results accurately.
• Scope: While it covers 70+ cities, ensure your specific provider operates in your target city by using the discover command first. It is a standalone tool, meaning you can integrate it into custom workflows, but native OpenClaw integration provides the best experience for persistent alerts.