Otaghak

🏡 otaghak-mcp：面向 AI Agent 的 Otaghak MCP 服务

面向 Otaghak（اتاقک）的非官方只读 MCP 服务：让你的 AI Agent 在伊朗寻找住处。
在伊朗各地搜索别墅、乡间小屋和公寓，查看哪些夜晚有空房，获取你所选日期和住客人数的
准确价格，并查看评价和房东数据；所有操作都可通过 Claude、Cursor 或 Copilot 完成。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发 · 相关服务 · 免责声明 · 许可证

面向 AI Agent

• **简介：**面向 Otaghak（اتاقک）的非官方只读 MCP 服务。Otaghak 是伊朗的别墅、乡间小屋和公寓市场。使用波斯语查询效果最佳，也支持英文 slug；价格单位为 Toman。
• 安装：claude mcp add otaghak -- uvx otaghak-mcp（stdio 传输；需要 Python 3.10+ 和 uv）。
• **认证：**无需认证，也无需 API 密钥。如果 Otaghak 屏蔽了你的网络，可选用 OTAGHAK_MCP_PROXY（HTTP 代理，或以逗号分隔的代理列表）。
• **访问权限：**只读。无需登录，不支持预订、付款或短信验证码，因此调用工具前无需确认。
• **工具：**共 15 个，均以 ot_* 为前缀。可从 ot_find_place 开始，然后使用 ot_search_rooms → ot_room 或 ot_room_calendar → ot_price_quote。要寻找优惠，可使用 ot_deals。
• **适用场景：**在伊朗寻找住处，并结合评价和房东数据，获取所选日期和住客人数对应的准确总价。
• **不适用场景：**需要预订或付款（用户需在 otaghak.com 上操作），或需要查询开放日历范围以外的价格（最晚到下一个波斯历月份结束，最多 20 晚）。
• **输出：**紧凑 JSON。价格单位为 Toman；日期采用公历 YYYY-MM-DD（check_out 为离开日期）；评分范围为 0-5。使用工具时传递数字类型的房间 ID。
• 机器可读信息：server.json；所有伊朗 MCP 服务目录：iran-mcp（TOOLS.md、servers.json、llms.txt）。

原因

在 Otaghak，房源卡片上显示的价格往往不是你实际要支付的价格：每晚价格各不相同，周末更贵，折扣逐晚变化，额外房客每晚都要收费，而且日历通常只开放未来约一个月的日期。要知道我的日期和同行人数对应的真实总价，就得逐个房间点击日历。使用 otaghak-mcp 的 Agent 可以代劳：

你： 我们有 4 个人，去 Ramsar，10 月 20 日至 23 日。「سوییسی لیلی」小屋总共多少钱？

Agent： 调用 ot_search_rooms(city=["ramsar"], name="لیلی") → ot_price_quote(room_id=2508916, check_in="2026-10-20", check_out="2026-10-23", guests=4)

夜晚	价格	折扣前
10 月 20 日，周二	4,000,000	5,000,000
10 月 21 日，周三	4,000,000	5,000,000
10 月 22 日，周四	4,250,000	5,000,000
1 位额外房客（3 晚）	980,000	1,200,000
应付总额	13,230,000

小屋包含 3 位房客，最多可住 4 人，因此第 4 位房客每晚收费 400,000（同样有折扣，折扣率与住宿晚数的略有不同）。三晚都空闲，可立即预订。要我用 ot_similar_rooms 帮你比较一下吗？

_{真实工具输出，来自 2026-10-04；价格随时可能变化。价格单位为 Toman。}

功能

• 🔎 搜索：根据日期和同行人数，搜索某个城市、省份或主题合集（海滩、丛林、带泳池的别墅，……）中的住宿，并按价格、评分或折扣排序
• 🧮 精确价格：按日期和房客人数计算价格，包括每晚折扣后的价格、额外房客费用，以及可选的延迟退房费用
• 📅 日历：查询哪些夜晚空闲、每晚价格、最短和最长住宿时间、周末和节假日
• 🏠 房间详情：房间和床位、设施、住宿规则、入住时间、取消政策、附近商店、照片
• ⭐ 品质：评分、六项类别评分、推荐率、带房东回复的评价、房东响应时间和接待率
• 🏷️ 优惠：临时折扣和折扣力度最大的住宿
• 🧭 指南：目的地指南、常见问题、博客文章，以及网站规则（取消、退款）
• 🔒 专为只读而设计：无需登录，不可预订或付款，也不需要短信验证码

快速开始

你需要 uv。

claude mcp add otaghak -- uvx otaghak-mcp

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

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

codex mcp add otaghak -- uvx otaghak-mcp

[mcp_servers.otaghak]
command = "uvx"
args = ["otaghak-mcp"]

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

然后只需询问：

