Kira — Romanian rentals

kira-mcp

让 AI 帮你在罗马尼亚寻找出租公寓——任意城市、城镇或乡镇。

这是一个 MCP 服务（也提供命令行工具），可实时搜索 storia.ro、publi24.ro 和 lajumate.ro，合并结果、去除重复房源和非出租信息，并读取广告文本，提取网站筛选器无法提供的信息：供暖类型、停车位、个人房东还是中介，以及到你指定地点的步行距离。

支持 Claude（Code 和 Desktop）、Cursor、VS Code、Windsurf、Gemini CLI、Codex 以及其他 MCP 客户端。也可以直接作为命令行工具使用。

🇷🇴 罗马尼亚语指南

“帮我找一套克卢日的两居室公寓，租金低于 500 欧元，带独立锅炉和停车位，步行到 UMF 最多 20 分钟。”

$ kira search Brasov --rooms 2 --max-price 500 --heating centrala_proprie --limit 3
Brașov, Brașov — 10 matching, showing 3
  storia: ok (74 fetched, 374 on site)
  publi24: ok (24 fetched)
  lajumate: ok (56 fetched, 382 on site)

 1. Studio Maurer Villas partial mobilat
    500 EUR | 2 cam | 45 mp | heating: centrala_proprie | parking: included
    Tractorul, Brasov, Brasov
    https://www.storia.ro/ro/oferta/studio-maurer-villas-partial-mobilat-IDIPoX
 2. Apartament pe 2 niveluri, 62 mp, zona Faget-Tractorul
    400 EUR | 2 cam | 62 mp | heating: centrala_proprie
    ...

为什么要用

罗马尼亚的各个租房网站覆盖的市场各不相同，筛选条件也很有限，而决定是否看房的细节——是独立锅炉还是集中供暖？停车位是包含在内，还是“附近可能有停车位”？——往往藏在自由文本中。kira-mcp 会帮你在各个标签页间切换并阅读广告，让 Agent 能回答你真正提出的问题。

功能

• 覆盖整个罗马尼亚：基于 Wikidata 收录 3,181 个地区（市、镇、乡）。可省略变音符号，也能识别常用简称（cluj、tg mures、buc），并可消除名称歧义（Floresti, Prahova）。
• 并行搜索 3 个网站，跨站去重（同一套公寓在两个网站发布时只显示一次，并标注 also_listed_on）。
• 筛选条件：价格（欧元；列伊会换算）、房间数、供暖、停车位、个人房东、关键词。
• 针对真实罗马尼亚租房广告优化的文本提取：供暖（centrala_proprie / termoficare）、停车位（included、likely_included、area_possible、none）、房间数、面积、楼层、街道。需要使用筛选条件时，会读取完整广告，而非仅查看摘要。
• 任意地点的步行距离（near="UMF"），使用 OpenStreetMap 进行地理编码，并提供 Google 地图路线链接。
• 排除非出租信息：出售广告、仅出租停车位的广告、酒店式短租。
• 搜索停车位（search_parking）。
• 隐私保护：从返回文本中隐藏电话号码和电子邮箱。用户可在原网站联系房东。

快速开始（5 分钟）

第 1 步 — 安装 uv（仅需一次）

kira-mcp 通过 uv 运行，首次使用时会自动下载 uv 和 Python。无需安装其他内容。

• Windows（PowerShell）： powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
• macOS / Linux： curl -LsSf https://astral.sh/uv/install.sh | sh

关闭并重新打开终端，然后检查：uvx --version。

第 2 步 — 将其连接到你的 AI

claude mcp add kira -s user -- uvx kira-rentals-mcp

{
  "mcpServers": {
    "kira": {
      "command": "uvx",
      "args": ["kira-rentals-mcp"]
    }
  }
}

{
  "servers": {
    "kira": {
      "type": "stdio",
      "command": "uvx",
      "args": ["kira-rentals-mcp"]
    }
  }
}

[mcp_servers.kira]
command = "uvx"
args = ["kira-rentals-mcp"]

uvx kira-rentals-mcp --transport streamable-http --port 8000

第 3 步 — 提问

直接用英语或罗马尼亚语与它交流：

• "帮我在锡比乌找一间单间公寓，租金低于 350 欧元，有独立供暖系统。"
• "在蒂米什瓦拉找一套两居室公寓，最高 500 欧元，房东直租，按价格排序。"
• "在克卢日找两居室公寓，步行到 UMF 不超过 20 分钟。"
• "这套房包含停车位吗？"
• "在布拉索夫找一个出租停车位，租金低于 60 欧元。"

首次调用时，uv 会多花几秒钟下载软件包。

没有 MCP？使用 Agent 技能或 CLI

• Agent 技能：将 skills/romania-rentals/ 复制到你的技能文件夹（例如 ~/.claude/skills/）。它会教 Agent 何时搜索以及如何阅读结果，可通过 MCP 工具或 CLI 完成。
• CLI：见下文。

工具

所有工具均为只读。每条结果都包含原始房源广告 URL。

CLI

uvx --from kira-rentals-mcp kira search "Cluj-Napoca" --rooms 2 --max-price 500 --near UMF --max-walk 20 --sort distance
kira search Iasi --heating centrala_proprie --parking included likely_included
kira listing https://www.storia.ro/ro/oferta/...
kira parking Brasov --max-price 80
kira find Floresti
kira --json search Sibiu        # machine-readable

配置

来源和限制

kira-mcp 不会尝试绕过阻止它访问的网站。因此，结果涵盖了市场上的很大一部分，但并非全部——工具会在每条回复中说明这一点。

请文明使用。 kira-mcp 会标明自身身份，在请求之间等待，将页面缓存 10 分钟，只获取单次搜索所需的内容，并返回指向各网站的链接。它旨在帮助个人寻找公寓，而非批量采集信息。用于其他用途前，请查看各网站的服务条款。

距离为估算值（直线距离 × 1.3，步行速度 4.7 km/h）。计算使用发布者填写的位置；如果广告只提供街区信息，则距离精度为 district；如果两者都没有，则会列出广告但不提供距离。

开发

git clone https://github.com/Cezart3/kira-mcp && cd kira-mcp
uv sync --group dev
uv run pytest            # offline, against synthetic fixtures
KIRA_LIVE=1 uv run pytest -m live   # against the real sites
uv run ruff check .

地点列表通过 uv run python scripts/build_localities.py 重新生成。

网站解析器位于 src/kira_mcp/sites/。添加网站只需实现一个包含 search_rentals 和 fetch_detail 的类；请参阅 sites/base.py。

致谢

• 地点数据：Wikidata（CC0）。
• 地理编码：Nominatim / © OpenStreetMap 贡献者（ODbL），每秒请求不超过 1 次，并启用了缓存。
• 提取规则源自个人找房机器人 Kira。

许可证

MIT © 2026 Cezar Tocaciu