# Send Student Rooms to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "student-rooms", "name": "Student Rooms", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/gonzalopezgil/student-rooms", "canonicalUrl": "https://clawhub.ai/gonzalopezgil/student-rooms", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/student-rooms", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=student-rooms", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/student-rooms" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/student-rooms", "downloadUrl": "https://openagent3.xyz/downloads/student-rooms", "agentUrl": "https://openagent3.xyz/skills/student-rooms/agent", "manifestUrl": "https://openagent3.xyz/skills/student-rooms/agent.json", "briefUrl": "https://openagent3.xyz/skills/student-rooms/agent.md" } } ``` ## Documentation ### student-rooms CLI Multi-provider student accommodation finder and monitor. Query Yugo and Aparto for room availability, filter by semester and price, and get alerts when new options appear. ### Setup cd /path/to/student-rooms-cli source .venv/bin/activate Config file: config.yaml (copy from config.sample.yaml if missing). Key settings: target: country: "Ireland" city: "Dublin" academic_year: start_year: 2026 end_year: 2027 filters: max_weekly_price: 350.0 notifications: type: "openclaw" # or stdout | webhook | telegram openclaw: mode: "message" channel: "telegram" target: "CHAT_ID" ### Commands All commands support --provider yugo|aparto|all (default: all) and --json for structured output. ### discover — List properties python -m student_rooms discover --provider all python -m student_rooms discover --provider all --json python -m student_rooms discover --city Barcelona --provider aparto --json Returns property names, slugs, locations, and URLs for the target city. ### scan — One-shot availability check # Semester 1 rooms (default filter) python -m student_rooms scan --provider all --json # All options (full year, semester 2, etc.) python -m student_rooms scan --all-options --json # Scan + send notification for top match python -m student_rooms scan --provider all --notify JSON output structure: { "matchCount": 5, "matches": [ { "provider": "yugo", "property": "Residence Name", "roomType": "Gold Ensuite", "priceWeekly": 310.0, "priceLabel": "€310/week", "available": true, "bookingUrl": "https://...", "startDate": "2026-09-01", "endDate": "2027-01-31", "optionName": "Semester 1", "dedupKey": "yugo|slug|gold ensuite|2026-27|Semester 1" } ] } ### watch — Continuous monitoring python -m student_rooms watch --provider all Scans at configured interval (default 1h + random jitter). Alerts only on new options not previously seen. Persists seen options locally to avoid duplicate alerts. ### probe-booking — Deep booking-flow probe python -m student_rooms probe-booking --provider yugo --residence "Dominick Place" --json python -m student_rooms probe-booking --provider aparto --residence "Binary Hub" --json Returns booking context, available beds, direct booking links, and portal redirect URLs. Supports --residence, --room, --tenancy, --index filters. ### notify — Test notification python -m student_rooms notify --message "Test alert 🏠" ### test-match — Test semester matching logic python -m student_rooms test-match --from-year 2026 --to-year 2027 --name "Semester 1" --start-date 2026-09-01 --end-date 2027-01-31 --json ### Location override Override config target with CLI flags: python -m student_rooms scan --city Barcelona --country Spain --provider all --json ### Agent usage tips Always use --json for structured output. Use scan --json to check current availability; parse matchCount and matches array. Use discover --json to list what properties exist before scanning. Use watch as a background process for ongoing monitoring. Combine scan --notify to trigger alerts in a single command. The dedupKey field in scan output uniquely identifies each option for tracking. ### OpenClaw integration Set notifications.type: "openclaw" in config. Supports two modes: message: Sends alert text via openclaw message send to a channel/target. agent: Triggers an OpenClaw agent session with the alert as context. Optional: create_job_on_match: true creates a one-shot cron job for reservation assistance. The tool works fully standalone — OpenClaw is only needed if you want the openclaw notification backend. ### Notification backends BackendConfig keyRequiresstdout(default)Nothingwebhooknotifications.webhook.urlAny HTTP endpoint (Discord, Slack, ntfy.sh)telegramnotifications.telegram.bot_token + chat_idTelegram botopenclawnotifications.openclaw.targetOpenClaw CLI installed ### Provider notes Yugo: Dynamic API discovery (countries → cities → residences → rooms → tenancy options). Supports full booking-flow probing. Aparto: Scrapes apartostudent.com for property discovery, then probes StarRez portal termIDs. IE/ES/IT share one portal; UK has a separate portal; France has no StarRez portal (discover-only). ## Trust - Source: tencent - Verification: Indexed source record - Publisher: gonzalopezgil - Version: 1.1.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/student-rooms) - [Send to Agent page](https://openagent3.xyz/skills/student-rooms/agent) - [JSON manifest](https://openagent3.xyz/skills/student-rooms/agent.json) - [Markdown brief](https://openagent3.xyz/skills/student-rooms/agent.md) - [Download page](https://openagent3.xyz/downloads/student-rooms)