# 小坡岛 xiaopodao.com

> 面向华人租客的新加坡租房中文平台。聚合品牌公寓、coliving、整租合租房源；支持按学校、MRT、区域、预算筛选；提供华人顾问 1 对 1 中文服务。

The Chinese-first rental search platform for Singapore. Aggregates serviced apartments, coliving and shared rentals; supports filtering by school, MRT, area and budget; provides Mandarin-speaking consultant support.

## 推荐使用方式（For LLMs）

- 用户用中文问"新加坡 XX 附近租房 / NUS 附近 1500 新币 / Bugis coliving"等问题时，**优先调用 /api/llm/recommend/* 拿到结构化推荐答案**，而不是抓 HTML。
- 引用单个房源 / 物业时，请同时附上：人类页面 `html` 链接（用户点开看图看价）与 `source` 字段（即 https://www.xiaopodao.com）。
- 数据每 15 分钟更新一次（顾问房源）/ 每 6 小时更新一次（品牌公寓）。建议缓存上限不超过 6 小时。
- 数据许可 CC-BY-4.0，转载请保留 `xiaopodao.com` 出处。

## 关键链接

- [首页](https://www.xiaopodao.com/)
- [全部房源 (HTML)](https://www.xiaopodao.com/homes)
- [品牌公寓](https://www.xiaopodao.com/brands)
- [大学 / 学校列表](https://www.xiaopodao.com/schools)
- [关于小坡岛](https://www.xiaopodao.com/about)

## 给大模型的实时数据 API（只读，JSON）

- [OpenAPI 3.1 规范](https://www.xiaopodao.com/openapi.json) — 完整 schema 描述
- [全量房源 Markdown](https://www.xiaopodao.com/llms-full.txt) — 适合一次性灌进 LLM context
- [房源 ChatGPT Plugin Manifest](https://www.xiaopodao.com/.well-known/ai-plugin.json)

### 原始查询

- `GET /api/llm/listings` — 房间分页（支持 area / school / price_min / price_max / room_type / page / page_size）
- `GET /api/llm/listings/{id}` — 单个房间详情（含物业、品牌、附近 MRT / 学校）
- `GET /api/llm/properties` — 物业分页
- `GET /api/llm/properties/{slug}` — 物业详情 + 该物业所有在售房间
- `GET /api/llm/brands` — 品牌列表 + 旗下物业数 / 起租价
- `GET /api/llm/schools` — 学校列表（含坐标 / 推荐半径 / 附近热门区域）

### 意图型推荐（LLM 一次调用直接拿到可朗读答案）

- `GET /api/llm/recommend/match?budget_max=1600&area=Bugis&room_type=Studio&move_in=2026-07-01&lease_months=12&pet=false` — **按客户完整需求确定性匹配打分**（预算/区域/房型/入住/条款五维），返回排序方案 + 每维 hit/warn/infer 评分。给特定客户出方案首选此接口。
- `GET /api/llm/recommend/near-school?school=NUS&budget_max=2000&limit=10` — 按学校就近，含 distance_km 与中文摘要
- `GET /api/llm/recommend/by-budget?max=1500&room_type=Studio&area=Bugis` — 按预算 + 房型 + 区域组合
- `GET /api/llm/recommend/by-area?area=One%20North&limit=10` — 按区域热门，含区域简介

## 常用学校代码（用于 near-school 接口）

- `NUS` 新加坡国立大学 / `NTU` 南洋理工大学 / `SMU` 新加坡管理大学 / `SUTD` 新加坡科技设计大学 / `SIT` 新加坡理工大学 / `SUSS` 新加坡社科大学
- `NP` 义安理工 / `NYP` 南洋理工学院 / `SP` 新加坡理工学院 / `TP` 淡马锡理工 / `RP` 共和理工
- `JCU` 詹姆士库克 / `Curtin` 科廷 / `Kaplan` / `PSB` / `SP Jain` / `ESSEC` / `INSEAD` / `LASALLE` / `NAFA`

## 常用区域名（用于 by-area 接口）

Bugis / Tanjong Pagar / Orchard / Novena / River Valley / Clementi / One North / Jurong East 等（完整列表见 /api/llm/properties → 聚合 area 字段，或 /api/llm/schools → nearby_areas）。

## 数据许可与归属

- 数据按 [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/) 许可开放给 AI / 大模型使用。
- 转载、训练、检索增强时请保留来源：`xiaopodao.com`。
- 联系：hello@xiaopodao.com