• “下个周末，拉姆萨尔附近适合 6 人入住且带泳池的最便宜别墅是哪一套？”
• “2512254 号房间 10 月 20 日至 23 日有空吗？5 位客人的总价是多少？”
• “吉兰省评分为 4 分或以上、允许携带宠物的小屋。”
• “显示 2512254 号房间的评价和房东回复率，然后推荐同一日期的类似房间。”
• “未来一个月有哪些伊朗节假日？这间房提供延迟退房吗？”
• یک کلبه جنگلی در ماسال برای ۴ نفر، آخر هفته بعد، با رزرو آنی پیدا کن.
• قیمت نهایی ویلای شماره ۲۵۱۲۲۵۴ برای ۵ نفر از ۲۰ تا ۲۳ اکتبر چقدر می‌شود؟
• تخفیف‌دارترین اقامتگاه‌های شمال را نشان بده.

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  otaghak-mcp  (runs on your machine)
      │
      │  HTTPS (REST + OData)
      └──────▶  core.otaghak.com, www.otaghak.com/blog

otaghak-mcp 在本地运行，并调用 otaghak.com 网站使用的相同公共端点。 中间没有托管服务，不需要 API 密钥，也不会将你的任何信息发送到其他地方。

工具

房间由数字 ID 标识，例如 2512254（即 otaghak.com/room/2512254/ 中的数字）；地点由 slug 标识，例如 ramsar（城市）、mazandaran（省份）或 beach（集合）。

全部 15 个工具均标注为 readOnlyHint: true，并返回精简的结构化 JSON，不会让 Agent 的上下文被大量信息淹没。

须知

• 价格以 Toman 计价，与网站一致（1 Toman = 10 Rial）。price_per_night 是折扣后的价格。未指定日期时，价格是房间未指定入住日期的起始价，并非报价。
• 应付金额为 ot_price_quote → total：折扣后的住宿晚数费用（即房间页面显示的应付金额），加上超过房间包含人数的额外入住人数费用（按与住宿晚数相同的折扣计算），再加上可选的延迟退房费用。优惠券和钱包余额需要登录后才能使用，且不包含在内。搜索结果会给出 stay_total 估算值，可能相差几 Toman；指定日期后，sort="cheapest" 会按此值对每一页排序。
• 日期使用公历 YYYY-MM-DD，check_out 是离店日期。不能使用过去的日期，最多入住 20 晚；房东日历只开放到下一个 Jalali 月底。工具会明确说明这些情况，而不是返回空列表。输入 Jalali 日期会报错，并提示对应的公历日期。
• **入住人数：**每个房间的价格包含 base_guests 人，最多可入住 max_guests 人。ot_price_quote 会自行检查人数上限（如果您指定某个房间，网站自己的搜索不会检查）。
• 评分范围为 0–5；null 表示尚未评分。节假日标记仅提前约 7 周发布。
• 位置为大致位置；只有预订后才能获取准确地址和房东电话。
• 波斯语查询匹配效果最佳（رامسر、کلبه），英文 slug 也可以使用。

常见问题

npx @modelcontextprotocol/inspector uvx otaghak-mcp

配置

波斯语：Otaghak MCP 服务

claude mcp add otaghak -- uvx otaghak-mcp

开发

git clone https://github.com/sepehr071/otaghak-mcp && cd otaghak-mcp
uv sync
uv run python -m pytest            # offline, against recorded responses
uv run python -m pytest -m live    # real API
uv run ruff check .

工具位于 src/otaghak_mcp/search.py、room.py、pricing.py 和 info.py 中；每个工具都是带类型注解的异步函数，并附有说明何时使用该工具的文档字符串。欢迎提交问题和 PR，尤其是新工具和针对 API 变更的修复。

发布：在 pyproject.toml 和 server.json 中更新版本号，然后推送 v* 标签。GitHub Actions 会运行测试、发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• Jabama MCP server：提供别墅、旅游和活动信息
• Flytoday MCP server：提供航班、酒店和别墅信息
• MrBilit MCP server：提供航班、火车、巴士和酒店信息
• Iran Quake MCP server：提供伊朗近期地震信息
• 所有服务：iran-mcp，伊朗 MCP 服务目录

如果它为您省下了几次点击，点个星标就能帮助其他人找到它。

免责声明

本项目为非官方项目，与 Otaghak 无关联，也未获其认可。它使用 otaghak.com 网站的公开接口，这些接口可能随时变更，恕不另行通知。Otaghak 为签约合作伙伴提供官方预订 Web 服务；本项目并非该服务。请合理控制请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。您可以通过 LinkedIn 联系作者，或在 GitHub 上关注 @sepehr071，了解更多面向伊朗网站的 MCP 服务；所有服务均列于 iran-mcp。如果它为您节省了时间，在代码仓库点个星标就能帮助其他人找到它。

许可证

MIT