内容
# 公寓猎人
> [!WARNING]
> **法律声明：** 本自动化工具仅供个人使用。 使用此软件，即表示您同意 [法律声明和合理使用政策](LEGAL.md)。
公寓猎人是一款功能强大的聚合和搜索平台，用于租赁公寓。 它可以自动化地找到、过滤和评估住房选项，而无需每小时手动检查网站。 **目前，系统仅支持来自 `krisha.kz` 的数据**，但其架构允许轻松扩展。 它支持基于精确多边形的地理搜索、语义文本搜索（RAG）和 LLM 驱动的质量评分。
## 快速开始
```powershell
# 1. 为 Codex Desktop / Claude 启动 MCP 服务器
uv run apartment-hunter-mcp
# 2. 或者手动运行数据摄入管道
uv run apartment-hunter-ingest
```
### AI 技能
该项目在 `.agents/skills` 中包含专用的 AI 技能，以增强您的 AI 助手：
- **apartment-search**：用于公寓搜索、数据摄入、监控和翻译列表术语的领域工作流。
- **city-district-context-kz**：提供哈萨克斯坦城市和地区的背景信息（交通、价格、宜居性）。
- **html-report-generator**：生成带有照片和链接的公寓可视化 HTML 报告，并在 localhost 上启动。
**如何使用技能：**
您不需要手动安装这些技能。 只需使用您喜欢的 AI CLI（例如 Antigravity CLI / Codex CLI）打开此项目文件夹，代理将自动从本地工作区发现并加载技能。
## 使用场景
- **代理 / MCP：** 将其连接到 Codex Desktop，以与您的公寓数据库聊天（“在 Megapark 附近显示 2 个卧室的公寓，价格低于 50 万，按最新排序”）。
- **精确地理：** 停止依赖不准确的文本搜索。 在地图上绘制多边形，传递坐标，并仅获取严格位于该精确边界内的公寓。
- **AI 评分：** 使用 Vision LLMs 根据装修质量、家具状况和特定的用户偏好自动评定公寓的评分（满分 10 分）。
- **市场监控：** 定期运行摄入（例如，通过 cron）以跟踪价格下降，并立即捕获新的列表，以免它们被租出去。
## 架构理念
这是一个 **Library-First** 项目。核心逻辑构建为可重用的、与源无关的 Python 库。所有特定于站点的抓取和适配器都是隔离的插件，确保核心保持稳定和可扩展。
## 许可证
[MIT](LICENSE)
